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

attributesmap from strings to stringsOptional

Additional payout attributes as key-value pairs

senderobjectOptional

Optional sender details for the payout

Payout transaction initiated successfully

1	import requests
2
3	url = "https://api.payos.money/api/v1/payout/initiate"
4
5	payload = {
6	"merchantId": "string",
7	"merchantReference": "string",
8	"destinationValue": {
9	"minorAmount": 1,
10	"currency": "string"
11	},
12	"paymentMethodId": "card",
13	"paymentLocation": "string",
14	"recipient": {
15	"type": "bank_account",
16	"accountNumber": "string",
17	"bankCode": "string",
18	"accountHolderName": "string",
19	"country": "AFG"
20	}
21	}
22	headers = {"Content-Type": "application/json"}
23
24	response = requests.post(url, json=payload, headers=headers)
25
26	print(response.json())