Konbini

Features
Method	Async - POST Redirect
Merchant countries	Hong Kong
Consumer Countries	Japan
Processing currencies	JPY
Increments	-
Captures	-
Partial/Multiple partial captures	-
Cancels	-
Partial/Multiple partial cancels	-
Refunds	-
Partial/Multiple partial refunds	-
Recurring	-
Installments	-
Credits	-
Disputes	-
Min Amount	1
Account verification	-

Konbini is a payment service that allows end users to purchase items and services at major convenience stores across Japan using the information issued upon the purchase.

Payment flow

Payment

Request

{
    "processingAccountId": "2HdN2jq6XWmlkhqRC2gDTNYCvNH",
    "merchantReference": "c5211d6b-0178-49f8-a06b-69df097a712f",
    "amount": {
        "value": 200,
        "currency": "jpy"
    },
    "paymentMethod": {
        "type": "konbini",
        "konbini": {
            "returnUrl": "https://merchant.site/complete-payment"
         }
    }
}

Response

{
    "id": "27yiW9MgzBtwiodreuNOXk0rtIw",
    "merchantReference": "c5211d6b-0178-49f8-a06b-69df097a712f",
    "status": "pending",
    "trackingUrl": "/v1/tracks/payments/{trackId}",
    "reason": {
        "code": "required_next_step",
        "description": "An additional step is needed to complete the payment."
    },
    "nextStep": {
        "type": "redirect",
        "redirect": {
            "method": "post",
            "url": "https://payment.method/complete",
            "params": [
                {
                    "name": "pay_method",
                    "value": "webcvs"
                },
                {
                    "name": "merchant_id",
                    "value": "99999"
                },
                {
                    "name": "service_id",
                    "value": "000"
                },
                {
                    "name": "cust_code",
                    "value": "27yiW9MgzBtwiodreuNOXk0rtIw"
                },
                {
                    "name": "order_id",
                    "value": "27yiW9MgzBtwiodreuNOXk0rtIw"
                },
                {
                    "name": "item_id",
                    "value": "27yiW9MgzBtwiodreuNOXk0rtIw"
                },
                {
                    "name": "amount",
                    "value": "200"
                },
                {
                    "name": "pay_type",
                    "value": "0"
                },
                {
                    "name": "service_type",
                    "value": "0"
                },
                {
                    "name": "success_url",
                    "value": "https://merchant.site/complete-payment"
                },
                {
                    "name": "cancel_url",
                    "value": "https://merchant.site/complete-payment"
                },
                {
                    "name": "error_url",
                    "value": "https://merchant.site/complete-payment"
                },
                {
                    "name": "pagecon_url",
                    "value": "https://merchant.site/complete-payment"
                },
                {
                    "name": "request_date",
                    "value": "20251113004457"
                },
                {
                    "name": "limit_second",
                    "value": "600"
                },
                {
                    "name": "sps_hashcode",
                    "value": "925A6E17DC937C3C1D277BADE05322DBXXXXXXXX"
                }
            ]
        }
    }
}