Transfer funds between sellers

Initiate fund transfer

You can transfer funds between sellers using our fund transfer API. This allows you to move money from one seller’s payout destination to another.

Fund transfers are processed asynchronously, meaning you’ll receive a confirmation that the request was received, but the actual result will appear in the settlement report.

Ensuring safe retries

Each transfer request requires a unique fund_transfer_id. This ID ensures idempotent processing, meaning if a request fails (for example, due to a timeout), you can safely retry it using the same fund_transfer_id. This avoids accidentally creating duplicate transfers. The API will recognize it’s the same request and not process it again.

Error codes

Scenario	HTTP Status	Error code
Insufficient funds on source payout destination	400	`ERR_INSUFFICIENT_FUNDS`
Payout destination does not have payout interval configured	400	`ERR_PAYOUT_INTERVAL_NOT_CONFIGURED`
The `fund_transfer_id` is already used for a different fund transfer	400	`ERR_FUND_TRANSFER_ID_CONFLICT`

For full details, see our API documentation for fund transfers.

Testing fund transfers

You can test fund transfers using your sandbox account.

Sandbox account IDs use a T prefix.

Initiate a test fund transfer

Initiate a fund transfer using your sandbox account_id and credentials. POST /payout-destinations/{payout_destination_id}/fund-transfers

Request

curl -X POST https://api.dintero.com/v1/accounts/T12345678/payout-destinations/source-pd-123/fund-transfers \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
      "fund_transfer_id": "6ee80e6583944751997c988ed9f74740",
      "amount": 499000,
      "currency": "NOK",
      "reference": "TF-REF",
      "destination": {
        "type": "payout-destination",
        "account_id": "T12345678",
        "payout_destination_id": "dest-pd-123"
      }
  }'

Simulating error responses

Insufficient funds Set reference to "ERR_INSUFFICIENT_FUNDS" to simulate an HTTP 400 response:

{
    "error": {
        "code": "ERR_INSUFFICIENT_FUNDS",
        "message": "Insufficient funds"
    }
}

Timeout followed by an idempotent retry Set reference to "TIMEOUT" to simulate an HTTP 500 response, i.e. the outcome of the request is unknown. Retrying the identical request using the same fund_transfer_id and payload will return the original fund transfer as a successful response.

Checkout Integration

Express Checkout

In-Person Payments

Payment Methods

Tokenization

Split Payout

Initiate fund transfer

Ensuring safe retries

Error codes

Testing fund transfers

Initiate a test fund transfer

Simulating error responses

​Initiate fund transfer

​Ensuring safe retries

​Error codes

​Testing fund transfers

​Initiate a test fund transfer

​Simulating error responses

Initiate fund transfer

Ensuring safe retries

Error codes

Testing fund transfers

Initiate a test fund transfer

Simulating error responses