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:
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 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:
Test and go live
To test your integration, use the econtext simulator to complete voucher payments in Japanese convenience stores.
- Login to the econtext Simulator using the following credentials:
- Username: ectest
- Password: #eg0810#
- In the first box, provide 742001 as the shopID.
-
In the second box, provide the acquirer reference following the format below:
pspReference
-262320-econtext_stores
For example, 8515814273533258-262320-econtext_stores
pspReference
from the AUTHORISATION webhook.
- In the third box, select 入金通知 (the first option).
- On the next page, choose the convenience store from the list and select 登録.
- 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.