Adyen - Konbini (7-Eleven)

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

Setup

Please follow the common Adyen instructions 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

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.

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",
        }
      ),
  }
);

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)

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);

$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;

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",
  }
)

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.

{
  "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, Android and iOS 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 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 for that transaction.

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

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 on how to test 7-Eleven.

Introduction

Aggregators

Methods

Digital wallets

Anti-fraud

Browse

Adyen - Konbini (7-Eleven)

Setup

Supported countries

Supported currencies

Capabilities

Integration

Redirect integration

Direct integration

Testing

​Setup

​Supported countries

​Supported currencies

​Capabilities

​Integration

​Redirect integration

​Direct integration

​Testing

Setup

Supported countries

Supported currencies

Capabilities

Integration

Redirect integration

Direct integration

Testing