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

# Cybersource - iDEAL | Wero

> Configure iDEAL | Wero via CyberSource as a payment method in Gr4vy.

**Cybersource**

Cybersource is a Visa solution that provides comprehensive payment processing solutions across multiple payment methods and regions.

iDEAL is a popular online banking payment method in the Netherlands that allows customers to pay directly from their bank account. It is widely used for e-commerce transactions and provides instant payment confirmation.

> [!NOTE]
>
> iDEAL is moving to [Wero](https://ideal.nl/en/naar-wero), the European Payments Initiative's payment method. During the transition, buyers see it as **iDEAL | Wero**. Nothing changes in your integration: the payment method ID stays `ideal`.

## Setup

Please follow the [common Cybersource instructions](https://docs.gr4vy.com/connections/payments/cybersource.md) to get set up with CyberSource.

After setting up your Cybersource account, make sure iDEAL is enabled as a payment method on your account.

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

## Supported countries

## Supported currencies

## Integration

For iDEAL, the default integration for CyberSource is through a redirect to a hosted payments page.

Start by creating a new transaction with the following required fields.

```csharp C# theme={"system"}
var transaction = await client.Transactions.CreateAsync(
  transactionCreate: new TransactionCreate()
  {
    Amount = 1299,
    Currency = "EUR",
    Country = "NL",
    PaymentMethod =
      TransactionCreatePaymentMethod.CreateRedirectPaymentMethodCreate(
        new RedirectPaymentMethodCreate()
        {
          Method = "ideal",
          Country = "NL",
          Currency = "EUR",
          RedirectUrl = "https://example.com/callback",
        }
      ),
  }
);
```

```go Go theme={"system"}
amount := int64(1299)
currency := "EUR"
country := "NL"
method := components.RedirectPaymentMethodCreateMethodIdeal
redirectUrl := "https://example.com/callback"

redirectPaymentMethodCreate := components.RedirectPaymentMethodCreate{
  Method: method,
  Country: country,
  Currency: currency,
  RedirectURL: redirectUrl,
}
paymentMethod := components.CreateTransactionCreatePaymentMethodRedirectPaymentMethodCreate(redirectPaymentMethodCreate)

transactionCreate := components.TransactionCreate{
  Amount:        amount,
  Currency:      currency,
  Country:       &country,
  PaymentMethod: &paymentMethod,
}

transaction, err := client.Transactions.Create(ctx, transactionCreate, nil, nil, nil)
```

```java Java theme={"system"}
CreateTransactionResponse transactionResponse = gr4vyClient.transactions().create()
  .transactionCreate(TransactionCreate.builder()
    .amount(1299L)
    .currency("EUR")
    .country("NL")
    .paymentMethod(TransactionCreatePaymentMethod.of(RedirectPaymentMethodCreate.builder()
      .method(RedirectPaymentMethodCreateMethod.IDEAL)
      .country("NL")
      .currency("EUR")
      .redirectUrl("https://example.com/callback")
      .build()))
    .build())
  .call();

Transaction transaction = transactionResponse.transaction().orElse(null);
```

```php PHP theme={"system"}
$transactionCreate = new TransactionCreate(
  amount: 1299,
  currency: 'EUR',
  country: 'NL',
  paymentMethod: new RedirectPaymentMethodCreate(
    method: 'ideal',
    country: 'NL',
    currency: 'EUR',
    redirectUrl: 'https://example.com/callback'
  )
);
$response = self::$sdk->transactions->create($transactionCreate);
$transaction = $response->transaction;
```

```python Python theme={"system"}
transaction: models.Transaction = client.transactions.create(
  amount=1299,
  currency="EUR",
  country="NL",
  payment_method={
    "method": "ideal",
    "country": "NL",
    "currency": "EUR",
    "redirect_url": "https://example.com/callback",
  }
)
```

```ts TypeScript theme={"system"}
const transaction = await gr4vy.transactions.create({
  amount: 1299,
  currency: "EUR",
  country: "NL",
  paymentMethod: {
    method: "ideal",
    country: "NL",
    currency: "EUR",
    redirectUrl: "https://example.com/callback"
  }
})
```

After the transaction is created, the API response includes `payment_method.approval_url` and the `buyer_approval_pending` status.

```json theme={"system"}
{
  "type": "transaction",
  "id": "ea1efdd0-20f9-44d9-9b0b-0a3d71e9b625",
  "payment_method": {
    "type": "payment-method",
    "approval_url": "https://cdn.sandbox.spider.gr4vy.app/connectors/cybersource/apm.html?token=..."
  },
  "method": "ideal"
}
```

Redirect the buyer to the `approval_url` so they can complete authentication and approve the payment. After approval the buyer is redirected to the `redirect_url` you provided when creating the transaction. Do not rely solely on the redirect - either poll the transaction or (recommended) rely on webhooks to detect the final status (for example `capture_succeeded` or failure states).

### Pending transactions

Cybersource does not support webhooks for iDEAL transactions yet. This means that any payment in a pending status requires a query to the Cybersource API to get the latest status. The system automatically polls for status updates.

### Merchant name

By default the merchant name is set to `Default merchant name` for an iDEAL payment. To set this to a custom value, use the `statement_descriptor.name` field:

```json theme={"system"}
{
    "amount": 1800,
    "currency": "EUR",
    "country": "NL",
    "intent": "capture",
    "payment_method": {
        "method": "ideal",
        "country": "NL",
        "currency": "EUR",
        "redirect_url": "https://example.com"
    },
    "statement_descriptor": {
        "name": "Test 123"
    }
}
```

## Testing

Cybersource has [instructions](https://developer.cybersource.com/hello-world/testing-guide.html) on how to test iDEAL.


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