Payouts

Send money to GCash, Maya, and bank accounts via Xendit v3 Payouts API.

POST/v1/payoutsIdempotent

Create a payout

Sends funds to a wallet or bank account. Supported channels: GCASH, PAYMAYA, BPI, BDO, UNIONBANK, METROBANK, RCBC, LANDBANK, PNB.

Required scope:payouts:write

Request Body

ParameterTypeRequiredDescription
amountintegerYesAmount in centavos
currencystringNoISO currency code
reference_idstringYesYour unique reference ID
channel_codestringYesDestination channel
account_numberstringYesMobile number or bank account
account_holder_namestringNoRecipient full name
descriptionstringNoPayout description

Response

{
  "id": "po_01HXYZ",
  "status": "PENDING",
  "amount": 50000,
  "currency": "PHP",
  "reference_id": "PAYOUT-001",
  "provider_transaction_id": "dsbmt_abc123",
  "fees": {
    "provider_fee": 1500,
    "payroo_fee": 500,
    "merchant_net": 48000
  },
  "created_at": "2024-01-01T00:00:00.000Z"
}