Skip to main content
The card simulator is a sandbox-only connector that simulates card payment responses. Use it to test your integration, validate failover scenarios between connectors, and verify your handling of AVS and CVV responses. The simulator supports all standard card features including delayed capture, partial capture, refunds, void, 3-D Secure pass-through, digital wallets, network tokens, and over capture.

​
Credentials

When setting up the card simulator in the dashboard, the following credential is available:
  • Merchant ID (optional) - An optional merchant ID for testing purposes.

​
Error codes

The amount field is used to simulate error codes. See the error codes documentation for all the possible error codes and each of the amounts to trigger them.

​
AVS responses

A buyer’s postal_code simulates different avs_response_code values for a transaction.

​
CVV responses

The CVV (security_code) simulates different cvv_response_code values.

​
Integration

To accept card payments with the card simulator, use one of Gr4vy’s client-side integration methods to securely collect card details. You can integrate using:
  • Embed - A pre-built, customizable payment form that handles the complete payment flow
  • Secure Fields - Embed card input fields for building custom payment forms while maintaining PCI compliance
  • Mobile SDKs - Native SDKs for iOS, Android, React Native, and other platforms