API Changelog - 2026-07-23: Summary
A new qr_ph payment method has been added to the Create Payment
request. QRPh is the Philippine interoperable QR standard, allowing
consumers in the Philippines to pay by scanning a QR code across
participating banks and e-wallets.
POST /v1/payments — Create Payment (QRPh)
The qr_ph enum value has been added to paymentMethod.type, and a
new paymentMethod.qrPh object is now accepted in the Create Payment
request. This enables Philippine QR-based payments via the QRPh
standard. The payment flow is asynchronous — the API returns a
pending status with a redirect nextStep URL that the consumer must
visit to complete the payment. A webhook or polling mechanism is
required to detect the final payment status.
| Property | Details |
|---|
| Name | paymentMethod.type |
| Location | Request body |
| Type | string |
| Required | Yes |
| Format | Enum value qr_ph — added |
| Example | "qr_ph" |
| Property | Details |
|---|
| Name | paymentMethod.qrPh |
| Location | Request body |
| Type | object |
| Required | Yes (when type is qr_ph) |
| Format | QRPh payment method data object |
| Example | { "returnUrl": "https://merchant.site/return" } |
| Property | Details |
|---|
| Name | paymentMethod.qrPh.returnUrl |
| Location | Request body |
| Type | string |
| Required | Yes |
| Format | URL — merchant page to redirect after payment |
| Example | "https://merchant.site/complete-payment" |