Creating Invoices
Create a project-bound, idempotent payment request.
Use POST /v1/invoices with a secret project API key. Send an Idempotency-Key that identifies this exact create attempt and a durable externalId that links the invoice to your order.
{
"amount": "49.90",
"asset": "USDT",
"network": "TRON",
"externalId": "ORDER-10482"
}All amounts are decimal strings. Do not convert them to floating-point numbers. The key selects the wallet and project configuration; per-request wallet and redirect overrides are intentionally unavailable on the integration API.
If the same idempotency key is retried with the same logical request, BramaPay returns the same invoice. Reusing it for different input returns 409 IDEMPOTENCY_CONFLICT. An externalId is permanently reserved within its project; use a new attempt identifier when intentionally creating a replacement payment request.