Partner Invoices
Create invoice
Creates an invoice for one of your sub-merchants. Prefer sending customers to `checkoutUrl` (white-label / branding-off hosted checkout).
Creates an invoice for one of your sub-merchants. Prefer sending customers to
checkoutUrl (white-label / branding-off hosted checkout).
Authorization
bearerAuth AuthorizationBearer <token>
Partner API key (pt_test_... or pt_live_...)
In: header
Header Parameters
Idempotency-Key*string
Unique key per create attempt. Reuse returns the same result when the body matches.
Length
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Environment comes from the Partner API key. Do not send environment.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/partner/invoices" \ -H "Idempotency-Key: string" \ -H "Content-Type: application/json" \ -d '{ "merchantId": "c3073b9d-edd0-49f2-a28d-b7ded8ff9a8b", "amount": "string" }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "merchantId": "c3073b9d-edd0-49f2-a28d-b7ded8ff9a8b", "status": "CREATED", "environment": "test", "amount": "string", "amountReceived": "string", "referenceId": "string", "checkoutUrl": "http://example.com", "expiresAt": "2019-08-24T14:15:22Z", "addresses": [ { "chainId": "9e7fb22a-9e5b-420e-8fd7-e3454fcfd5fd", "chainName": "string", "family": "evm", "networkId": 0, "depositAddress": "string", "tokens": [ { "symbol": "string", "contractAddress": "string", "decimals": 0 } ] } ]}{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "merchantId": "c3073b9d-edd0-49f2-a28d-b7ded8ff9a8b", "status": "CREATED", "environment": "test", "amount": "string", "amountReceived": "string", "referenceId": "string", "checkoutUrl": "http://example.com", "expiresAt": "2019-08-24T14:15:22Z", "addresses": [ { "chainId": "9e7fb22a-9e5b-420e-8fd7-e3454fcfd5fd", "chainName": "string", "family": "evm", "networkId": 0, "depositAddress": "string", "tokens": [ { "symbol": "string", "contractAddress": "string", "decimals": 0 } ] } ]}{ "error": { "code": "string", "message": "string" }}{ "error": { "code": "string", "message": "string" }}{ "error": { "code": "string", "message": "string" }}