Skip to main content
Before reading this API documentation, be sure to review the API Description Guide
Use Payment Link or Front-End Component to quickly integrate Google Pay.
Some regions may not support Google Pay. Please check the unsupported regions list to confirm your target market availability.

Device and Browser Requirements

If you cannot see the Google Pay button on the payment page, your device or browser may not meet the following requirements.
  • You must have at least one card in your wallet.
  • You must use a compatible Google Pay device.
  • You must use HTTPS and Supported Browsers for testing.
  • Allow Chrome to access your wallet: Settings > Autofill and passwords > Payment methods > Allow sites to check if you have payment methods saved
  • Do not use Chrome incognito window.
  • Confirm you are in a supported Google Pay region.
Desktop Browsers
  • Chrome 38+
  • Edge 15+
  • Firefox 29+
  • Opera 25+
Mobile Browsers
  • Android Chrome 38+
  • Samsung Internet 7.1+
Other NotesFor browsers not explicitly listed above, we limit support as follows:
  • Browser must support TLS 1.2
  • Requires a modern browser supporting JavaScript Promises
  • We respond to error reports but do not actively test other browsers

Transaction Limits

Transaction TypeLimit (USD)
Collection0.99-1000

Collection API

Collection Apply

Description:
  • Create a collection order
URL: USD: /usd/collect/apply Description: Use the appId corresponding to USD. After successful payment, the user’s USD balance increases. Parameters:
ParameterRequiredTypeDescription
appIdYesLongBusiness ID (obtained from the dashboard; use the one corresponding to the currency in the URL)
orderIdYesStringMerchant order number (must be unique, max 48 characters)
nameNoStringUser name; real name recommended. Format: firstName and lastName separated by space. Example: John Doe
phoneYesStringReal phone number (format reference: phone format)
emailNoStringReal email address
amountYesStringTransaction amount (2 decimal places; no punctuation such as ”,“)
payTypeYesStringEWALLET
inBankCodeYesStringGOOGLE_PAY
clientIpNoStringClient IP address
callBackUrlYesStringRedirect URL after successful payment
callBackFailUrlYesStringRedirect URL after failed payment
notifyUrlNoStringCallback URL
subjectYesStringPayment remark
bodyNoStringRemark details
partnerUserIdYesStringUnique user identifier (e.g. userId) for risk control. Must be real and valid. Format: digits, letters, or common symbols -~!@#$%&*()_.
signYesStringSignature
Request Example
{
  "appId": 1054,
  "orderId": "M233323000059",
  "amount": "300",
  "phone": "09230219312",
  "email": "23423@qq.com",
  "name": "test",
  "inBankCode": "GOOGLE_PAY",
  "payType": "EWALLET",
  "partnerUserId": "149597870",
  "sign": "af0gAHkUOyYHu9owQp8NJ4mPEeUW4vuJcjdxqLIzrVw8AvpLSjD1DXupReSG/CyuSkFRyiIvCp5u703AuGGmfgD2gKDH3Ywau41bAbG2jnHJ8mtjiSJ5iWUzanyd4Kr7d1+rETbzUl7/BkW3t0X8UUFdqpxwG8DPUjAwUKfplWDHV7koG51Ozexd80DCsmW6eWdouAZ1uNXGLYmV3ftE3BmfNRtuv1C5bfTJWrTEIOxbF6g2uYOFZTlIgrQgd7/2PsAYwQQXNz8Q8CYl4OxqCv4pXJxaLWPbR5tqZu9og5kn32C9aHW/NlU1y39vzz+4ef81yPAqUV9oHlSMSPrMmw=="
}
Response Example
{
  "status": "1",
  "error": "00000000",
  "msg": "",
  "data": {
    "orderId": "M233323000059",
    "orderNo": "6023071013539074",
    "payUrl": "",
    "clientToken": "",
    "sign": "YEoA8Y2JzQFGVzwJSqmemm1Kfv/bfyIfCqv2dp7RNzT5B72AQvdD+nt2nR4sL1HWscvmNHyVt5ovAi7MMhy3ziih/sMph+wPx4YjH3W1h5DyBvSlWvaKfKrK5ViomZ0pPYWydwRHnnRnicxToHK9S6qtSy7Q73O0hdz4hJ9p41Th3ycBl2Q9SeqSZYSY1ohcPDhdyRf2y0prb8rHgpBKzxZ5BKX/1bsE9OmsSEHAEYT8OGgko6aNe8XPAhr4G48cpWTftvnGQuzh0O65nuZRI/PF+Axt2zJCVbFHDDSREI9NlAT82ebDqhlVdxQzKE67D1nxgjb3dPmDUYHOBpmwxQ=="
  }
}
Response data parameters
ParameterTypeDescription
orderIdStringMerchant order number (must be unique)
orderNoStringPlatform order number
payUrlStringPayment URL
clientTokenStringClient token for use in the Front-End Component (see Front-End Component)
signStringSignature

