AfroPin Developers
Postman Sign in Get test keys

Unfreeze a PIN

Re-activate a disabled PIN so it can be redeemed and topped up again.

POST https://afropin.com/api/v1/reseller/pins/unblock

HMAC-signed request with a unique Idempotency-Key header. Authentication

With an SDK
PHP$afropin->reseller->pins->unblock($params)
Node.jsafropin.reseller.pins.unblock(params)
Pythonafropin.reseller.pins.unblock(params)
Javaafropin.reseller().pins().unblock(params)

Body parameters

pin_id uuid Required

The PIN id returned when it was issued. It must belong to your account and to the mode of your API key.

An expired PIN cannot be re-activated; the request fails with pin_expired. To stop a PIN from being used, call Disable a PIN.

Request

{
    "pin_id": "9f1c2e7a-4b22-4c10-9a3e-7d2f1b6c8a90"
}

Response 200

{
    "ok": true,
    "data": null
}

Errors

Failed requests return a stable code with a translated message. Branch on code, never on the message.

422 validation_error Some fields are missing or invalid
403 wrong_account_type Your account type cannot use this endpoint
404 pin_not_found No PIN has this id
403 pin_expired This PIN has expired
409 pin_already_active This PIN is already active
429 rate_limited Too many requests. Wait a moment and try again
500 internal_error Something went wrong on our side. Try again; if it keeps happening, contact support
{
    "ok": false,
    "error": {
        "code": "pin_not_found",
        "message": "No PIN has this id",
        "fields": null
    }
}
All error codes →