Hosted Payment Page

Developing

POST

/checkout/w-payment/hpp

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

{
  "mchOrderNo": "ORD-20240423-001",
  "amount": 99.99,
  "currency": "USD",
  "payMode": "ONETIME",
  "successUrl": "https://yourdomain.com/pay-result?status=success",
  "cancelUrl": "https://yourdomain.com/pay-result?status=cancel"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

One-time PaymentSubscription

curl --location '/checkout/w-payment/hpp' \
--header 'Content-Type: application/json' \
--data '{
  "mchOrderNo": "ORD-20240423-001",
  "amount": 99.99,
  "currency": "USD",
  "payMode": "ONETIME",
  "successUrl": "https://yourdomain.com/pay-result?status=success",
  "cancelUrl": "https://yourdomain.com/pay-result?status=cancel"
}'

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-05-17 23:15:55

Refresh Access Token

List Payment History