v1
latestOpenAPI 3.0.02026-07-26280204.9 KBReference
Decode QR Code
Decode a QR code string to extract beneficiary payment details before creating a payout. Use this endpoint to validate and parse a QR code prior to initiating a payout.
This proxy endpoint currently supports one market:
- 🇵🇭 Philippines (PHP): QRPH Scan2Pay — decodes QR codes following the EMVCo standard used by Philippine payment rails.
How it works
- Capture the raw QR code string (scanned or copied from a QR image).
- Pass the qr_code_text and currency as query parameters to this endpoint.
- The API returns the decoded beneficiary details such as reference_number, beneficiary_name, and amount which you could verify.
Note:
- Use the orginal qr string details to create a Payout via the Create Payout endpoint using proxy_type as 'QR_CODE_TEXT' and proxy_value as the raw QR code string in payout beneficiary params.
Authentication
Use Basic Auth with your Finmo API keys
get/qrcode/decode
Query parameters
qr_code_textstring required
Example:00020101021226370011com.p2pqrpay0108PAPHPHM10212DPRN202402115204000053030845802PH5913Juan%20Dela%20Cruz6304ABCD6
The raw QR code string to decode (QRPH or PayNow format)
currency'PHP' required
Example:PHP
Target currency of the QR code. Supported values are PHP (Philippines - QRPH)
Response
OK