Skip to main content

PaysafeCash Customer Takeover Data

Customer data sent by the merchant so that the registration form in the barcode application is prefilled.

first_name, last_name, date_of_birth, address1, postcode, city, country_iso2, phone_number and email make up the basic Customer Takeover Data feature. The merchant is obliged to obtain the customer's consent before sending them, and PaysafeCash does not store this data.

The remaining fields are the KYC and KYB reliance parameters. Send them only when the KYC reliance, KYB reliance or KYB SME reliance feature is used, in which case the basic parameters above become mandatory as well.

first_namestring

Customer first name.

Possible values: <= 80 characters

Example: Max
last_namestring

Customer last name.

Possible values: <= 80 characters

Example: Mustermann
date_of_birthstring<date>

Customer date of birth in ISO 8601 format (YYYY-MM-DD).

Example: 1990-12-31
address1string

Customer address line.

Possible values: <= 105 characters

Example: Musterstrasse 2
postcodestring

Customer postal code.

Possible values: <= 10 characters

Example: 1234
citystring

Customer city.

Possible values: <= 80 characters

Example: Vienna
country_iso2string

Two-letter ISO 3166-1 country code.

Possible values: >= 2 characters and <= 2 characters, Value must match regular expression ^[A-Z]{2}$

Example: AT
phone_numberstring

Customer phone number including international calling code.

Possible values: <= 19 characters

Example: +43676123456789
emailstring<email>

Customer email address.

Possible values: <= 80 characters

Example: example@test.at
document object
id_numberstring

Document identification number.

Possible values: <= 80 characters

Example: 8010369012345
typestring

Document type.

Possible values: [PASSPORT, ID_CARD, RESIDENCE_CARD, DRIVING_LICENSE]

Example: PASSPORT
issuing_authoritystring

Authority that issued the document.

Possible values: <= 80 characters

Example: Passport Service Paris
date_of_issuancestring<date>

Document issuance date in ISO 8601 format (YYYY-MM-DD).

Example: 2010-12-31
date_of_expirystring<date>

Document expiry date in ISO 8601 format (YYYY-MM-DD).

Example: 2030-12-31
tax_idstring

Customer tax identifier. Mandatory in Italy.

Possible values: <= 40 characters

Example: 1NTEST01SGxo9HZ
place_of_birthstring

Customer place of birth.

Possible values: <= 80 characters

Example: Versaille
kyc_levelstring

Customer KYC level.

Possible values: [SIMPLE, FULL]

Example: FULL
kyc_reliance_typestring

KYC or KYB reliance type.

Possible values: <= 21 characters, [KYC_RELIANCE, OPTIONAL_KYC_RELIANCE, KYB_RELIANCE, KYB_SME_RELIANCE]

Example: KYB_SME_RELIANCE
ip_addressstring

Customer IP address.

Possible values: <= 45 characters

Example: 127.0.0.1
geo_information object
latstring

Latitude coordinate.

Possible values: <= 8 characters

Example: 48.42111
lngstring

Longitude coordinate.

Possible values: <= 8 characters

Example: 16.21466
mccstring

Merchant category code. Required for KYB reliance flows.

Possible values: <= 4 characters

Example: 5551
PaysafeCash Customer Takeover Data
{
  "first_name": "Max",
  "last_name": "Mustermann",
  "date_of_birth": "1990-12-31",
  "address1": "Musterstrasse 2",
  "postcode": "1234",
  "city": "Vienna",
  "country_iso2": "AT",
  "phone_number": "+43676123456789",
  "email": "example@test.at",
  "document": {
    "id_number": "8010369012345",
    "type": "PASSPORT",
    "issuing_authority": "Passport Service Paris",
    "date_of_issuance": "2010-12-31",
    "date_of_expiry": "2030-12-31"
  },
  "tax_id": "1NTEST01SGxo9HZ",
  "place_of_birth": "Versaille",
  "kyc_level": "FULL",
  "kyc_reliance_type": "KYB_SME_RELIANCE",
  "ip_address": "127.0.0.1",
  "geo_information": {
    "lat": "48.42111",
    "lng": "16.21466"
  },
  "mcc": "5551"
}