Skip to content

Create an EPay order ​

POSThttps://pay.example.com/payments/epay/v1/order/create-transaction/submit.php

Request example ↓

Send signed parameters as a GET query or POST form. With a valid MD5 signature the gateway redirects to checkout with HTTP 302.

Parameters ​

FieldLocationTypeRequiredDescription
pidquery/formstringYesMerchant PID. Use a numeric PID for callbacks.
moneyquery/formnumberYesFiat amount.
out_trade_noquery/formstringYesMerchant order ID.
notify_urlquery/formstringYesMerchant callback URL.
return_urlquery/formstringNoBrowser return URL.
namequery/formstringNoProduct or order name.
typequery/formstringNoEmpty, alipay, or an enabled token.network selector.
tokenquery/formstringNoRequested token when no selector matched.
networkquery/formstringNoRequested network when no selector matched.
currencyquery/formstringNoOverrides the EPay currency default.
signquery/formstringYesEPay MD5 signature.
sign_typequery/formstringNoTypically MD5.

The sample signature uses the demonstration key epusdt_secret_key. Recalculate it on your server whenever the fields or merchant key change.

Responses

LocationLocation: /pay/checkout-counter/20260523171652123456001
application/json
Response fields
  • status_code integer

    Application result code.

  • message string

    Human-readable result.

  • data null

    Response payload; null on error.

  • request_id string

    Request identifier for tracing.

application/json
Response fields
  • status_code integer

    Application result code.

  • message string

    Human-readable result.

  • data null

    Response payload; null on error.

  • request_id string

    Request identifier for tracing.

application/json
Response fields
  • status_code integer

    Application result code.

  • message string

    Human-readable result.

  • data null

    Response payload; null on error.

  • request_id string

    Request identifier for tracing.

application/json
Response fields
  • status_code integer

    Application result code.

  • message string

    Human-readable result.

  • data null

    Response payload; null on error.

  • request_id string

    Request identifier for tracing.

application/json
Response fields
  • status_code integer

    Application result code.

  • message string

    Human-readable result.

  • data null

    Response payload; null on error.

  • request_id string

    Request identifier for tracing.

application/json
Response fields
  • status_code integer

    Application result code.

  • message string

    Human-readable result.

  • data null

    Response payload; null on error.

  • request_id string

    Request identifier for tracing.

application/json
Response fields
  • status_code integer

    Application result code.

  • message string

    Human-readable result.

  • data null

    Response payload; null on error.

  • request_id string

    Request identifier for tracing.

application/json
Response fields
  • status_code integer

    Application result code.

  • message string

    Human-readable result.

  • data null

    Response payload; null on error.

  • request_id string

    Request identifier for tracing.

application/json
Response fields
  • status_code integer

    Application result code.

  • message string

    Human-readable result.

  • data null

    Response payload; null on error.

  • request_id string

    Request identifier for tracing.

error-codes.json ↓