**Last updated**: 06 November 2025 | [**Change log**](/products/apms/changelog/)

# Konbini

The Konbini and Pay-easy payment method is a collection of payment types that customers in Japan can use to shop online.

Note
Make yourself familiar with our [API principles](/products/reference/api-principles) to ensure a resilient integration.

details
summary
Product overview
Your customers can complete their payment with one of the following:

- Offline cash payment at a convenience store (Konbini)
- Offline cash/electronic payment at an ATM (Pay-easy)
- Online electronic payment by internet banking (Pay-easy)


### Feature summary

| Payment type | Country | Currencies | Recurring | Reversals | Partial reversals | Disputes |
|  --- | --- | --- | --- | --- | --- | --- |
| E-Cash | Japan | JPY | ❌ | ❌ | ❌ | ❌ |


- Minimum Transaction Value: 100 JPY
- Maximum Transaction Values:
The maximum amount for a single transaction depends on what payment option the customer chooses. The default limits are:
  - 299.000 JPY at a convenience store
  - 99.000 JPY at an ATM with cash
  - 999.999 JPY at an ATM with a cash card or with internet banking
In addition Internet banks may set their own limits.


## Get started

Get started using our [API reference](/products/apms/openapi) and set your headers.

## Request

`POST` `https://try.access.worldpay.com/apmPayments`

### Example request

### Parameters

## Response

### Successful request response

* an HTTP code `201`
* a `paymentId` which is unique to the payment - we recommend storing the "id", as you can use it to manage the payment later
* a `redirect` to redirect your customer to the APM provider to complete the payment
* an link to query the payment status
* an object which will give flow information such as `method` (e.g. `konbini`) and type (`direct`)
* a `commandId` generated by us identifying a single merchant interaction (e.g. `cmdYNdIHBPJwbkjLiykzTx0`)


### Example response

Successful
{
  "paymentId": "uK9Oh5zz4yKhGuFofhhnC056-K6qn-w8Krt2pRT2oSzwh_KRcHUrrs1qJtQso9gjgJ_wwjT869eMBB_T4PM4D6HdjtgfjDBh7htEkjHxp4Q_KzkRIENkZoejad--FtjVrMslJn1mvz4mwr-TuKlP9ZAhBEzSApkfhL__fXCo-vMkR1a2Zrj_R8rGSgu6m2Wd",
  "lastEvent": "pending",
  "_links": {
    "self": {
      "href": "https://try.access.worldpay.com/apmPayments/uK9Oh5zz4yKhGuFofhhnC056-K6qn-w8Krt2pRT2oSzwh_KRcHUrrs1qJtQso9gjgJ_wwjT869eMBB_T4PM4D6HdjtgfjDBh7htEkjHxp4Q_KzkRIENkZoejad--FtjVrMslJn1mvz4mwr-TuKlP9ZAhBEzSApkfhL__fXCo-vMkR1a2Zrj_R8rGSgu6m2Wd"
    }
  },
  "_actions": {},
  "redirect": "https://secure-test.worldpay.com/jsp/test/shopper/APMSTSimulator.jsp?customerRef=3417843726&paymentMethod=Konbini&country=DE",
  "paymentInstrument": {
    "method": "konbini",
    "type": "direct"
  },
  "commandId": "cmdEy5vwB0krLe9eMwAcE66c0"
}
Error response
{
  "errorName": "bodyDoesNotMatchSchema",
  "message": "The json body provided does not match the expected schema",
  "validationErrors": [
    {
      "errorName": "fieldHasInvalidValue",
      "message": "Field is mandatory",
      "jsonPath": "$.instruction.value.amount"
    }
  ]
}
#### Errors

Check out our API reference for the full [error code schema](/products/apms/openapi/other/payment#other/payment/response&c=400).

**Next steps**

[Manage your Konbini payment](/products/apms/manage/)