POST

Create Payout

Creates a new payout to the specified bank account. Uses the `X-Signature` header (note: different from the payin `signature` header). A payout is only created if the merchant has sufficient available balance. Returns HTTP 201 on success.

https://axiron.io/v2/payouts

Authenticate every request

Include your Bearer token and HMAC-SHA256 signature. Authentication guide →

Body parameters#

Required only

merchantIdstringrequired

Your merchant ID

Example pay2p

orderIdstring (uuid)required

Unique payout ID in your system

Example 773df6a8-6d8e-4aad-aa12-789d855ea3e0

amountnumberrequired

Payout amount (minimum 0.01)

Example 17666.15

currency"ARS" | "BRL" | "CLP"required

Payout currency

Example ARS

method"cbu"required

Payout method — CBU bank transfers only

Example cbu

cardNumberstringrequired

Recipient CBU / bank account number (22 digits)

Example 0000003100012345678901

recipientstringrequired

Recipient's full name

Example Test Recipient

assetOrBankstringoptional

Recipient bank name

Example Mercado Pago

callbackUristringoptional

Webhook URL for payout status notifications

Example https://example.com/payout-callback

Response fields#

address

Recipient CBU / bank account number the funds are sent to.

recipient

Full name of the payout recipient.

amount

Payout amount as a negative number (debit from your balance).

id

Unique payout UUID assigned by the system. Use for status checks.

order_id

Your original orderId echoed back for reconciliation.

state

Payout lifecycle status. One of: pending, canceled, completed — both canceled and completed are terminal. See the Lifecycle States section in Get Payout Status for full semantics.

commission

Commission rate applied as a percentage string (e.g. "1.00" = 1%).

commission_amount

Absolute commission amount deducted from the payout.

amount_wt_comm

Net amount transferred to the recipient after commission deduction.

Errors & recovery#

400

Validation failed — invalid orderId, amount, currency, or method

400

Currency not supported for this merchant

400

Payouts are disabled for this merchant account

400

Amount is outside the allowed min/max limits

400

Insufficient balance to cover payout + commission

403

Merchant account is not active

404

Merchant not found

Interpreting the result#

201

Payout was definitely created and queued for processing.

400 / 403 / 404

Payout was definitely NOT created. Safe to retry with a corrected request.

500

Payout may or may not have been created. Check status via POST /v2/payouts/status before retrying.

Need help with your integration?Contact the team