Pay Out - Payment Processing

Execute individual Pay Out transactions. The merchant_transaction_reference field per individual Pay Out transaction enables individual status notifications and therefore should be unique per individual Pay Out transaction.

Pay Out processing is performed in stages where the configured transaction status notification mechanism is utilized to notify the merchant.

The balance available for Pay Out transactions can be up to 90% of your total successful Pay In transactions. The balance available can be queried using Query Balance.

Request Payloads

For examples of payloads for the individual countries, please see:

Supported on version 1 and 2:
Pay Out - Example - Brazil
Pay Out - Example - Mexico

Supported on version 2+:
Pay Out - Argentina (V2)
Pay Out - Colombia (V2)
Pay Out - Ecuador (V2)
Pay Out - Guatemala (V2)
Pay Out - Peru (V2)
Pay Out - Chile (V2)

Error codes for Payout Payment Processing

Error Code	Description
200	Transaction limit not configured
201	Transaction total exceeds limit per transaction
203	Merchant Identifier is missing or is invalid
204	Payment method value is not valid. It should be Bank Transfer only (BNKTR)
205	Specified country currency is invalid
206	Payment configuration not found
210	Insufficient funds for transaction
211	Missing balance record for merchant
220	Merchant configuration not found
221	Merchant transaction reference already exists
230	Payment reference already exists on processing
235	Failed to process transaction
250	Bad request for payout transaction Validation error messages that could be returned: Invalid Transaction Amount "field": "transaction" "message": "Invalid transaction amount." Missing merchant transaction reference "field": "transaction" "message": "Missing required transaction reference." Invalid Counterpart Institution "field": "counterpart institution" "message": "Invalid counterpart entity code." Invalid RFC CURP "field": "rfc curp" "message": "Invalid beneficiary rfc-curp." Invalid Beneficiary Account Type "field": "beneficiary account type" "message": "Invalid beneficiary account type." Invalid Beneficiary Account "field": "beneficiary account" "message": "Invalid beneficiary account." Invalid Pix Key "field": "beneficiary pix key" "message": "Invalid beneficiary pix key." Invalid Beneficiary Name "field": "beneficiary name" "message": "Invalid beneficiary name." Invalid Beneficiary Type "field": "beneficiary type" "message": "Invalid beneficiary type." Invalid Beneficiary Id "field": "beneficiary id" "message": "Invalid beneficiary id." Invalid Beneficiary Id Type "field": "beneficiary id type" "message": "Invalid beneficiary id type."
251	Payout processing is disabled at this time, please contact support
500	Unexpected error

curl --location --request POST 'https://api.v2.stg.paypaga.com/payout' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "merchant_id": "443984c6-849a-413e-853f-1167ca04eb93", "country_code": "MX", "currency": "MXN", "payment_method_code": "BNKTR", "transaction": { "beneficiary": { "beneficiary_name": "Juan Ramon Flores", "rfc_curp": "FOAJ001122RX5", "beneficiary_email": "jrflores@youremail.com", "beneficiary_account": "860000000000000017", "beneficiary_account_type": "40", "beneficiary_type": "INDIVIDUAL", "beneficiary_id": "43278243803", "beneficiary_id_type": "", "counterpart_institution": "860" }, "transaction_data": { "payout_concept": "Payment for services", "merchant_transaction_reference": "150262", "transaction_total": 100.5 } } }'

{ "datetime": "2024-04-09 18:47:07.960978", "message": "Payment processing initiated", "details": { "result": "success", "transaction_processed": { "transaction_id": "20240409-1847-0783-90cc-133c988ef5c6", "merchant_transaction_reference": "150267" } }, "version": "0.1" }

Pay Out - Payment Processing

Request

Responses