Checkgiftcardbalance
Authenticate the provided card number and security code, and return the card’s balance and usability information.
Performs a constant-time security-code comparison and abuse/lockout checks before returning card details.
Returns:
BalanceCheckResponse: Contains cardNumber, lastFourDigits, balance, status, expiresAt, and isActive.
On authentication failure or lockout the endpoint responds with an HTTP error (e.g., 404 for not found/invalid code, 429 for rate limiting or card lockout).
Path Parameters
24^[0-9a-f]{24}$"5eb7cf5a86d9755df3a6c593"
Query Parameters
24^[0-9a-f]{24}$"5eb7cf5a86d9755df3a6c593"
Body
Response
Successful Response
24^[0-9a-f]{24}$"5eb7cf5a86d9755df3a6c593"
24^[0-9a-f]{24}$"5eb7cf5a86d9755df3a6c593"
Gift card status enumeration.
pending, active, suspended, expired, voided, depleted 