Creates a payout, or Original Credit Transaction (OCT), to a tokenized card and returns the credit result. A transfer pushes funds from your settlement account at the payout partner to the beneficiary's card.
Only card payouts are supported in this version (transfer_type: oct). Each call creates one order with category: payout and one transaction of type credit.
Where this request fits
- Tokenize
Tokenize the beneficiary card with Create a token. Never send a card number in this request.
- Create the transfer
Send this request with the token in
destination_account_token, the purpose and yourorder_merchant_id. - Follow the result
Read
status. For a pending result, wait for the webhook or call Retrieve a transfer.
Rules
Use a unique order_merchant_id per payout: a duplicate is rejected with 861003. The platform never retries a credit: on credit_request_failed, check the transfer before you submit a new one.
| Rule | Details |
|---|---|
merchant_contract | Required. Payouts are not routed automatically. |
| Rejected fields | operation_typetoken3ds_dataauthentication_indicatorchallenge_preferencesca_exemption_reasonaccept_urldecline_urlpending_urlexception_urlbasket_contentshipping_*save_payment_informationscheduled_capture_delayis_aftsub_merchant_idsub_merchant_namepayfac_idpayfac_nameforeign_retail_indicatormerchant_category_code Sending any of them returns |
| Purpose and country rules | See Specification. |
Result
| status | What it means |
|---|---|
credit_successful | Funds sent to the beneficiary. |
credit_declined | Refused by the partner or the issuer. No funds moved. |
credit_requested | Pending at the partner. Wait for the webhook. |
credit_request_failed | Technical failure, result unknown. Call Retrieve a transfer before any new attempt. |
eligibility_declined | The card cannot receive a payout. |
See Processing a payout for all statuses, return codes and webhooks.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||