Skip to main content
POST
/
transactions
curl --request POST \
  --url https://hg.cash/api/v1/transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountId": "550e8400-e29b-41d4-a716-446655440123",
  "toCBU": "1100015400000000000021",
  "amount": 15000.5
}
'
{
  "id": "789e0123-e89b-12d3-a456-426614174999",
  "externalID": "REQ-2024-001234",
  "createdAt": "2024-06-19T10:30:00Z",
  "status": "PENDING"
}

Documentation Index

Fetch the complete documentation index at: https://docs.hg.cash/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

User API authentication token with format: cash_<64-char-hex>

Example: cash_16cdc3b6f83c72d9d2680adca4f430962981f6bf32613a129dded0aa060387d2

Body

application/json

Outbound transaction creation request by a user

​
accountId
string<uuid>
required

ID of the user's account to send funds from

Example:

"550e8400-e29b-41d4-a716-446655440123"

​
amount
number<decimal>
required

Transaction amount (must be positive)

Example:

15000.5

​
fromName
string

Name of the transaction sender

Maximum string length: 255
Example:

"Juan Pérez"

​
toName
string

Name of the transaction recipient

Maximum string length: 255
Example:

"María García"

​
fromCBU
number

CBU (bank account number) of the sender

Example:

170001540000000020000

​
toCBU
string

Recipient CBU (22 digits). Provide either toCBU or toCVU.

Example:

"1100015400000000000021"

​
toCVU
string

Recipient CVU (22 digits). Provide either toCBU or toCVU.

Example:

"0000003100012345678901"

​
fromCUIT
number

CUIT/CUIL of the sender

Example:

20123456789

​
toCUIT
number

CUIT/CUIL of the recipient

Example:

27987654321

​
concept
string

Transaction concept or description

Maximum string length: 500
Example:

"Payment for services"

​
externalDate
string<date-time>

Transaction date in your system (ISO 8601 format)

Example:

"2024-06-19T10:30:00Z"

​
coelsaCode
string

Coelsa transaction code

Maximum string length: 100
Example:

"COELSA123456"

​
data
object

Additional JSON data for the transaction

Example:
{
  "reference": "REF-001",
  "category": "services",
  "metadata": {
    "source": "mobile_app",
    "version": "1.2.3"
  }
}
​
webhookUrl
string<uri>

Optional webhook URL to receive status updates for this request

Example:

"https://client.example.com/webhooks/transaction-request"

Response

Transaction request created successfully

​
id
string<uuid>

Internal transaction request ID

Example:

"789e0123-e89b-12d3-a456-426614174999"

​
externalID
string
Example:

"REQ-2024-001234"

​
createdAt
string<date-time>
Example:

"2024-06-19T10:30:00Z"

​
status
enum<string>
Available options:
PENDING,
AWAITING_REVIEW,
PROCESSING,
DONE,
ERROR,
CANCELLED
Example:

"PENDING"