Initiate payout
Initiate a payment from your wallet to a specified beneficiary. We will process the payment and send it to the beneficiary.
Path parameters
-
The Company ID given by Fipto.
Format should match the following pattern:
[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}
. -
The Wallet ID given by Fipto.
Format should match the following pattern:
[0-9a-zA-Z]{22}
.
POST
/companies/{company_id}/wallets/{wallet_id}/payouts
curl \
-X POST https://api.fipto.app/companies/9de0691c-bc8d-409b-8f40-75d4f45db2f3/wallets/3Qv67yjXEwB9SjmvkuG6Cp/payouts \
-H "Content-Type: application/json" \
-d '{"data":{"type":"payout","attributes":{"beneficiary_id":"string","amount":"1000"}}}'
Request example
{
"data": {
"type": "payout",
"attributes": {
"beneficiary_id": "string",
"amount": "1000"
}
}
}
Request examples
{
"data": {
"type": "payout",
"attributes": {
"beneficiary_id": "string",
"amount": "1000"
}
}
}
Response examples (202)
{
"meta": {
"request_id": "string",
"query_parameters": {}
},
"data": {
"type": "payout",
"attributes": {
"wallet": {
"wallet_id": "string",
"wallet_name": "My wallet"
},
"beneficiary": {
"beneficiary_id": "string",
"beneficiary_description": "My beneficiary"
},
"amount": "1000",
"status": "pending",
"valuations": [
{
"asset": "EUR",
"value": "10.05"
},
{
"asset": "USD",
"value": "12.97"
}
],
"transaction_id": "string",
"created_at": "2023-05-04T09:42:00+00:00",
"asset_code": "BTC",
"created_by": "string",
"signature": {
"quorum": 42,
"mfa": [
"totp"
],
"signatories": [
{
"user_id": "string"
}
]
},
"blockchain_data": {
"transaction_hash": "string",
"block_explorer_link": "string"
}
},
"id": "string"
}
}
Response examples (202)
{
"meta": {
"request_id": "string",
"query_parameters": {}
},
"data": {
"type": "payout",
"attributes": {
"wallet": {
"wallet_id": "string",
"wallet_name": "My wallet"
},
"beneficiary": {
"beneficiary_id": "string",
"beneficiary_description": "My beneficiary"
},
"amount": "1000",
"status": "pending",
"valuations": [
{
"asset": "EUR",
"value": "10.05"
},
{
"asset": "USD",
"value": "12.97"
}
],
"transaction_id": "string",
"created_at": "2025-05-04T09:42:00+00:00",
"asset_code": "BTC",
"created_by": "string",
"signature": {
"quorum": 42,
"mfa": [
"totp"
],
"signatories": [
{
"user_id": "string"
}
]
},
"blockchain_data": {
"transaction_hash": "string",
"block_explorer_link": "string"
}
},
"id": "string"
}
}