---
title: "Decode QR Code"
method: GET
path: "/qrcode/decode"
tags: ["Reference"]
---

# Decode QR Code

`GET /qrcode/decode`

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](/reference/createpayout) 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 parameters

- `qr_code_text` string, required
- `currency` 'PHP', required

## Response `200`

OK

## Other responses

- `500` — Internal Server Error

---

[API](https://skmtc.dev/finmo/apis/finmo-api.md) · [All operations](https://skmtc.dev/finmo/apis/finmo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finmo/finmo-api/revisions/1a3073c93930/schema)