Initiate a payout transaction

Creates a new payout transaction for the specified recipient

This endpoint expects an object.

merchantIdstringRequired

Merchant ID for the payout

merchantReferencestringRequired

Merchant reference for the payout

destinationValueobjectRequired

Destination amount and currency for the payout

paymentMethodIdenumRequired

Payment method identifier (e.g., “banktransfer”)

paymentLocationstringRequired

3-letter ISO country code

recipientobjectRequired

Recipient details for the payout

senderobjectRequired

Sender details for the payout (required for KYT screening)

attributesmap from strings to stringsOptional

Additional payout attributes as key-value pairs

Payout transaction initiated successfully

401

Unauthorized Error

422

Unprocessable Entity Error

500

Internal Server Error

1	curl -X POST https://api.payos.money/api/v1/payout/initiate \
2	-H "Content-Type: application/json" \
3	-d '{
4	"merchantId": "string",
5	"merchantReference": "string",
6	"destinationValue": {
7	"minorAmount": 1,
8	"currency": "string"
9	},
10	"paymentMethodId": "card",
11	"paymentLocation": "string",
12	"recipient": {
13	"type": "bank_account",
14	"accountNumber": "string",
15	"bankCode": "string",
16	"accountHolderName": "string",
17	"country": "AFG"
18	},
19	"sender": {
20	"fullName": "string",
21	"identity": "passport",
22	"identityNumber": "string"
23	}
24	}'