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

Query Params
string
required

The raw QR code string to decode (QRPH or PayNow format)

string
enum
required

Target currency of the QR code. Supported values are PHP (Philippines - QRPH)

Allowed:
Responses

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json; charset=utf-8