Retrieve a payment

GET

/payments/{id}

curl --request GET \
  --url https://api.bizzle.my/v1/payments/example \
  --header 'Authorization: Bearer <token>'

• Production
• Test (use test keys with the same host; sandbox semantics apply)

Authorizations

• bearerAuth
• xApiKey

Parameters

Path Parameters

id

required

string

Payment id (e.g. pay_…).

Responses

200

Payment.

Media typeapplication/json

object

id

string

object

string

Allowed values: payment

amount

integer

currency

string

status

string

Allowed values: pending paid failed refunded

fee

integer

nullable

net

integer

nullable

payout_status

string

checkout_url

string format: uri

created

integer format: int64

nullable

Example

{
  "id": "pay_8xQVk2zMqY4",
  "object": "payment",
  "currency": "TZS",
  "status": "pending"
}

403

Error response.

Media typeapplication/json

object

error

required

string

message

string

code

string

details

object

Example ^generated

{
  "error": "example",
  "message": "example",
  "code": "example",
  "details": {}
}

404

Error response.

Media typeapplication/json

object

error

required

string

message

string

code

string

details

object

Example ^generated

{
  "error": "example",
  "message": "example",
  "code": "example",
  "details": {}
}

429

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

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).