Comprehensive guide on integrating and using Embedded QR Code payments through HitPay API.
Payment Method | Code |
---|---|
PayNow | paynow_online |
ShopeePay | shopee_pay |
QRIS | doku_qris (Indonesia merchants), ifpay_qris (other merchants) |
WeChatPay | wechat_pay |
VietQR | vietqr_payme |
PromptPay | opn_prompt_pay |
TrueMoney | opn_true_money_qr |
GrabPay | grabpay_direct |
GrabPay PayLater | grabpay_paylater |
UPI | upi_qr |
Gcash | gcash_offline |
QRPH | qrph_netbank |
Touch ‘n Go | touch_n_go |
ShopBack | Coming Soon |
X-BUSINESS-API-KEY: meowmeowmeow
paynow_online
payment method.
Parameter | Type | Description |
---|---|---|
amount | string | Required. The amount to be paid. |
currency | string | Required. The currency of the payment (e.g., “sgd”). |
payment_methods[] | array | Required. Specify paynow_online as the payment method. |
generate_qr | boolean | Required. Set to true to generate the QR code. |
name | string | Optional. The name of the customer. |
string | Optional. The email of the customer. | |
phone | string | Optional. The phone number of the customer. |
purpose | string | Optional. The purpose of the payment. |
reference_number | string | Optional. A reference number for the payment. |
Example Response for Embedded QR Code Payment Request
qr_code
value returned may be a URL (e.g. https://securecheckout.sandbox.hit-pay.com/...
) instead of the raw PayNow QR string. This is intended to help you test the flow using a standard QR code reader or by visiting the link directly in a browser.qr_code
will be a raw PayNow payload string that you should convert into a scannable QR code for use with banking apps.Parameter | Description | |
---|---|---|
payment_id | Payment ID | |
payment_request_id | Payment request ID | |
phone | Buyer’s phone number | |
amount | Amount related to the payment | |
currency | Currency related to the payment | |
status | Payment status (completed / failed) | |
reference_number | Arbitrary reference number mapped during payment request creation | |
hmac | Message Authentication code of this webhook request |
Webhook Signature Mismatch?
Facing Invalid Business API Key Error
Product Checklist
Why does my charges `webhook status` show as failed?
3.1.13.32
, 52.77.254.34
54.179.156.147