Market specifications

Take a look of all the payment methods available.

Country reference Cards supported APM supported

Cards

Find all the information about the card supported capabilities.

Capabilities Process Card Payments

Alternative Payments

Learn how to integrate cash, bank transfer or wallet payment.

Pay-easy Konbini Aozora Bank Transfer auPay dBarai

Market specifications

Do you want to know more information about Japan's market? Go to the Accelerate Growth in Asia’s Leading eCommerce Hubs article.

Country reference

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

Cards supported

`payment_method_id`	Brand ID	Name	`payment_method_type`	Details	Allowed Flows
`CARD`	`VI`	Visa	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`VD`	Visa Debit	`CARD`	Debit Card	`DIRECT` `REDIRECT`
`CARD`	`MC`	Mastercard	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`MD`	Mastercard Debit	`CARD`	Debit Card	`DIRECT` `REDIRECT`
`CARD`	`JC`	JCB	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`AE`	American Express	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`DC`	Diners Club	`CARD`	Credit Card	`DIRECT` `REDIRECT`

ℹ️
To offer all the card options that may be available in your integration, send the payment_method_id as CARD.

Alternative Payment Method supported

`payment_method_id`	Name	`payment_method_type`	Details	Allowed Flows
`DP`	Pay-easy	`BANK_TRANSFER`	Bank Transfer	`REDIRECT`
`KB`	Konbini	`TICKET`	Cash Payment	`REDIRECT`
`IO`	Aozora Bank Transfer	`BANK_TRANSFER`	Bank Transfer	`REDIRECT`
`AY`	auPay	`WALLET`	Wallet	`REDIRECT`
`DO`	dBarai	`WALLET`	Wallet	`REDIRECT`

Cards

Capabilities

	Visa Credit	Visa Debit	Mastercard Credit	Mastercard Debit	JCB	American Express	Diners Club
Minimum amount	1 JPY	1 JPY	1 JPY	1 JPY	1 JPY	1 JPY	1 JPY
Refunds	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Recurring	No	No	No	No	No	No	No
Chargeback option	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Chargeback Dispute option	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Descriptor	Merchant name	Merchant name	Merchant name	Merchant name	Merchant name	Merchant name	Merchant name

How to process Card Payments?

Learn how to process payments with credit and debit cards with dLocal in our Card Payments section.

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
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`	String	Document of the payer.	No
`payer.phone`	String	Phone number of the payer.	Yes
`order_id`	String	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": "123456789012",
         "phone": "09012944679",
         "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
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`	String	Document of the payer.	Yes
`payer.phone`	String	Phone number of the payer.	Yes
`order_id`	String	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": "123456789012",
         "phone": "09012944679",
         "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"
 }

Aozora Bank Transfer

Aozora Bank Transfer is a bank transfer payment method in Japan that allows customers to complete their purchase through their own online or mobile banking using a redirect flow.

Capabilities

	Aozora Bank Transfer
Min. amount	1 JPY
Max. expiration time supported	1 to 999 days
Notification delay	Immediate
Refunds	Yes
Flow	`REDIRECT`

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	`IO` 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`	String	Document of the payer.	Yes
`order_id`	String	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": "IO",
  "payment_method_flow": "REDIRECT",
  "payer": {
    "name": "Jane Doe",
    "email": "[email protected]",
    "document": "123456789012",
    "phone": "09012944679",
    "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": "IO",
     "payment_method_type": "BANK_TRANSFER",
     "payment_method_flow": "REDIRECT",
     "country": "JP",
     "created_date": "2024-07-02T17:49:06.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-4fb4b60fa7aa"
 }

{
  "id": "R-4-89f9e460-4re3-4977-9dfd-aa15e7007e95",
  "amount": 10,
  "status": "PAID",
  "status_detail": "The payment was paid.",
  "status_code": "200",
  "currency": "JPY",
  "country": "JP",
  "payment_method_id": "IO",
  "payment_method_type": "BANK_TRANSFER",
  "payment_method_flow": "REDIRECT",
  "payer": {
    "name": "Jane Doe",
    "email": "[email protected]",
    "document": "123456789012",
    "phone": "09012944679",
    "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",
  "created_date": "2024-07-02T17:49:06.000+0000"
}

Example ticket

Bank Transfer UI built with the information in the example above.

auPay

auPay is a popular mobile wallet service in Japan. It enables customers to make secure and convenient payments using their auPay balance, linked bank account, or credit/debit card.

At checkout, customers simply select auPay, authorize the transaction via the auPay app, and the payment is completed instantly.

Capabilities

	auPay
Min. amount	1 JPY
Max. expiration time supported	5 minutes
Notification delay	Immediate
Flow	`REDIRECT`

UX Flow

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	`AY` 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`	String	Document of the payer.	Yes
`address.country`	String	`JP` Country of the payer.	Yes
`address.state`	String	State of the payer.	Yes
`address.city`	String	City of the payer.	Yes
`address.zip_code`	String	ZIP code of the payer.	Yes
`address.street`	String	Street of the payer.	Yes
`address.number`	String	Street number of the payer.	Yes
`order_id`	String	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`description`	String	Payment description.	Yes
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	Yes

Examples

{
  "amount": 10,
  "currency": "JPY",
  "country": "JP",
  "payment_method_id": "AY",
  "payment_method_flow": "REDIRECT",
  "payer": {
    "name": "Jane Doe",
    "email": "[email protected]",
    "document": "123456789012",
    "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"
}

{
  "id": "R-4-89f9e460-4re3-4977-9dfd-aa15e7007e95",
  "amount": 10,
  "currency": "JPY",
  "payment_method_id": "AY",
  "payment_method_type": "WALLET",
  "payment_method_flow": "REDIRECT",
  "country": "JP",
  "created_date": "2024-07-02T17:49:06.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-4fb4b60fa7aa"
}

dBarai

dBarai is a secure, convenient, and widely used mobile payment method in Japan provided by NTT Docomo. It allows customers to pay directly from their Docomo account or linked credit/debit card, without needing to enter card details at checkout.

During payment, customers simply select dBarai, confirm the transaction through the dBarai app, and the payment is processed instantly.

Capabilities

	dBarai
Min. amount	1 JPY
Max. expiration time supported	5 minutes
Notification delay	Immediate
Flow	`REDIRECT`

UX Flow

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	`DO` 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`	String	Document of the payer.	Yes
`address.country`	String	`JP` Country of the payer.	Yes
`address.state`	String	State of the payer.	Yes
`address.city`	String	City of the payer.	Yes
`address.zip_code`	String	ZIP code of the payer.	Yes
`address.street`	String	Street of the payer.	Yes
`address.number`	String	Street number of the payer.	Yes
`order_id`	String	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`description`	String	Payment description.	Yes
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	Yes

Examples

{
  "amount": 10,
  "currency": "JPY",
  "country": "JP",
  "payment_method_id": "DO",
  "payment_method_flow": "REDIRECT",
  "payer": {
    "name": "Jane Doe",
    "email": "[email protected]",
    "document": "1234567891234567",
    "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"
}

{
  "id": "R-4-89f9e460-4re3-4977-9dfd-aa15e7007e95",
  "amount": 10,
  "currency": "JPY",
  "payment_method_id": "DO",
  "payment_method_type": "WALLET",
  "payment_method_flow": "REDIRECT",
  "country": "JP",
  "created_date": "2024-07-02T17:49:06.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-4fb4b60fa7aa"
}