QRCode

How to use QRCode to submit a payout in Philippines.

Payout by QRCode

This endpoint allows you to submit a payout by QRCode in Philippines.

Use the scan_id returned from the Retrieve QRCode Data API to submit the QRCode payout.

The supported payout amount range is 1 to 50000 PHP.

POST https://api.transfersmile.com/api/payout

Request Body

Parameter	Type	Required	Constraints	Description
amount	string	Yes	Range: 1 to 50000	Payout amount.
source_currency	string	Yes	One of: USD, EUR, GBP, PHP	Merchant Account Currency.
arrival_currency	string	Yes	Fixed value: PHP	Arrival currency.
fee_bear	string	Yes	One of: merchant, beneficiary	Specifies who bears the processing fee.
account_type	string	Yes	Fixed value: QRCODE	Account type.
account	string	Yes	Max length: 255 characters	The QRCode account data.
custom_code	string	Yes	Must be unique	The merchant-side payout order ID.
notify_url	string	Yes	Valid URL	The URL used to receive asynchronous payout notifications.
method	string	Yes	Fixed value: QRCODE	Payout method.
additional_remark	string	Yes	Max length: 40 characters	Additional payout remark.
country	string	Yes	Fixed value: PHL	Country code.
scan_id	string	Yes	The scan_id is valid for 5 minutes after retrieval and can be used only once	The scan ID returned from the Retrieve QRCode Data API.

Request Sample

{
  "amount": "1",
  "source_currency": "USD",
  "arrival_currency": "PHP",
  "fee_bear": "merchant",
  "account_type": "QRCODE",
  "account": "00020101021127781111com.p2pqrpay********",
  "custom_code": "custom_code********RK",
  "notify_url": "https://sandbox.transfersmile.com/api/notify/demo",
  "method": "QRCODE",
  "additional_remark": "from test",
  "country": "PHL",
  "scan_id": "QH2026********"
}

Response

{
  "code": 200,
  "msg": "success",
  "time": 1782377397,
  "data": {
    "custom_code": "custom_code********RK",
    "trade_no": "2026************",
    "arrival_amount": "1",
    "arrival_currency": "PHP",
    "trade_status": "PROCESSING"
  }
}