Skip to main content
POST
Create Standalone Transfer
Create a forward transfer to distribute funds from your organization balance to your recipients independently of a payment.

Authorizations

PUBLIC-API-KEY
string
header
required
PRIVATE-SECRET-KEY
string
header
required

Headers

X-Idempotency-Key
string
required

Unique key for request idempotency.

Body

application/json
account_id
string
required

The unique identifier of the account.

recipient_id
string<uuid>
required

The target recipient identifier.

provider_id
string
required

The payment provider code to use (e.g., adyen, stripe).

amount
object
required
description
string

A human-readable description for the transfer (3-255 chars). This is sent to the provider.

merchant_reference
string

Merchant's unique identifier for idempotency and tracking.

metadata
object[]

Response

Created

id
string
Example:

"TRF_7kB2mQ9xPnL4vR"

recipient_id
string<uuid>
Example:

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

amount
object
status
string
Example:

"SUCCEEDED"

reason
string
Example:

"ORDER_CANCELLED"

description
string
Example:

"Weekly marketplace earnings"

merchant_reference
string
Example:

"TRANSFER-2026-02-15-001"

metadata
object[]
provider_data
object
created_at
string<date-time>
Example:

"2026-02-16T10:30:00Z"

updated_at
string<date-time>
Example:

"2026-02-16T10:30:15Z"

completed_at
string<date-time>
Example:

"2026-02-16T10:30:15Z"

provider
string | null
Example:

null

transactions
object[]