Sign in

v1

latestOpenAPI 3.1.02026-07-226250251.5 KB
Transactions

Create a Transfer

Initiate a transfer payout to a beneficiary.

Validation Rules:

  • Minimum amount: 500 cents (5.00 in major currency units)
  • Attachments array is optional, but if provided must contain at least one item
post/v1/transactions/transfer-payout

Request body

beneficiary_idstring uuid required
reference_idstring required
amountinteger required

Amount in cents (multiply by 100). Minimum 500 cents required.

remarksstring required

Example request

{
  "beneficiary_id": "d6ae4ea6-0482-47ab-a895-02e50ea6358b",
  "reference_id": "REF-12345-ABC",
  "amount": 10000,
  "remarks": "Monthly payment for services",
  "attachments": [
    {
      "remark": "Invoice PDF DOC",
      "uri": "/XUOdWacK_Invoice.pdf"
    }
  ]
}

Response

Transfer created successfully

Example response

{
  "data": {
    "transfer_id": "c78dee10-7c46-4ad5-8ac8-070e39d87ff1",
    "reference_id": "REF-12345-ABC",
    "deposit_instruction": {
      "liquidation_address": "0x203061afd3f3dd5f5756cec992d1d247f7668384",
      "currency": "USDC",
      "rail": "POLYGON"
    },
    "quotation": {
      "currency": "EUR",
      "to_amount": 108,
      "developer_fee": 67
    },
    "created_at": "2026-01-01T07:35:53Z",
    "expire_at": "2026-01-01T07:45:53Z"
  }
}