Japanese convenience stores Drop-in integration

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

Before you begin

This page assumes you've already:

• Built an Drop-in integration.
• Added Convenience Stores in your Customer Area. This allows you to support payments made through Lawson, Mini Stop, Family Mart, and Seicomart.
• Added 7-Eleven in your Customer Area. This allows you to support payments made through 7-Eleven.

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:

• /sessions: This is the default with Drop-in v5.0.0 or later.
• /payments: If you implemented an advanced use case, or integrated Drop-in before v5.0.0.

Drop-in configuration

Required configuration

There is no required Japanese convenience stores specific configuration for Drop-in.

Optional configuration

You can add the following optional configuration:

If you want to add optional configuration, include this in a configuration object. The following example shows how to configure Drop-in 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.
};

If you created a konbiniConfiguration object, include this when creating a configuration object:

const configuration = {
  // ...  other required configuration
  paymentMethodsConfiguration: {
    econtext_stores: konbiniConfiguration
  }
};

Test and go live

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

1. Login to the econtext Simulator using the following credentials:
   • Username: ectest
   • Password: #eg0810#

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

3. In the second box, provide the acquirer reference following the format below:
   • pspReference-262320-econtext_stores
     For example, 8515814273533258-262320-econtext_stores
   Get the pspReference from the AUTHORISATION webhook.

4. In the third box, select 入金通知 (the first option).

5. On the next page, choose the convenience store from the list and select 登録.

6. Wait for 15 minutes for the notification 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 Transactions > Offers.
• 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