Philippines
Local payment methods in PHP
Before you start
Authorization
How to sign your requests with the API token.
Create payment
The base order request that this page extends.
This payment method is not enabled for all merchants. Check availability with your manager.
Overview
| Currency | Payment method |
|---|---|
PHP | Local bank and wallet methods |
The payer is redirected to paymentLink and chooses a method on the provider page.
What is different from a regular order
Only the currency: no customer object is required. Create a regular order in PHP.
The externalUserId field is required for this payment method.
Request example
{
"purpose": "Payment for order #1234",
"amount": "5000",
"currency": "PHP",
"externalId": "23456789",
"externalUserId": "437568",
"successUrl": "https://example.com/success",
"failUrl": "https://example.com/fail",
"callbackUrl": "https://example.com/webhooks/payments"
}Response
The response is a standard order object. The order is created with the CREATED status; redirect the payer to paymentLink to complete the payment.
Order object fields
Next steps
Order status and webhooks
Get notified when the payment is completed.
Payments by country
Other countries and payment methods.
H2H and the payment form
Ask your manager to enable H2H for the required method. The create-order request stays the same unless an extra field is listed below. Open the returned paymentLink: the platform payment form displays the QR code, bank details, or wallet action and waits for the final result. Existing payment-page integrations remain available.
H2H supports GCash, GCash2, Maya, GrabPay, QRPH and virtual accounts. No customer object is required. The configured method determines whether the form shows a wallet button, a QR code, or an account number. A QR is shown only when it is supplied by the payment method.
Receiving a QR payload via API
For a method that issues a QR code, request the raw payload after creating the order:
curl -X POST "https://api.panel.valutix.kz/v1/orders/{orderId}/h2h/qr" \
-H "x-api-token: YOUR_API_TOKEN"{ "qrPayload": "RAW_PAYMENT_QR_PAYLOAD" }Generate the QR image from qrPayload without changing its contents. This endpoint is available only when H2H is enabled and the selected method actually returns a QR payload; a wallet link or phone confirmation is not a QR payload. Do not replace a missing payload with paymentLink. Keep waiting for the final order status or callback; receiving payment instructions does not mean the order is paid.
Receiving bank details via API
curl -X POST "https://api.panel.valutix.kz/v1/orders/{orderId}/h2h/bank-transfer" \
-H "x-api-token: YOUR_API_TOKEN"The response contains accountNumber, accountName, bankName, bankCode, amount, currency, and details. Missing optional values are null. Show every returned entry in details, including the branch or transfer reference. Repeated calls reuse the same payment. HTTP 503 means details are not ready; retry after a few seconds. HTTP 400 means this method does not issue bank details (or the order is a test order), 404 means the order was not found, and 409 means it is no longer payable.