Create invioce order

POST

{{host_invoice_v2}}/create

The voucher query determines whether the order creation is successful based on the http status code
200 Returns the existing order information
201 Successful creation
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

** When creating a new order, the successful http status code is 201
** When mchOrderNo already exists, the http status code will be returned as 200
Both of the above cases will return order information

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://v2.invoice.potawallet.com/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

Examples

成功示例成功示例

{
    "orderNo": "PRV22024022404251971044557674252",
    "mchOrderNo": "TEST20240224122518275969617",
    "orderAmount": 2000,
    "amount": 1992,
    "fee": 8,
    "reference": "00020101021226900014br.gov.bcb.pix2568pix.sicoob.com.br/qr/payload/v2/33f69fa0-ba58-4fd7-85cf-5d57489bd2e95204000053039865802BR5919BRUNO DE SOUZA REGO6013Nao_informado62070503***63043945",
    "status": 2,
    "url": "https://pix.potawallet.com?param=uznHf4cH1wJ-0uxs6ppvnOn9rGAUpvzHnr9EJU5IoEQpwApX3kyXzaDFNfn6L_Ne",
    "expiresAt": 1708921080,
    "createdAt": 1708748719
}

🟢201success

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

Create a payment order

Create payment order - no query restrictions