> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gr4vy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BlueSnap - Card

> Connect to BlueSnap to accept credit and debit card payments.

**BlueSnap**

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](https://sandbox.bluesnap.com/jsp/onboarding/) 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
* **Merchant ID (MID)** - Required if Surcharging is enabled, optional otherwise
* **Enable Surcharge** - Automatically calculate and apply a surcharge to transactions using BlueSnap's surcharge feature. The account must already have surcharging enabled with BlueSnap.

### 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
* **Surcharge** - surcharging needs to be enabled on your account by BlueSnap support

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](https://docs.gr4vy.com/guides/dashboard/flow/overview.md) 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**.

## Surcharging

Surcharging is a feature enabled for the account, not the credential. Once BlueSnap's
support team activates it, all transactions with a non-zero amount require a surcharge token
generated by BlueSnap to process. Make sure the credential in the Gr4vy
dashboard is also marked with **Enable Surcharge** to match.

The amount sent to Gr4vy should always be the raw amount, with no fees included.
Gr4vy uses this raw amount to calculate the surcharge via BlueSnap's own API
(`/surcharge/calculate`, or `/surcharge/calculate-prorated` for partial captures),
generating a surcharge token and the fee amount to add before sending the total to
BlueSnap. For a full capture, the captured amount is expected to already equal the
authorized total (raw amount + surcharge), so it's sent as-is without generating a new token

## Capabilities

This list is for guidance only. It doesn't guarantee availability or
create any rights, and the provider may need to enable some features for
your account.

This connector doesn't support the [Mastercard Transaction Link Identifier (TLID)](https://docs.gr4vy.com/guides/features/recurring-payments/mastercard-tlid.md) yet.

## 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](https://docs.gr4vy.com/guides/payments/embed/quick-start)** - A pre-built, customizable payment form that handles the complete payment flow
* **[Secure Fields](https://docs.gr4vy.com/guides/payments/secure-fields/quick-start)** - Embed card input fields for building custom payment forms while maintaining PCI compliance
* **[Mobile SDKs](https://docs.gr4vy.com/guides/payments/mobile.md)** - Embed SDKs for iOS, Android, and React Native

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](https://support.bluesnap.com/docs/test-credit-cards) or contact your BlueSnap representative.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.