Skip to main content
POST
/
v1
/
transactions
/
transfer-payout
Create a Transfer
curl --request POST \
  --url https://sandbox.api.fin.com/v1/transactions/transfer-payout \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "beneficiary_id": "2db60708-4df5-4f39-9712-453fb3044517",
  "reference_id": "bleh",
  "remarks": "test",
  "amount": 500,
  "attachments": [
    {
      "uri": "/wKbvfH5E_Invoice.pdf",
      "remark": "Invoice PDF DOC"
    },
    {
      "uri": "/XUOdWacK_Invoice.jpg",
      "remark": "Invoice JPG DOC"
    }
  ]
}
'
{
  "data": {
    "transfer_id": "c78dee10-7c46-4ad5-8ac8-070e39d87ff1",
    "reference_id": "new test reference id2",
    "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"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Obtain token from /v1/oauth/token endpoint

Body

application/json
​
beneficiary_id
string<uuid>
required

Unique identifier for the beneficiary

Example:

"d6ae4ea6-0482-47ab-a895-02e50ea6358b"

​
reference_id
string
required

Unique identifier in your system

Example:

"REF-12345-ABC"

​
amount
integer
required

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

Required range: x >= 500
Example:

10000

​
remarks
string
required

Message for compliance purposes, if the customer needs to explain anything

Example:

"Monthly payment for services"

​
attachments
object[]

Optional array of document attachments. If provided, must contain at least one item. URIs should reference documents uploaded via the beneficiary documents endpoint.

Minimum array length: 1

Response

Transfer created successfully

​
data
object