Renew a prepaid pass

POST

/v3/api/business/reseller/issued_passes/{client_id}/renew

Renews a prepaid issued pass by one billing cycle at the pass's current price and extends its expiry accordingly. Rejects passes that are not prepaid. 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 ********************

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200

*/*

Pass renewed successfully

Body*/*

🟠401

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v3/api/business/reseller/issued_passes/client_abc123/renew' \
--header 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "transaction_id": "txn_abc123"
}'

Response Example

200 - Success

{
    "object": "issued_pass",
    "id": "brgpass_01H8XYZABCDE",
    "pass_id": "pass_01H8XYZABCDE",
    "pass_name": "Premium Wellness Pass",
    "status": "active",
    "expires_at": 1777636800000,
    "amount_charged": 1500000,
    "currency": "NGN",
    "tx_ref": "FLW-TXN-ABCDEFGH",
    "message": "Pass renewed successfully"
}

Modified at 2026-07-06 21:49:00

Update user's pass expiry

Get User Pass Details