Integrate Konbini payments to initiate cash payments in a checkout flow. Consumers complete the payment at one of the following convenience stores: 7-Eleven, Lawson, FamilyMart, and Seicomart.

Payment Method Properties

Available country codesJP
Processing (Presentation) currenciesJPY
Settlement currenciesJPY
Consumer currenciesJPY
Channel member tagkonbini
Scheme name in the settlement fileKonbini
Minimum transaction amountJPY 1
Maximum transaction amountJPY 300,000
Session timeout8 days and 10 minutes
Refund ValidityN/A
Integration TypeAsynchronous

Transaction Flow

  1. The consumer selects Konbini payment on the merchant's checkout page.
  2. They are redirected to the store selection page to choose the convenience store.
  3. The consumer receives a QR code and a payment reference number which can both be used to pay.
  4. The consumer scans the QR code or inputs the reference number at a Kiosk machine in the selected Konbini store.
  5. The Kiosk machine prints out a slip.
  6. The consumer takes the slip to the cashier, who scans it and collects the cash payment.

Konbini Integration

Specific input parameters for the TRANSACTION call

Field NameM/O/CTypeRegexDescription
specin.phoneMnumeric^[0-9]{10,11}$The phone number of the consumer. Hyphens, country code, or other characters (single-byte alphanumeric) are not allowed; must be between 10-11 digits.
specin.emailMutf-8N/A. Must be RFC-compliant.The email address of the account holder
specin.iteminfoMutf-8^[ -~]{1,22}$Information about the items being purchased, displayed on the payment page (up to 22 characters).

For standard input parameters, see Input parameters for the TRANSACTION call.

Specific output parameters for the TRANSACTION call

Field NameTypeDescription
SPECOUT.PAYMENTMETHODCODEasciiA unique code identifying the selected payment method.
SPECOUT.PAYMENTMETHODNAMEasciiThe human-readable name of the selected payment method.

For standard output parameters, see Output parameters for the TRANSACTION call.

TRANSACTION call input


TRANSACTION call output

&SPECOUT.PAYMENTMETHODNAME=Convenience Store via Lawson

Additional information

  • Konbini only works for consumers in Japan.
  • Merchant of Record (MOR) is not supported.
  • The account holder name passed in the request has to be in the format .
  • Each name’s format must be a single byte UTF-8 character set.
  • The character limit of the first name and last name is ten characters each. Japanese characters are allowed. Spaces are not permitted within the and themselves. In the case of multiple first names, valid examples include “JohnDoe Dorian” but not “John Doe Dorian”.
  • Only the first name is mandatory.
  • If these conditions are not met, the system will not accept the request.

Requirements for international merchants

For Lawson, FamilyMart, Ministop, Seicomart, and Circle K Sunkus:

  • Merchants are not required to have a Japanese entity.
  • The merchant's e-commerce website, however, must be in Japanese and target Japanese consumers.
  • The merchant must include a customer support number that leads the consumers to Japanese-speaking customer support.

For 7-eleven:

  • Merchants must have a Japanese entity to accept Konbini Payments.

Branding Guidelines

Click here to download logos.