Skip to main content

Use Konbini

Last updated: 24-Sep-2021
Rate this article:


Place an order with catalog products defined in your Control Panel and collect the payment using Konbini.


Shoppers in Japan can purchase using Konbini. The billing country and the order country code has to be JP.

Supported currencies

Konbini supports JPY transactions.


  1. If the shopper is located in Japan and is paying in Japanese Yens, then in the shopping cart they can choose Konbini as a payment method.
  2. In the checkout form, it is mandatory to fill in the phone number in the billing details.
  3. After the order is generated by calling the placeOrder method, in the order's details the shopper will find a URL where they need to be redirected in order to finalize the payment.
  4. The URL can be found in the PaymentMethod response object. Also, a PaymentReference number is returned on the same level; this will contain the reference number of the payment in the Konbini system.
  5. Once the shopper finishes the payment process on the Konbini side, the order will be updated in the 2Checkout system as well.


Parameters Type/Description


Required (string)


Session identifier, the output of the Login method. Include sessionID into all your requests. 2Checkout throws an exception if the values are incorrect.  The sessionID expires in 10 minutes.


Required (Object)


Object designed to collect all data necessary for an order, including billing, product/subscription plan and payment details.

See code sample for more details. 

Request Example


require ('PATH_TO_AUTH');

$CartObj = new stdClass();
$CartObj->Currency = JPY;
$CartObj->Language = "EN";
$CartObj->Country =  "JP";
$CartObj->CountryCode = "JP";
$CartObj->CustomerIP = '';
$CartObj->Source = "";
$CartObj->LocalTime = date('Y-m-d H:i:s');
$CartObj->CustomerReference = '421820999';
$CartObj->Items = array();
$CartObj->Items[0] = new stdClass();
$CartObj->Items[0]->Code = "151D8D2C20";
$CartObj->Items[0]->Quantity = 1;
$CartObj->Items[0]->PriceOptions = [];
$priceOption = new stdClass();
$priceOption->Name = 'Users';
$priceOption->Code = 'USERS_1';
$priceOption->Options = [];
$priceOptionOption = new stdClass();
$priceOptionOption->Name = '10 users';
$priceOptionOption->Value = '10_users';
$priceOptionOption->Surcharge = 0;
$priceOption->Options[] = $priceOptionOption;
$CartObj->Items[0]->PriceOptions[] = $priceOption;
$priceOption2 = new stdClass();
$priceOption2->Name = 'Maintenance period';
$priceOption2->Code = 'MAINTE_PERIOD';
$priceOption2->Options = [];
$priceOptionOption2 = new stdClass();
$priceOptionOption2->Name = '12 months';
$priceOptionOption2->Value = 'jira_maintenance_12_mths';
$priceOptionOption2->Surcharge = 0;
$priceOption2->Options[] = $priceOptionOption2;
$CartObj->Items[0]->PriceOptions[] = $priceOption2;
$CartObj->MachineId = 'machineIdTestDan';
$CartObj->Discount = null;
$CartObj->ExternalReference = null;

$CartObj->BillingDetails = new stdClass();
$CartObj->BillingDetails->IsCompany = false;
$CartObj->BillingDetails->Address1 = 'Hirohito Blvd 23';
$CartObj->BillingDetails->Address2 = 'floor 5';
$CartObj->BillingDetails->City = 'Osaka';
$CartObj->BillingDetails->State = '';
$CartObj->BillingDetails->CountryCode = 'JP';
$CartObj->BillingDetails->Phone = '80-1234-5678';
$CartObj->BillingDetails->Email = '';
$CartObj->BillingDetails->FirstName = 'Hitomi';
$CartObj->BillingDetails->LastName = 'Tanaka';
$CartObj->BillingDetails->Zip = '223343';

$CartObj->DeliveryDetails = new stdClass();
$CartObj->DeliveryDetails->Address1 = 'Hirohito Blvd 23';
$CartObj->DeliveryDetails->Address2 = 'floor 5';
$CartObj->DeliveryDetails->City = 'Osaka';
$CartObj->DeliveryDetails->State = '';
$CartObj->DeliveryDetails->CountryCode = 'JP';
$CartObj->DeliveryDetails->Phone = '80-1234-5678';
$CartObj->DeliveryDetails->Email = '';
$CartObj->DeliveryDetails->FirstName = 'Hitomi';
$CartObj->DeliveryDetails->LastName = 'Tanaka';
$CartObj->DeliveryDetails->Zip = '223343';
$CartObj->PaymentDetails = new stdClass();
$CartObj->PaymentDetails->Type = "KONBINI";
$CartObj->PaymentDetails->Currency = 'JPY';
$CartObj->PaymentDetails->CustomerIP = '';

$CartObj->PaymentDetails->PaymentMethod = new stdClass();
$CartObj->PaymentDetails->PaymentMethod->RecurringEnabled = false;

$jsonRpcRequest = array (
'method' => 'placeOrder',
'params' => array($sessionID, $Order),
'id' => $i++,
'jsonrpc' => '2.0'

$output = callRPC($jsonRpcRequest, $host);


Response Example

Parameter Type/Description

Order information


  Object containing order information.


Rate this article:

Need help?

Do you have a question? If you didn’t find the answer you are looking for in our documentation, you can contact our Support teams for more information. If you have a technical issue or question, please contact us. We are happy to help.

Not yet a Verifone customer?

We’ll help you choose the right payment solution for your business, wherever you want to sell, in-person or online. Our team of experts will happily discuss your needs.

Verifone logo