Market specifications

Do you want to know more information about Japan's market? Go to the APAC: The world’s leader in eCommerce market sales article.

Country reference

`country` code	`currency` code	`document` name	`document` format	`document` required?
`JP`	`JPY`	My Number (マイナンバー)	12 digits	No

Alternative Payment Method supported

`payment_method_id`	Name	`payment_method_type`	Details	Allowed Flows	Logo
`DP`	Pay-easy	`BANK_TRANSFER`	Bank Transfer	`REDIRECT`
`KB`	Konbini	`TICKET`	Cash Payment	`REDIRECT`

Alternative Payment Method

Pay-easy

Payeasy is a local banking service that is connected to Japan's nationwide ATM network and online banking network.

This allows customers to either pay through ATMs (Cash) or via online banking, whichever is most convenient.

Capabilities

	Pay-easy
Min. amount	2 JPY
Max. expiration time supported	5 days
Notification delay	Immediate
Refunds	Yes
Flow	`REDIRECT`

UX Flow

The screenshots illustrate a generic Pay-easy redirect flow choosing pay at an ATM.

Request parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged.	Yes
`currency`	String	`JPY` Transaction currency in ISO 4217.	Yes
`country`	String	`JP` Transaction country in ISO 3166.	Yes
`payment_method_id`	String	`DP` ID of the selected payment method.	Yes
`payment_method_flow`	String	`REDIRECT`	Yes
`payer.name`	String	Name of the payer.	Yes
`payer.email`	String	Email of the payer.	Yes
`payer.document`	Number	Document of the payer.	No
`payer.phone`	Number	Phone number of the payer.	Yes
`payer.account_number`	Number	Unique identifier for the Alfa Wallet Account.	Yes
`order_id`	Number	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	No

Examples

{
     "amount": 10,
     "currency": "JPY",
     "country": "JP",
     "payment_method_id": "DP",
     "payment_method_flow": "REDIRECT",
     "payer": {
         "name": "Jane Doe",
         "email": "[email protected]",
         "document": "1234567890123",
         "phone": "08074648897011",
         "address": {
             "country": "JP",
             "state": "Kyoto",
             "city": "Kyoto",
             "zip_code": "8858",
             "street": "Main St.",
             "number": "540"
         }
     },
     "order_id": "345453483kqws",
     "description": "Tshirt",
     "notification_url": "http://merchantsite.com/notification/new",
     "callback_url": "http://merchantsite.com/success_page"
 }

{
    "id": "R-4-fd30a798-86e0-4544-5tr4-291c9a5551bb",
    "amount": 10,
    "currency": "JPY",
    "payment_method_id": "DP",
    "payment_method_type": "TICKET",
    "payment_method_flow": "REDIRECT",
    "country": "JP",
    "created_date": "2023-08-18T15:08:15.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "345453483ksadqws",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "redirect_url": "https://pay.dlocal.com/gmf-apm/payments-redirect/M-713d8040-f20e-erd2-b120-6d1f41fd8605"
}

Konbini

Konbini (convenience store) payments have gained significant popularity as a preferred method for cash transactions in Japan. These payments facilitate e-commerce transactions within a culture that highly values the security and trust associated with cash transactions.

Through Konbini payments, individuals in Japan have the ability to engage in online purchases and settle payments using cash.

Capabilities

	Konbini
Min. amount	2 JPY
Max. expiration time supported	5 days
Notification delay	Immediate
Refunds	Yes
Flow	`REDIRECT`

UX Flow

The screenshots illustrate a generic Konbini redirect flow choosing Lawson as the preferred convenience store.

Request parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged.	Yes
`currency`	String	`JPY` Transaction currency in ISO 4217.	Yes
`country`	String	`JP` Transaction country in ISO 3166.	Yes
`payment_method_id`	String	`KB` ID of the selected payment method.	Yes
`payment_method_flow`	String	`REDIRECT`	Yes
`payer.name`	String	Name of the payer.	Yes
`payer.email`	String	Email of the payer.	Yes
`payer.document`	Number	Document of the payer.	No
`payer.phone`	Number	Phone number of the payer.	Yes
`payer.account_number`	Number	Unique identifier for the Alfa Wallet Account.	Yes
`order_id`	Number	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	No

Examples

 {
     "amount": 10,
     "currency": "JPY",
     "country": "JP",
     "payment_method_id": "KB",
     "payment_method_flow": "REDIRECT",
     "payer": {
         "name": "Jane Doe",
         "email": "[email protected]",
         "document": "1234567890123",
         "phone": "08074648897011",
         "address": {
             "country": "JP",
             "state": "Kyoto",
             "city": "Kyoto",
             "zip_code": "8858",
             "street": "Main St.",
             "number": "540"
         }
     },
     "order_id": "345453483kqws",
     "description": "Tshirt",
     "notification_url": "http://merchantsite.com/notification/new",
     "callback_url": "http://merchantsite.com/success_page"
 }

 {
     "id": "R-4-89f9e460-4re3-4977-9dfd-aa15e7007e95",
     "amount": 10,
     "currency": "JPY",
     "payment_method_id": "KB",
     "payment_method_type": "TICKET",
     "payment_method_flow": "REDIRECT",
     "country": "JP",
     "created_date": "2023-08-18T13:12:39.000+0000",
     "status": "PENDING",
     "status_detail": "The payment is pending.",
     "status_code": "100",
     "order_id": "345453483kqws",
     "description": "Tshirt",
     "notification_url": "http://merchantsite.com/notification/new",
     "redirect_url": "https://pay.dlocal.com/gmf-apm/payments-redirect/M-5599a895-004d-543s-9340-4fb4b60fa7ff"
 }