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.

​
Features

BlueSnap supports the following features:
  • Delayed capture - Authorize a payment and capture it at a later time
  • Partial capture - Capture a portion of the authorized amount
  • Partial refunds - Refund a portion of the captured amount
  • Void - Cancel an authorized transaction before capture
  • Zero auth - Verify a card without charging it
  • Digital wallets - Support for Apple Pay, Google Pay, and other digital wallet integrations
  • 3-D Secure pass-through - Support for pass-through 3DS authentication
  • Transaction sync - Automatic synchronization of transaction status updates

​
Supported countries

BlueSnap supports transactions from buyers in the following countries:
Country codeCountry codeCountry codeCountry codeCountry codeCountry codeCountry codeCountry code
ADAEAGAIALAMAOAQ
ARASATAUAWAZBABB
BDBEBFBGBHBIBJBM
BNBOBRBSBTBVBWBY
BZCACCCGCHCICKCL
CMCNCOCRCVCWCXCY
CZDEDJDKDMDODZEC
EEEGEHERESETFIFJ
FKFMFOFRGAGBGDGE
GFGGGHGIGLGMGNGP
GQGRGTGUGYHKHMHN
HRHTHUIDIEILIMIN
IOISITJEJMJOJPKE
KGKHKIKMKNKRKWKY
KZLALBLCLILKLRLS
LTLULVMAMCMDMEMF
MGMHMKMMMNMOMPMQ
MRMSMTMUMVMWMXMY
MZNANCNENFNGNINL
NONPNRNUNZOMPAPE
PFPGPHPKPLPMPNPR
PSPTPWPYQARERORS
RURWSASBSCSESGSH
SISJSKSLSMSNSRST
SVSXSZTCTDTFTGTH
TJTKTLTMTNTOTRTT
TVTWTZUAUGUMUSUY
UZVAVCVGVIVNVUWF
WSYTZAZMZW

​
Supported currencies

BlueSnap supports processing payments in the following currencies:
Currency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency code
AEDAFNALLAMDARSAUDAWGBAMBBDBGN
BHDBMDBNDBOBBRLBSDBWPCADCHFCLP
CNYCOPCRCCZKDKKDOPDZDEGPEURFJD
GBPGELGIPGTQHKDHUFIDRILSINRISK
JMDJPYKESKHRKRWKWDKYDKZTLBPLKR
MADMDLMKDMURMWKMXNMYRNADNGNNOK
NPRNZDOMRPABPENPGKPHPPKRPLNQAR
RONRSDRUBSARSCRSDGSEKSGDTHBTND
TRYTTDTWDTZSUAHUSDUYUUZSVNDXAF
XCDXOFZAR

​
Limitations

The following features are not supported by this connector:
  • Payment method tokenization - Storing payment methods outside of transactions using a separate tokenization flow
  • Over-capture - Capturing an amount greater than the authorized amount
  • Partial authorization - Accepting a partial amount when the full amount cannot be authorized
  • Direct integration - Creating or updating transactions directly through BlueSnap’s API
  • Network tokens - Network-level tokenization for enhanced security
  • Issuer-based installments - Installment plans managed by the card issuer
  • Settlement reporting - Automated settlement and reconciliation reporting
  • 3-D Secure hosted - BlueSnap’s hosted 3DS authentication flow

​
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.