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

# Adyen - Konbini (7-Eleven)

> Configure Konbini (7-Eleven) cash payments via Adyen as a payment method in Gr4vy.

**Adyen**

Adyen is a global payment technology company founded in 2006 in Amsterdam, Netherlands. The company provides a single platform for accepting payments across online, mobile, and in-store channels for major enterprises worldwide including Uber, Spotify, and Microsoft.

Konbini is a popular cash-based payment method in Japan. The buyer receives a payment voucher during checkout and then pays in cash at a convenience store. This connector covers 7-Eleven specifically and is processed through eContext. To accept cash payments at Lawson, FamilyMart, Mini Stop, and Seicomart, use the [Konbini connector](https://gr4vy.radial-commerce.com/connections/payments/adyen-konbini.md) instead.

## Setup

Please follow the [common Adyen instructions](https://gr4vy.radial-commerce.com/connections/payments/adyen.md) to get set up with Konbini.

Next, make sure to enable Konbini as a payment method on your configured account.

## Supported countries

## Supported currencies

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

## Integration

For 7-Eleven, the default integration for Adyen is through a redirect to a hosted payments page.

7-Eleven is a cash payment method. After the voucher is issued, the buyer pays in cash at a 7-Eleven store, which can take up to three days. The payment is confirmed out of band, so rely on webhooks to detect the final status rather than the buyer returning to your site.

### Redirect integration

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 = "JPY",
    Country = "JP",
    Intent = "capture",
    PaymentMethod =
      TransactionCreatePaymentMethod.CreateRedirectPaymentMethodCreate(
        new RedirectPaymentMethodCreate()
        {
          Method = "seveneleven",
          Country = "JP",
          Currency = "JPY",
          RedirectUrl = "https://example.com/callback",
        }
      ),
  }
);
```

```go Go theme={"system"}
amount := int64(1299)
currency := "JPY"
country := "JP"
method := components.RedirectPaymentMethodCreateMethodSeveneleven
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,
  Intent:       gr4vy.Pointer(components.TransactionIntentCapture),
  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("JPY")
    .country("JP")
    .intent(TransactionIntent.CAPTURE)
    .paymentMethod(TransactionCreatePaymentMethod.of(RedirectPaymentMethodCreate.builder()
      .method(RedirectPaymentMethodCreateMethod.SEVENELEVEN)
      .country("JP")
      .currency("JPY")
      .redirectUrl("https://example.com/callback")
      .build()))
    .build())
  .call();

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

```php PHP theme={"system"}
$transactionCreate = new TransactionCreate(
  amount: 1299,
  currency: 'JPY',
  country: 'JP',
  intent: 'capture',
  paymentMethod: new RedirectPaymentMethodCreate(
    method: 'seveneleven',
    country: 'JP',
    currency: 'JPY',
    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="JPY",
  country="JP",
  intent="capture",
  payment_method={
    "method": "seveneleven",
    "country": "JP",
    "currency": "JPY",
    "redirect_url": "https://example.com/callback",
  }
)
```

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

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

```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/adyen/apm.html?token=..."
  },
  "method": "seveneleven"
}
```

Present the `approval_url` to the buyer so they can enter their details and receive a voucher reference. The buyer then takes the voucher to a 7-Eleven store and pays in cash.

Because 7-Eleven payments settle out of band, the buyer is not redirected back to Gr4vy after paying. The transaction moves to a `processing` status while it waits, and the voucher is valid for three days. Rely on webhooks to detect the final status, for example `capture_succeeded` once the store processes the cash payment, or a failure state if the voucher expires.

### Direct integration

Adyen provides [web](https://docs.adyen.com/online-payments/build-your-integration/sessions-flow?platform=Web\&integration=Components\&version=6.23.0), [Android](https://docs.adyen.com/online-payments/build-your-integration/sessions-flow?platform=Android\&integration=Components\&version=5.15.0) and [iOS](https://docs.adyen.com/online-payments/build-your-integration/sessions-flow?platform=iOS\&integration=Components\&version=5.21.1) SDKs for a direct integration. For these flows you should indicate the platform by setting an appropriate `integration_client` when creating the transaction, and then build a client-side integration that uses the [`POST /transactions/:transaction_id/session`](https://gr4vy.radial-commerce.com/reference/transactions/get-transaction-session) API to initialize the Adyen SDK.

For mobile, set `integration_client` to `ios` or `android` and use your app deep link for `redirect_url` (for example, `yourapp://`).

After the transaction is created, the API response includes a `session_token` which can be used to get the [session data](https://gr4vy.radial-commerce.com/reference/transactions/get-transaction-session.md) for that transaction.

```sh theme={"system"}
POST /transactions/:transaction_id/session?token=:session_token
```

This session data provides the `sessionId` and `sessionData` required to load the Adyen SDK. Refer to the [common Adyen integration guidance](https://gr4vy.radial-commerce.com/connections/payments/adyen-sofort.md#direct-integration) for a worked example of initializing the Adyen SDK with this session data.

As with the redirect integration, the buyer pays in cash at a 7-Eleven store after the voucher is issued, so the final status arrives via webhook rather than an immediate response.

## Testing

> [!WARNING]
>
> 7-Eleven payments cannot be tested in the Adyen test environment. Contact Adyen Support to arrange penny testing in the live environment.

Adyen has [instructions](https://docs.adyen.com/payment-methods/econtext-seven-eleven/web-component/#test-and-go-live) on how to test 7-Eleven.


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