Redeem a card over the counter
POST
/api/v1/admin/cards/redeem-otc
prm_cards_verify
The same operation as the subscriber-facing redeem, with one difference: the acting manager is recorded as the reseller, so the redemption snapshots what they paid against what they charged. Without that, per-reseller pricing never resolves and every redemption records face value on both sides.
At a glance
- Authentication
- Staff token or session
- Requires permission
-
prm_cards_verifyVerify / redeem cards - Rate limit
card_redeem- Idempotency key
request_id
Parameters
| Parameter | Description |
|---|---|
coderequired
body · string
|
The plaintext card code. |
user_idrequired
body · integer
|
The subscriber to credit. |
request_idrequired
body · string
|
Idempotency key. |
Errors
| Code | When it is returned |
|---|---|
ERR_NOT_FOUND404
|
unknown code, or a card or subscriber outside the caller's authority |
ERR_CONFLICT409
|
already redeemed, or a request_id bound to another card |