Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers-sandbox.uqpaytech.com/llms.txt

Use this file to discover all available pages before exploring further.

The UQPAY sandbox environment lets you test your integration without processing real transactions. All test credentials below work only in the sandbox.

​
Test card numbers

Use these cards with the Create Payment Intent API. You may use any value for card_name (e.g., “John Doe”).
For the network field, use lowercase: mastercard, visa, unionpay. Remove spaces from card numbers. If you receive a product_not_found error, contact UQPAY technical support.
Card schemeCard numberExpiryCVCSupported modes
Mastercard541333005700404712/25989online, offline
Mastercard534693010010811712/26811online, offline
Visa417666000000002712/33303offline (POS)
UnionPay625094700000001412/33123online, offline

​
Card payment request example

{
  "amount": "8.98",
  "currency": "SGD",
  "payment_method": {
    "type": "card",
    "card": {
      "card_name": "UQPAY",
      "card_number": "5346930100108117",
      "expiry_month": "12",
      "expiry_year": "2026",
      "cvc": "811",
      "network": "mastercard",
      "billing": {
        "first_name": "UQPAY",
        "last_name": "ACQ",
        "email": "[email protected]",
        "phone_number": "0524-91353515",
        "address": {
          "country_code": "SG",
          "state": "Singapore",
          "city": "Singapore",
          "street": "444 Orchard Rd, Midpoint Orchard, Singapore",
          "postcode": "924011"
        }
      },
      "auto_capture": true,
      "authorization_type": "authorization",
      "three_ds_action": "skip_3ds"
    }
  },
  "merchant_order_id": "test-order-001",
  "description": "test",
  "metadata": {},
  "return_url": "https://example.com/callback"
}

​
E-wallet sandbox testing

​
AlipayCN & AlipayHK

​
Setup

  1. Install the Alipay test wallet app AWallet from here.
  2. Register an Alipay sandbox account at here.

​
QR code flow

Send a payment request with flow: "qrcode" and is_present: false: 
{
  "amount": "7.77",
  "currency": "SGD",
  "payment_method": {
    "type": "alipaycn",
    "alipaycn": {
      "flow": "qrcode",
      "is_present": false
    }
  },
  "merchant_order_id": "alipay-qr-test-001",
  "description": "acquiring sandbox testing",
  "metadata": {},
  "return_url": "https://example.com/callback"
}
The response returns intent_status: "REQUIRES_CUSTOMER_ACTION" with a QR code URL in next_action.display_qr_code. Open the qr_code_url in a browser and scan it with the AWallet app to complete the payment.

​
Payment code flow (in-person)

For payment code scenarios, set is_present to true and include the customer’s payment_code:
  1. Open the AWallet app and tap “Payment Code”.
  2. Tap the barcode to view the numeric payment code.
  3. Use the code in your API request:
{
  "amount": "1.11",
  "currency": "SGD",
  "payment_method": {
    "type": "alipaycn",
    "alipaycn": {
      "flow": "qrcode",
      "os_type": "ios",
      "is_present": true,
      "payment_code": "284057804613761079"
    }
  },
  "merchant_order_id": "alipay-paycode-test-001",
  "description": "acquiring sandbox testing",
  "metadata": {},
  "return_url": "https://example.com/callback"
}
Payment code transactions complete immediately — the response returns intent_status: "SUCCEEDED".

​
Webhook testing

To test webhook delivery:
  1. Configure your webhook URL in the UQPAY Dashboard.
  2. Process a sandbox transaction (card or e-wallet).
  3. Verify that your server receives the webhook notification.
  4. Respond with HTTP 200 to acknowledge receipt.
For webhook payload schemas, see the Webhooks tab.
Use a tool like webhook.site to inspect webhook payloads during development.

​
Go-live checklist

Before switching to the production environment:
  • Account approved: sign up and complete KYC/KYB verification at app.uqpay.com
  • Production API keys: create your production apiKey and clientId in the Dashboard
  • Production base URL: switch all API calls to https://api.uqpay.com
  • Webhook IP allowlist: allowlist the UQPAY webhook source IPs (18.143.59.64, 54.179.248.205, 13.250.234.88, 18.136.58.213) — see Webhooks Overview for details
  • Webhook subscriptions: subscribe to the webhook events your integration needs