v1

latestOpenAPI 3.0.02026-07-26280204.9 KB
Reference

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

  1. Capture the raw QR code string (scanned or copied from a QR image).
  2. Pass the qr_code_text and currency as query parameters to this endpoint.
  3. 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