# 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 Worldpay 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

Personal cards

```json
{
  "$ref": "#/components/schemas/southKorea_personalAuth",
  "components": {
    "schemas": {
      "southKorea_personalAuth": {
        "required": [
          "type",
          "firstTwoOfPin",
          "dateOfBirth"
        ],
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Personal card issued in South Korea.",
            "enum": [
              "southKorea/personal"
            ]
          },
          "firstTwoOfPin": {
            "type": "string",
            "description": "The first two characters of the card's PIN.",
            "minLength": 2,
            "maxLength": 2,
            "example": "34",
            "pattern": "^[0-9]{2}$"
          },
          "dateOfBirth": {
            "type": "object",
            "description": "Cardholder's date of birth.",
            "required": [
              "day",
              "month",
              "year"
            ],
            "properties": {
              "day": {
                "type": "integer",
                "example": 1
              },
              "month": {
                "type": "integer",
                "example": 1
              },
              "year": {
                "type": "integer",
                "example": 1900
              }
            }
          }
        }
      }
    }
  }
}
```

Corporate cards

```json
{
  "$ref": "#/components/schemas/southKorea_corporateAuth",
  "components": {
    "schemas": {
      "southKorea_corporateAuth": {
        "required": [
          "firstTwoOfPin",
          "businessRegistrationNumber",
          "type"
        ],
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Corporate card issued in South Korea.",
            "enum": [
              "southKorea/corporate"
            ]
          },
          "firstTwoOfPin": {
            "type": "string",
            "description": "The first two characters of the card's PIN.",
            "minLength": 2,
            "maxLength": 2,
            "example": "34",
            "pattern": "^[0-9]{2}$"
          },
          "businessRegistrationNumber": {
            "type": "string",
            "description": "A unique identifier assigned to businesses when they register with the Korean tax authorities.",
            "minLength": 6,
            "maxLength": 10
          }
        }
      }
    }
  }
}
```

## Code example


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