Skip to content

Create Recharge ​

Create a wallet recharge order and get the payment URL and payment parameters. Recharge does not support wallet payment or mixed payment. It is recommended to create recharge orders via the Place Order API with productCode=WALLET_RECHARGE; this API is the wallet-specific entry.

Interface Address:

text
/papi/wallet/recharge/create

Request Method:

text
POST

Content-Type:

text
application/json

Header Parameters:

ParameterTypeRequiredDescription
X-Access-KeystringYesAPI access key ID. See API Rules for authentication
X-SignaturestringYesSignature value, Base64-encoded HMAC-SHA256 result
X-TimestampstringYesMillisecond-level Unix timestamp (13 digits)
X-NoncestringYesRandom string, 10~32 lowercase letters + digits

Body Parameters:

ParameterTypeRequiredDescription
amountstringYesRecharge amount (cents), positive integer string, decimals not allowed
currencystringNoCurrency code, only USD is supported, defaults to USD
payCodestringYesOnline payment method code, use an actually enabled payment method
providerCodestringYesPayment provider code

Request Example:

json
{
  "amount": "1000",
  "currency": "USD",
  "payCode": "wxpayUs",
  "providerCode": "Wallyt412"
}

Response Parameters:

ParameterTypeDescription
codeintegerError code. See Error Codes
dataobjectResponse data
├─ rechargeNostringRecharge order number, identical to the order number
├─ orderNostringAssociated order number
├─ amountstringRecharge amount (cents)
├─ currencystringCurrency code
├─ currencySymbolstringCurrency symbol, e.g. $ for USD
├─ rechargeStatusstringRecharge status (CREATED-pending confirmation, CREDITED-credited)
├─ creditedTimeintegerCredit time (Unix millisecond timestamp), null when not credited
├─ paymentNostringSystem payment number
├─ paymentStatusintegerPayment status
├─ payUrlstringPayment channel redirect URL
├─ qrCodeUrlstringPayment QR code image URL
├─ payParamsstringPayment channel parameters
msgstringError message

Response Example:

json
{
  "code": 0,
  "data": {
    "rechargeNo": "MO202611021000000000001",
    "orderNo": "MO202611021000000000001",
    "amount": "1000",
    "currency": "USD",
    "currencySymbol": "$",
    "rechargeStatus": "CREATED",
    "creditedTime": null,
    "paymentNo": "",
    "paymentStatus": 0,
    "payUrl": "",
    "qrCodeUrl": "",
    "payParams": ""
  },
  "msg": ""
}
Copyright © 2026 HongKong Quantity Best Technology Limited

QTPhone Help Center