Skip to content

Test mode

Test credentials use the simulator issuer. It behaves like a real issuer with a real-time decision hook:

  • Account holders are approved instantly. A display_name containing reject fails KYC; review needs review.
  • POST /v1/account_holders/:id/fund adds test money.
  • POST /v1/cards/:id/display returns a fake 4242… test number (live mode returns an issuer-hosted iframe URL — card numbers never pass through Rive Card).
  • POST /v1/simulate/authorizations runs a purchase through the same rule engine live cards use.

Decline reasons: card_frozen, card_closed, card_expired, insufficient_funds, spend_limit_exceeded, transaction_count_exceeded, mcc_not_allowed, mcc_blocked, merchant_not_allowed, merchant_blocked, single_use_already_used, account_holder_not_approved, issuer_declined.