Skip to main content
POST
Step 3 - Create invoice and order

Overview

Use this endpoint to convert a validated checkout payload into an invoice your customer can pay.

Authentication

Commerce merchant checkout endpoints use x-commerce-api-key.

Request

SDK

cURL

Response

Errors

  • 400 invalid checkout payload
  • 401 missing/invalid commerce auth

Examples

  • Follow the 3-step flow: estimate → address → invoice to ensure totals/shipping are validated before invoice creation. Next: Payment session details

Authorizations

x-commerce-api-key
string
header
required

Legacy alias for commerce-scoped API keys. Prefer x-api-key with scope=commerce.

Body

application/json

Step 3 request. Creates the final invoice + commerce order from an existing estimate + address.

customer_id
string
required
Example:

"cust_123456"

estimateId
string<uuid>
required
addressId
string<uuid>
required
webhookUrl
string<uri> | null

Deprecated/ignored; use merchant webhook configuration endpoints instead.

refundDestinationWalletAddressBsc
string | null

Optional BSC destination address for refunds (0x…).

Example:

"0x0000000000000000000000000000000000000001"

Response

200 - application/json

Invoice created successfully

success
boolean
Example:

true

data
object

Step 3 result. Contains invoice URL and payment session headers.