API ReferencePayments
Create
Authorization
AppApiKey AppApiSecret X-Api-Key<token>
Per-app API key. Sent together with the X-Api-Secret header. The key's mode (TEST or LIVE) selects the data partition — it is never taken from the request body.
In: header
X-Api-Secret<token>
Per-app API secret that pairs with X-Api-Key. Both headers are required on every app-facing call.
In: header
Header Parameters
Idempotency-Key?string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
*/*
curl -X POST "https://example.com/api/v1/payments" \ -H "Content-Type: application/json" \ -d '{ "amountMinor": 0, "customerReference": "string" }'{
"data": {
"id": 0,
"reference": "string",
"status": "string",
"applicationId": 0,
"mode": "string",
"amountMinor": 0,
"currency": "string",
"gateway": "string",
"gatewayTxnId": "string",
"checkoutUrl": "string",
"redirectUrl": "string",
"invoiceId": 0,
"metadata": {},
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
},
"meta": {
"success": true,
"message": "string",
"errorCode": "RESOURCE_NOT_FOUND",
"timestamp": "2019-08-24T14:15:22Z"
},
"pagination": {
"page": 0,
"size": 0,
"totalElements": 0,
"totalPages": 0
}
}