Skip to main content
These operations apply to both virtual and physical cards.

Freeze and unfreeze

Freeze a card when the cardholder reports it as lost or at risk. A frozen card declines all transactions. You or the cardholder can freeze and unfreeze at any time. Call Freeze a card to suspend the card. Call Unfreeze a card to restore it to ACTIVE.

Update PIN

Call Update PIN to set or change the cardholder’s PIN. The PIN is used for ATM withdrawals and at POS terminals that require chip-and-PIN verification. PIN requirements:
  • 4–12 digits
  • No 3 or more consecutive ascending digits (e.g. 123, 234)
  • No 3 or more repeated digits (e.g. 111, 555)

Delete a card

Call Delete a card to delete a card when offboarding a user or closing their card program. Deletion is irreversible via the API.

List cards

Call List cards to retrieve cards for your project. Use the accountId filter to scope results to a specific user’s account. This is the most common use case when showing a cardholder their own cards.

Blocked cards

Reap may block a card automatically when it detects suspicious activity, such as multiple failed PIN, CVV, or expiry attempts. A blocked card returns status: BLOCKED with a blockReason describing why. Blocked cards cannot be unblocked via the API. Contact Reap support to review and unblock.