Skip to content

Toss Pay

Toss Pay is a digital payment service enabling domestic South Korean payments and allowing users to make secure, fast, and convenient online and offline payments using their mobile devices. It streamlines the checkout process by allowing one-tap payments and supports various payment methods, including cards and bank transfers.

You can use Access Worldpay to submit Toss Pay payments as long as you are on-boarded with Toss Pay and adhere to the authentication requirements of South Korean payments.

Local authentication standards require cardholders to authenticate their eCommerce payments with the first two characters of their card's PIN and either their date of birth (for personal cards) or the Business Registration Number (for corporate cards).

Prerequisite

Please contact your Implementation Manager to enable Toss Pay.

Request parameters

You can submit these fields in the authentication.customerData object for the Customer Initiated Transactions and with card/plain, card/token and card/checkout instruments only.

Personal cards and corporate cards

typestringrequired

Personal card issued in South Korea.

Value"southKorea/personal"
firstTwoOfPinstring= 2 charactersrequired

The first two characters of the card's PIN.

Example: "34"
dateOfBirthobjectrequired

Cardholder's date of birth.

dateOfBirth.​dayintegerrequired
Example: 1
dateOfBirth.​monthintegerrequired
Example: 1
dateOfBirth.​yearintegerrequired
Example: 1900

Code example

{
  (...)
  "authentication": {
      "customerData": {
          "type": "southKorea/personal",
          "firstTwoOfPin "23",
          "dateOfBirth": {
            "day": 1,
            "month": 1,
            "year": 2000
          }
      }
  }
  (...)
}