Collection Query

Description:
  • Query a collection order
URL: USD: /usd/collect/query Parameters:
ParameterRequiredTypeDescription
appIdYesLongBusiness ID (obtained from the dashboard; use the one corresponding to the currency in the URL)
orderIdYesStringMerchant order number
orderNoNoStringPlatform order number (faster response)
signYesStringSignature
Request Example
{
  "appId": 1054,
  "orderId": "M22222000028",
  "sign": "EmyJGm3ELzG4FsOd0Krs9ncbSjo4oTGuXWML+7djYla3+VAwd9wS17z38p/7U2ZAjroO04XrE7YXcB1o76Dtyipj3h3bJzs7FYma1QNkMUdt9hh7m8U6hMsMQX7vIWHtXNwz4pbTSC75+kQWXaCew7KoE6LXECdJU8AISgNgeki2TK9R0pCfshr0Z2SZBPeuT6OvIH5LdmqgdZhuqnffGU2qnXk4KMkO848e6/WALLBR+LE1wyKHfPnYVcuKSMVYxkvKyyIL5JIPEgW0o5bh4RCbaUn3NZtyYwrU1uQ3ZDFRThm9j6XAQP+LBlmq3nOePqBtp/VDVarRaV+7FbQg3A=="
}
Response Example
{
  "status": "1",
  "error": "00000000",
  "msg": "",
  "data": {
    "orderId": "M22222000028",
    "orderNo": "6023042811314347",
    "amount": "50.00",
    "actualAmount": "0.00",
    "fee": "0.00",
    "status": 1,
    "sign": "fP433ygWVDLVGxYkVnIJj7riGq0U3vyVX+MbBAImxfGLZkZcEAHVEoVYuULZSmXAAXKRSyd67WlDNm+24pougM54ofAoH4HMtCL2tfCoBReFyz3z02AGKkrKE2xWhSpWoqfQoBvzwuN5iGMMu0s9Q1YvqiwJ8WDVIENnmiIyD8qDJN7caHTW2US14/faG+69AvnuIgJ/nu7/jogOlgEYdZdVYU7gcRDE+d47KjlFGswQkJ/h/uzV7cWtUqrtOO7ZnZ3/z33Xx8awokX36QoYcPSWAU0h+Ij9O9402HNhm1eTbYcLU0uI/z8xCAtyAI/tTyiFijpiNlxUKQj+zKsILw=="
  }
}
Response data parameters
ParameterTypeDescription
orderIdStringMerchant order number (must be unique)
orderNoStringPlatform order number
amountStringTransaction amount
actualAmountStringActual amount received
feeStringFee
statusIntegerStatus (0: not started, 1: paying, 2: success (final), 3: failed (final), -1: exception pending confirmation)
payTimeStringPayment success time (available when status=2), local time, format: yyyy-MM-dd HH:mm:ss
errorMsgStringPayment failure reason (available when status=3)
signStringSignature

Payment Methods

CurrencyPayment Type (payType)Payment Code (inBankCode)LimitStatusDescription
USDEWALLETGOOGLE_PAY0.99-1000AvailableGoogle Pay
Last modified on July 9, 2026