Create a payment
POST
/payments
const url = 'https://api.bizzle.my/v1/payments';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"amount":1,"currency":"TZS","description":"example","customer":"example","metadata":{},"success_url":"https://example.com","cancel_url":"https://example.com"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.bizzle.my/v1/payments \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "amount": 1, "currency": "TZS", "description": "example", "customer": "example", "metadata": {}, "success_url": "https://example.com", "cancel_url": "https://example.com" }'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Header Parameters
Section titled “Header Parameters”Idempotency-Key
string
Unique identifier used to replay requests safely.
Request Body
Section titled “Request Body”Media typeapplication/json
object
amount
required
integer
currency
string
description
string
customer
string
metadata
object
success_url
string format: uri
cancel_url
string format: uri
Responses
Section titled “Responses”Payment created.
Media typeapplication/json
object
id
string
object
string
amount
integer
currency
string
status
string
fee
integer
net
integer
payout_status
string
checkout_url
string format: uri
created
integer format: int64
Example
{ "id": "pay_8xQVk2zMqY4", "object": "payment", "currency": "TZS", "status": "pending"}Error response.
Media typeapplication/json
object
error
required
string
message
string
code
string
details
object
Example generated
{ "error": "example", "message": "example", "code": "example", "details": {}}Error response.
Media typeapplication/json
object
error
required
string
message
string
code
string
details
object
Example generated
{ "error": "example", "message": "example", "code": "example", "details": {}}Too many requests.
Media typeapplication/json
object
error
required
string
message
string
code
string
details
object
Example generated
{ "error": "example", "message": "example", "code": "example", "details": {}}Headers
Section titled “Headers”RateLimit-Limit
integer
Maximum requests per window.
RateLimit-Remaining
integer
Requests remaining in the current window.
RateLimit-Reset
integer
Unix seconds when the window resets.
Retry-After
integer
Seconds to wait before retrying (on 429/handled outages).