Create a payment order

POST

/create

Determine order creation success based on HTTP status codes:
200: Returns existing order information
201: Creation successful
400: Parameter error
401: Account or IP unavailable
500: Server status error
503: Server status error
See error codes for details
**When creating a new order, the successful HTTP status code is 201.
When mchOrderNo already exists, the HTTP status code will be 200. In both cases, order information will be returned.

Request

Header Params

Body Params application/json

Example

{
    "mchOrderNo": "string",
    "amount": 0,
    "notifyUrl": "string",
    "accountName": "string",
    "accountNo": "string",
    "bankCode": "string",
    "phone": "string",
    "email": "string",
    "remark": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/create' \
--header 'X-Account: b5373276-3924-4fbb-8845-acd15e910543' \
--header 'X-Signature;' \
--header 'Content-Type: application/json' \
--data '{
    "mchOrderNo": "string",
    "amount": 0,
    "notifyUrl": "string",
    "accountName": "string",
    "accountNo": "string",
    "bankCode": "string",
    "phone": "string",
    "email": "string",
    "remark": "string"
}'

Responses

🟢200成功

application/json

Bodyapplication/json

Example

{
    "orderNo": "PTV22024022417430080580517502972",
    "mchOrderNo": "TEST20240225014259240252749",
    "amount": 100,
    "fee": 0,
    "orderAmount": 100,
    "createdAt": 1708796580,
    "status": 11
}

Modified at 2026-02-10 12:59:50

Create a invioce order

Create invioce order