Reload an instrument with more value (recharge carte cadeau)
Adds amountCents to the instrument addressed by the path id, reactivating it when it had been drawn to depleted. initialBalanceCents is deliberately left at the ISSUANCE value, so a reloaded card ends up with balanceCents ABOVE it — which drops the card out of the breakage report’s neverRedeemed* bucket, since that bucket only counts cards whose balance still exactly equals what was issued. Use this instead of issuing a second card when a customer tops up the one they hold. NOT IDEMPOTENT — there is no dedup key, so a retried call tops the card up twice; re-read the instrument before retrying a request that may already have committed. 404s on an unknown id; 422s when the instrument is void or expired.
Authorizations
Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.
Path Parameters
The internal instrument id to act on (not the bearer code).
1Body
Value to add to the instrument, in strictly positive integer cents.
0 < x <= 9007199254740991Response
The instrument after the top-up, active at its raised balance.
The instrument after the top-up, active at its raised balance.
1gift_card, credit_note, store_credit 130 <= x <= 90071992547409910 <= x <= 9007199254740991active, depleted, void 1^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
