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": "d6ae4ea6-0482-47ab-a895-02e50ea6358b",
  "reference_id": "REF-12345-ABC",
  "amount": 10000,
  "remarks": "Monthly payment for services"
}
'
{}

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)

Example:

10000

​
remarks
string
required

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

Example:

"Monthly payment for services"

Response

Transfer created successfully

The response is of type object.