Introduction
Konbini uses a redirect-based payment flow. When a customer selects Konbini at checkout, they are redirected to a hosted page where a payment code and instructions are generated. The customer then visits their nearest convenience store and pays using the code at the register or payment kiosk. This guide explains the process of integrating Konbini into your app or website using Payrails.Pre-requisites
Before you start accepting Konbini payments with Payrails, there are a few requirements you must meet:Ways to integrate Konbini
Payrails SDK
Server-to-server integration
Parse Konbini from lookup response
Pass Konbini payment method in request to authorize payment with Payrails
Note on amountsJPY is a zero-decimal currency—amounts should be provided as whole numbers (for example,
100000 for ¥100,000). Do not include decimal places.Konbini is a redirect-based, single-use payment method. After calling the authorize endpoint, the customer will be redirected to a hosted page showing their payment code and instructions. The customer then pays at a convenience store. Once confirmed, the customer will be redirected back to the
returnInfo.success URL. Make sure to provide valid returnInfo URLs in your authorization request.Handle the redirect response
Supported currencies
Konbini via dLocal supports the following presentment currency:- JPY — Japanese Yen
Supported regions / countries
Customer regions
Konbini is available to customers based in:- Japan 🇯🇵