Create invoice order

POST

{{host}}/invoice/v1/create

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

Request

Header Params

Body Params application/json

Example

{
    "mchOrderNo": "test-invoice-000017",
    "amount": 10000,
    "name": "jack",
    "idNumber": "123123123",
    "phone": "+551234567890",
    "email": "jack@example.com",
    "subject": "macbook",
    "body": "one laptap",
    "notifyUrl": "https://webhook.site/8f874726-a8c3-458b-8525-0abb921f243a",
    "successUrl": "https://www.success-url.com"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff 'https://gateway.potawallet.com/invoice/v1/create' \
--header 'X-Account: b5373276-3924-4fbb-8845-acd15e910543' \
--header 'X-Signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mchOrderNo": "test-invoice-000017",
    "amount": 10000,
    "name": "jack",
    "idNumber": "123123123",
    "phone": "+551234567890",
    "email": "jack@example.com",
    "subject": "macbook",
    "body": "one laptap",
    "notifyUrl": "https://webhook.site/8f874726-a8c3-458b-8525-0abb921f243a",
    "successUrl": "https://www.success-url.com"
}'

Responses

🟢200success

application/json

Bodyapplication/json

Example

{
    "orderNo": "IV20230802070629-00127",
    "orderAmount": 100,
    "amount": 99,
    "fee": 1,
    "reference": "00020126940014br.gov.bcb.pix2572qrcodes-h.sulcredi.coop.br/v2/v3/at/f77a5a62-3ffd-4f84-9a85-ca34c36edc4e5204000053039865802BR5907VIATECH6003SMO62070503***6304BDF9",
    "url": "https://pix.potawallet.com/?param=2s1yrqTYGD2E0-uFlxJc4laqq8dXjZnlGxWh8XnwZh0="
}

Modified at 2026-02-10 13:22:46

Error code

Create a payment order