Create a payment order

POST

{{host}}/payout/v1/apply

Determine whether the order creation is successful based on the http status code
200 Success
400 Parameter error
401 Account or IP cannot be used
500 Server status abnormal
503 Server status abnormal

For specific error codes, refer to the error code

** After the order is created, please do not cancel

Request

Header Params

Body Params application/json

Example

{
    "mchOrderNo": "test-payout-000030",
    "notifyUrl": "https://webhook.site/8f874726-a8c3-458b-8525-0abb921f243a",
    "amount": 1000,
    "accountName": "jack",
    "accountNo": "12139143965",
    "accountType": 1,
    "phone": "+551234567890",
    "email": "FrancesStanley@Gabspot.com",
    "remark": "ullam qui laborum iste vitae."
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff 'https://gateway.potawallet.com/payout/v1/apply' \
--header 'X-Account: b5373276-3924-4fbb-8845-acd15e910543' \
--header 'X-Signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mchOrderNo": "test-payout-000030",
    "notifyUrl": "https://webhook.site/8f874726-a8c3-458b-8525-0abb921f243a",
    "amount": 1000,
    "accountName": "jack",
    "accountNo": "12139143965",
    "accountType": 1,
    "phone": "+551234567890",
    "email": "FrancesStanley@Gabspot.com",
    "remark": "ullam qui laborum iste vitae."
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{"orderNo":"PO20230802071913-00129","orderAmount":1000,"amount":1000,"fee":0}

🟠400请求有误

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

Create invoice order

Order inquiry