Hosted Payment Page

Developing

POST

/checkout/hpp/create-session

Initiates a hosted payment page (HPP) session. Supports both one-time and subscription payments. Returns a redirectUrl for the customer to complete payment.

Request

Body Params application/jsonRequired

Examples

One-time PaymentSubscription

{
  "orderNo": "TEST109",
  "amount": 0.1,
  "currency": "USD",
  "customerId": "user_1",
  "expiredIn": 3600,
  "payMode": "ONETIME",
  "successUrl": "https://www.google.com.hk/?hl=zh-CN",
  "cancelUrl": "https://www.google.com.hk/?hl=zh-CN"
}

Responses

🟢200成功

application/json

Bodyapplication/json

Example

{
  "retcode": "200",
  "retmsg": "success",
  "retdata": {
    "trxNo": "TRX1714012345678",
    "mchOrderNo": "ORD-20240423-001",
    "status": 1,
    "amount": 99.99,
    "redirectUrl": null
  }
}

Modified at 2026-06-03 07:54:01

Get Auth Token

List Payment History