Skip to main content
BlueSnap is a global payment platform that provides payment processing solutions for merchants worldwide. The platform supports card payments with features like delayed capture, partial refunds, digital wallet integration, and 3-D Secure authentication across multiple currencies and countries.

​
Setup

BlueSnap provides a self-service sign-up for a sandbox account. To sign up for an account, visit the BlueSnap sign-up page and fill in the required details.

​
Credentials

When setting up BlueSnap in the dashboard, configure the following credentials:
  • API User Key - Your BlueSnap API User Key
  • API Password - Your BlueSnap API Password
  • Webhook Security Header - Optional security header for webhook validation

​
Gated features

Some BlueSnap features need to be enabled by their support team before you can use or test them:
  • 3-D Secure - Requires activation on the account using the external 3DS server
  • Digital wallets - Apple Pay and Google Pay must be enabled on the account
Contact BlueSnap support to enable these features on your account.

​
Connector configuration

After setting up your BlueSnap connector in the dashboard, configure how transactions are routed to it. Choose one of the following options:
  • Using Flow - Configure BlueSnap as the target connector in Flow to automatically route card transactions to this connector
  • Using the API - Explicitly set the payment_service_id parameter to the BlueSnap connector ID when creating transactions. This overrides any Flow routing rules.
The connector ID can be found in the dashboard under Connections -> Configured connections.

​
Capabilities

​
Supported countries

​
Supported currencies

​
Integration

To accept card payments with BlueSnap, use one of Gr4vy’s client-side integration methods to securely collect card details. Due to PCI compliance requirements, card data should never be sent directly to your servers. 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
These methods handle card data collection and tokenization. Once the card details are collected and tokenized, create a transaction through the Gr4vy API, which automatically routes the payment to your configured BlueSnap connection based on your Flow rules or explicit payment_service_id parameter.

​
Testing

For testing in sandbox environments, you can use standard test card numbers. BlueSnap supports industry-standard test cards for simulating different transaction scenarios: Successful transactions:
  • Visa: 4111 1111 1111 1111
  • Mastercard: 5555 5555 5555 4444
  • American Express: 3782 822463 10005
Use any future expiry date and any 3-digit CVV (4 digits for American Express). For more test scenarios and additional card numbers, refer to the BlueSnap testing documentation or contact your BlueSnap representative.