Unfreeze a PIN
Re-activate a disabled PIN so it can be redeemed and topped up again.
POST
https://afropin.com/api/v1/brand/pins/unblock
HMAC-signed request with a unique Idempotency-Key header. Authentication
With an SDK
PHP
$afropin->brand->pins->unblock($params)Node.js
afropin.brand.pins.unblock(params)Python
afropin.brand.pins.unblock(params)Java
afropin.brand().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 →