Create a pay-out transaction.

Production

https://api.paypaga.com

POST

/v2/transactions/pay-out

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.

Error codes for Payout Payment Processing

HTTP status	Error code	Description
400	BAD_REQUEST	Failed to parse the request body
400	VALIDATION_ERROR	Request validation failed
401	UNAUTHORIZED	Missing or invalid authorization token
409	MERCHANT_REFERENCE_ALREADY_EXISTS	Merchant transaction reference already exists
500	INTERNAL_ERROR	Unexpected server error

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://api.paypaga.com/oauth2/token

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢202

application/json

Pay-out accepted for processing.

Headers

Bodyapplication/json

🟠400ValidationAndBadRequestError

🟠401Unauthorized

🟠409DuplicateMerchantReference

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.paypaga.com/v2/transactions/pay-out' \
--header 'DisablePartnerMock;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "country": "AR",
    "currency": "ARS",
    "payment_method": "bank_transfer",
    "merchant_transaction_reference": "TRX-2026-0026",
    "merchant_order_reference": "ORDER-2026-0001",
    "merchant_customer_id": "customer@mail.com",
    "customer_ip": "120.29.48.92",
    "amount": 125.5,
    "fields": {
        "first_name": "Rafael",
        "last_name": "Beaty",
        "document_number": "20-08490848-8",
        "account_number": 2.850590940090418e+21
    }
}'

Response Example

202 - Generic response for all payment methods

{
    "transaction_id": "20240806-2010-4086-8342-c28f4979f834",
    "merchant_transaction_reference": "TRX-2026-0026",
    "merchant_order_reference": "ORDER-2026-0001"
}

Modified at 2026-06-09 15:16:31

Search pay-out transactions

Retrieve a pay-out transaction.

Create a pay-out transaction.

Error codes for Payout Payment Processing#

Request

Responses

Error codes for Payout Payment Processing