Purchase credits

POST

/v3/api/business/reseller/credit_purchases

Purchases a credit package for a client. Idempotent — supply Idempotency-Key to safely retry.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201

*/*

Credit purchase successful

Body*/*

🟠400

🟠401

🟠403

🟠404

🟠409

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v3/api/business/reseller/credit_purchases' \
--header 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "package_id": "pkg_abc123",
    "client_id": "client_abc123"
}'

Response Example

201 - Success

{
    "object": "credit_purchase",
    "id": "cpur_5f2a8c4d1e7b9f3a",
    "client_id": "client_abc123",
    "package_name": "50 Credits Pack",
    "credits_purchased": 50,
    "total_credits_added": 50,
    "new_balance": 75,
    "amount": 500000,
    "currency": "NGN",
    "tx_ref": "TX-1234567890",
    "status": "SUCCESSFUL",
    "created": 1746700000000,
    "message": "Credits purchased successfully"
}

Modified at 2026-05-21 13:30:24

Introduction

Get credit packages