Skip to main content


Payout transactions allow merchants to transfer funds from their own account to a customer's account. This is useful in situations where merchants need to make payouts to customers, such as refunds or commission payments.


Please note that payout transactions are only available for certain adapters and must be explicitly enabled by your integration engineer. Make sure to check the adapters page for details on the supported payout functionality for each payment method.

Payout transactions are commonly used in the following scenarios:

  • Refunds: Merchants can use payout transactions to refund customers who have paid with a payment method that does not support refunds. In this case, the merchant would initiate a payout transaction to transfer the refund amount to the customer's account.
  • Commission payments: Merchants can use payout transactions to pay commissions to their affiliates or partners.
  • Disbursements: Payout transactions can be used to disburse funds to customers, such as insurance claims or payouts for sharing economy platforms.

How payout transactions work

The payout transaction process is similar to that of a standard transaction, with some important differences. Instead of charging a customer's card, a payout transaction transfers funds from the merchant's account to the customer's account.

To initiate a payout transaction, the merchant sends a request to the IXOPAY platform with the transaction details, including the amount to be transferred and the customer's account information.

Depending on the adapter, payout transactions can be created using a Hosted payment page, or a transactionToken from payment.js, or by referencing saved payment information with referenceUuid.

curl --request POST -sL \
--url "${API_KEY}/payout" \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header "Authorization: Basic $(echo -n "$USERNAME:$PASSWORD" | base64)" \
--data-raw '{
"merchantTransactionId": "your-unique-identifier",
"transactionToken": "$CC_TOKEN",
"description": "Purchase description shown on credit card statement.",
"amount": "9.99",
"currency": "EUR",
"successUrl": "",
"cancelUrl": "",
"errorUrl": "",
"callbackUrl": ""