Payment-method icon

Japanese convenience stores Component

Accept payments through Japanese convenience stores using your existing Components integration.

On this page, you can find additional configuration for adding Japanese convenience stores to your Components integration.

Before you begin

This page assumes you have already:

API reference

You don't need to send additional fields for Japanese convenience stores. To see optional fields that you can send for all payment methods, choose the endpoint you integrated:

Component configuration

When creating an instance of the Component, specify which payment method type you want to use:

  • econtext_seven_eleven for 7-Eleven. The shopper is redirected to 7-Eleven's page where they see the voucher.
  • econtext_stores for Lawson, Mini Stop, Family Mart, and Seicomart. The shopper sees the voucher natively within your website, and receives it by email.

In the examples below, we show how to present an instance of the Component for econtext_stores.

Step 1: Create a DOM element

Create a DOM element on your checkout page, placing it where you want the payment method form to be rendered:

 <div id="econtext_stores-container"></div>

Step 2: Create an instance of the Component

Use the create method of your AdyenCheckout instance, in this case checkout, to create the Component:

const konbiniComponent = checkout.create('econtext_stores').mount('#econtext_stores-container');

Optional configuration

You can add the following optional configuration:

Parameter name Description Default
personalDetailsRequired Set to false to hide the input fields for shopper name, email, and telephone number. Added in v5.2.0 true

If you want to add optional configuration, include this in a configuration object. The following example shows how to configure the Component to hide the input fields for shopper name, email, and telephone number:

const konbiniConfiguration = {
  personalDetailsRequired: false // Optional. Set to **false** to hide the input fields for shopper name, email, and telephone number.
};

Use the create method of your AdyenCheckout instance, in this case checkout, to create an instance of the Component. Add the configuration object if you created one.

const konbiniComponent = checkout.create('econtext_stores', konbiniConfiguration).mount('#econtext_stores-container');

Test and go live

7-Eleven voucher payments can only be tested in the live environment. Contact our Support Team to set up 7-Eleven on the live environment for penny testing.

To test your integration, use the econtext simulator to complete voucher payments in Japanese convenience stores.

  1. Log in to the econtext Simulator using the following credentials:
    • Username: ectest
    • Password: #Gwecn25

  1. In the first box, provide 742001 as the shopID.

  1. In the second box, provide the acquirer reference following the format below:

    • pspReference-262320-econtext_stores
      For example, DZ4DPSHB4WD2WN82-262320-econtext_stores

    Get the pspReference from the AUTHORISATION webhook.

  1. In the third box you select what you want to test.
    • Leave as default for Convenience Stores
    • Select "セブンイレブン" for 7-Eleven
    • Select "Pay-easy(Bank Name)" for PayEasy ATM and PayEasy Online Banking

  1. Leave the fourth box 入金日時 (the time of payment) empty.

  1. Select 送信 (Submit).

  1. Wait for 15 minutes for the webhook.

Check the status of voucher payments in the test environment in your Customer Area:

  • Vouchers that are pending or that have expired, are under TransactionsOffers.
  • Vouchers that have been paid are under Transactions > Payments.

Before you can accept payments through Japanese convenience stores in live environment, you need to submit a request to add 7-Eleven or other Japanese convenience stores in your live Customer Area.

See also