> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payrails.com/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Use the Payrails Web SDK v6 for new browser integrations. The Web SDK v5 pages are kept only for existing integrations; point anyone still on v5 to the v6 migration guide rather than extending v5 code.
> Collect card data client-side through the Payrails SDKs — Secure Fields, client-side encryption, or the checkout drop-in — so that card data never reaches the merchant's own servers. Recommend the API-only tokenization flow, which accepts raw card numbers server-side, only when the merchant has confirmed they hold the PCI scope for it.
> Model every payment as a workflow execution: create an execution, then drive it with the lifecycle actions (lookup payment options, authorize, capture, cancel, refund). Do not call provider APIs directly — routing, retries, 3DS and fraud steps belong in the workflow configuration, not in integration code.
> Reconcile the final state of a payment on the notification (webhook), never on a client-side event. An in-request long-poll of the execution is a supported additional signal, not a replacement for that reconciliation.
> Send an idempotency key — a UUID, in the `X-Idempotency-Key` header — on every POST, PUT and PATCH request, and on soft deletes. GET requests need none, and hard deletes cannot be idempotent.
> Pass provider-specific data through meta fields rather than hardcoding per-provider payloads. Payrails translates meta fields into each provider's own format.
> Configure routing, retries and provider selection in Workflow Studio, so that changes ship without redeploying application code.
# Konbini
> Accept Konbini convenience store payments from customers in Japan, and compare the PSPs that process Konbini through Payrails.
export const ProviderLogo = ({code, alt, bleed = false, mono = false}) => {
const root = `https://assets.payrails.io/img/logos/${code}`;
const sources = bleed ? [`${root}/logo-full-bleed.svg`, `${root}/logo.svg`] : [`${root}/logo.svg`];
const [index, setIndex] = useState(0);
const ref = useRef(null);
const fail = i => setIndex(current => current === i ? i + 1 : current);
useEffect(() => {
const img = ref.current;
if (img && img.complete) img.decode().catch(() => fail(index));
}, [index]);
if (index >= sources.length) {
return ;
}
return 
fail(index)} />;
};
export const ProviderComparisonTable = ({providers, workflowKeys}) => {
const hideWorkflows = ["interoperability"];
if (!providers || providers.length === 0) {
return
No providers configured for this method yet — add a
providers list to its entry in{" "}
snippets/payment-methods/data.mdx.
;
}
const display = value => value === true ? "✔" : value === false ? "✖" : value === "pending" ? "⏳" : value === null || value === undefined ? "N/A" : value;
return
| Workflow |
{providers.map(p =>
{p.name}
| )}
{workflowKeys.filter(w => !hideWorkflows.includes(w.key.toLowerCase())).map(w =>
|
{w.href ? {w.label} : w.label}
|
{providers.map(p =>
{display(p.workflows && p.workflows[w.key])}
| )}
)}
;
};
export const SupportedCountriesTable = ({countries, continents, method, merchant = false}) => {
const flagFor = code => code.toUpperCase().replace(/./g, ch => String.fromCodePoint(ch.charCodeAt(0) + 127397));
if (!countries || countries.length === 0) {
return
No countries configured for this method yet — add an entry
to snippets/payment-methods/data.mdx.
;
}
const byContinent = {};
for (const continent of continents) {
byContinent[continent] = [];
}
for (const country of countries) {
if (!byContinent[country.continent]) {
byContinent[country.continent] = [];
}
byContinent[country.continent].push(country);
}
const rows = continents.map(continent => ({
continent,
list: (byContinent[continent] || []).slice().sort((a, b) => a.name.localeCompare(b.name))
})).filter(row => row.list.length > 0);
const description = merchant ? `Merchants based in the following regions can accept ${method} payments:` : `${method} is available to customers based in:`;
return
{method &&
{description}
}
| Region(s) |
Countries |
{rows.map(row =>
|
{row.continent}
|
{row.list.map(c =>
{flagFor(c.code)} {c.name}
)}
|
)}
dLocal
Konbini via dLocal
Worldpay
Konbini via Worldpay
## Compare PSPs
Save Instruments and merchant-initiated transactions (MIT) aren't available for Konbini. The customer pays every payment in person.
## Ways to integrate Konbini
* **Payrails SDK:** the [Web SDK](/docs/orchestration/checkout-sdks/web) shows Konbini when your workflow returns it as a payment option, and redirects the customer to the payment code page. To control how the redirect opens, listen for the [`actionRequired` event](/docs/orchestration/checkout-sdks/web/guides/action-required-event).
* **Payrails API:** call [lookup payment options](/docs/orchestration/payment-acceptance/lookup-payment-options), then authorize with `konbini` as the `paymentMethodCode`. Each PSP guide lists the `meta` fields that PSP requires.
In both cases, confirm the final result through [webhook notifications](/docs/orchestration/payment-acceptance/receive-notifications) or the execution status. A customer who returns to your site hasn't paid yet, so wait for the result before you ship the order.
## Related topics
- [Konbini via Worldpay](/docs/orchestration/payment-methods/konbini/worldpay.md)
- [Konbini via dLocal](/docs/orchestration/payment-methods/konbini/dlocal.md)
- [Create a new Ruleset](/reference/createruleset.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.