API Overview Resources Schemas

Schemas

DeviceSwapDeviceSwapInfo

1
2
3


{
  "latestDeviceChange": "2023-07-03T14:27:08.312+02:00"
}

Name	Type	Required	Description
latestDeviceChange	string(date-time)¦null	true	Timestamp of latest device swap performed. It must follow RFC 3339 and must have time zone. Recommended format is yyyy-MM-dd’T’HH:mm:ss.SSSZ (i.e. which allows 2023-07-03T14:27:08.312+02:00 or 2023-07-03T12:27:08.312Z)

DeviceSwapCreateDeviceSwapDate

1
2
3


{
  "phoneNumber": "+34666111333"
}

Name	Type	Required	Description
phoneNumber	DeviceSwapPhoneNumber	true	A public identifier addressing a telephone subscription. In mobile networks it corresponds to the MSISDN (Mobile Station International Subscriber Directory Number). In order to be globally unique it has to be formatted in international format, according to E.164 standard, prefixed with ‘+’.

DeviceSwapCreateCheckDeviceSwap

1
2
3
4


{
  "phoneNumber": "+34666111333",
  "maxAge": 240
}

Name	Type	Required	Description
phoneNumber	DeviceSwapPhoneNumber	true	A public identifier addressing a telephone subscription. In mobile networks it corresponds to the MSISDN (Mobile Station International Subscriber Directory Number). In order to be globally unique it has to be formatted in international format, according to E.164 standard, prefixed with ‘+’.
maxAge	integer(int32)	false	Period in hours to be checked for device swap.

DeviceSwapPhoneNumber

1

"+34666111333"

Name	Type	Required	Description
anonymous	string	false	A public identifier addressing a telephone subscription. In mobile networks it corresponds to the MSISDN (Mobile Station International Subscriber Directory Number). In order to be globally unique it has to be formatted in international format, according to E.164 standard, prefixed with ‘+’.

DeviceSwapCheckDeviceSwapInfo

1
2
3


{
  "swapped": true
}

Name	Type	Required	Description
swapped	boolean	true	Indicates whether the device has been swapped during the period within the provided age.

DeviceSwapApiError

1
2
3
4
5
6


{
  "code": "string",
  "title": "string",
  "ref": "string",
  "details": "string"
}

Name	Type	Required	Description
code	string	true	code of the error
title	string	true	title of the error
ref	string	true	ref of the error
details	string	true	details of the error

KycMatchSafeString

1

"string"

Name	Type	Required	Description
anonymous	string	false	none

KycMatchKYC_MatchRequestBody

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


{
  "phoneNumber": "+123456789",
  "idDocument": "string",
  "name": "string",
  "givenName": "string",
  "familyName": "string",
  "nameKanaHankaku": "string",
  "nameKanaZenkaku": "string",
  "middleNames": "string",
  "familyNameAtBirth": "string",
  "address": "string",
  "streetName": "string",
  "streetNumber": "string",
  "postalCode": "string",
  "region": "string",
  "locality": "string",
  "country": "ES",
  "houseNumberExtension": "string",
  "birthdate": "2019-08-24",
  "email": "string",
  "gender": "MALE"
}

Name	Type	Required	Description
phoneNumber	string	false	A public identifier addressing a telephone subscription. In mobile networks it corresponds to the MSISDN (Mobile Station International Subscriber Directory Number). In order to be globally unique it has to be formatted in international format, according to E.164 standard, prefixed with ‘+’.
idDocument	KycMatchSafeString	false	Id number associated to the official identity document in the country. It may contain alphanumeric characters.
name	KycMatchSafeString	false	Complete name of the customer, usually composed of first/given name and last/family/sur- name in a country. Depending on the country, the order of first/give name and last/family/sur- name varies, and middle name could be included. It can use givenName, middleNames, familyName and/or familyNameAtBirth. For example, in ESP, name+familyName; in NLD, it can be name+middleNames+familyName or name+middleNames+familyNameAtBirth, etc.
givenName	KycMatchSafeString	false	First/given name or compound first/given name of the customer.
familyName	KycMatchSafeString	false	Last name, family name, or surname of the customer.
nameKanaHankaku	KycMatchSafeString	false	Complete name of the customer in Hankaku-Kana format (reading of name) for Japan.
nameKanaZenkaku	KycMatchSafeString	false	Complete name of the customer in Zenkaku-Kana format (reading of name) for Japan.
middleNames	KycMatchSafeString	false	Middle name/s of the customer.
familyNameAtBirth	KycMatchSafeString	false	Last/family/sur- name at birth of the customer.
address	KycMatchSafeString	false	Complete billingAddress of the customer. For some countries, it is built following the usual concatenation of parameters in a country, but for other countries, this is not the case. For some countries, it can use streetName, streetNumber and/or houseNumberExtension. For example, in ESP, streetName+streetNumber; in NLD, it can be streetName+streetNumber or streetName+streetNumber+houseNumberExtension.
streetName	KycMatchSafeString	false	Name of the street of the customer’s billingAddress. It should not include the type of the street.
streetNumber	KycMatchSafeString	false	The street number of the customer’s billingAddress. Number identifying a specific property on the ‘streetName’.
postalCode	KycMatchSafeString	false	Zip code or postal code
region	KycMatchSafeString	false	Region/prefecture of the customer’s billingAddress
locality	KycMatchSafeString	false	Locality of the customer’s billingAddress
country	KycMatchSafeString	false	Country of the customer’s billingAddress. Format ISO 3166-1 alpha-2
houseNumberExtension	KycMatchSafeString	false	Specific identifier of the house needed depending on the property type. For example, number of apartment in an apartment building.
birthdate	string(date)	false	The birthdate of the customer, in RFC 3339 / ISO 8601 calendar date format (YYYY-MM-DD).
email	KycMatchSafeString(email)	false	Email billingAddress of the customer in the RFC specified format (local-part@domain).
gender	string	false	Gender of the customer (Male/Female/Other).

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Name	Type	Required	Description
anonymous	object	false	none

Property	Values
gender	one of [MALE, FEMALE, OTHER]

KycMatchMatchResult

1

"true"

Name	Type	Required	Description
anonymous	string	false	none

Property	Values
anonymous	one of [true, false, not_available]

KycMatchMatchScoreResult

1

100

Name	Type	Required	Description
anonymous	integer	false	Indicates the similarity score assigned to the input value when it does not exactly match the value stored in the operator’s system. This property shall only be returned when the value of the corresponding match field is `false`.

KycMatchKYC_MatchResponse

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34


{
  "idDocumentMatch": "true",
  "nameMatch": "true",
  "nameMatchScore": 100,
  "givenNameMatch": "true",
  "givenNameMatchScore": 100,
  "familyNameMatch": "true",
  "familyNameMatchScore": 100,
  "nameKanaHankakuMatch": "true",
  "nameKanaHankakuMatchScore": 100,
  "nameKanaZenkakuMatch": "true",
  "nameKanaZenkakuMatchScore": 100,
  "middleNamesMatch": "true",
  "middleNamesMatchScore": 100,
  "familyNameAtBirthMatch": "true",
  "familyNameAtBirthMatchScore": 100,
  "addressMatch": "true",
  "addressMatchScore": 100,
  "streetNameMatch": "true",
  "streetNameMatchScore": 100,
  "streetNumberMatch": "true",
  "streetNumberMatchScore": 100,
  "postalCodeMatch": "true",
  "regionMatch": "true",
  "regionMatchScore": 100,
  "localityMatch": "true",
  "localityMatchScore": 100,
  "countryMatch": "true",
  "houseNumberExtensionMatch": "true",
  "birthdateMatch": "true",
  "emailMatch": "true",
  "emailMatchScore": 100,
  "genderMatch": "true"
}

Name	Type	Required	Description
idDocumentMatch	KycMatchMatchResult	false	Indicates whether Id number associated to the ID document of the customer matches with the one on the Operator’s system.
nameMatch	KycMatchMatchResult	false	Indicates whether the complete name of the customer matches with the one on the Operator’s system.
nameMatchScore	KycMatchMatchScoreResult	false	Indicates the similarity score assigned to the input value when it does not exactly match the value stored in the operator’s system. This property shall only be returned when the value of the corresponding match field is `false`.
givenNameMatch	KycMatchMatchResult	false	Indicates whether First name/given name of the customer matches with the one on the Operator’s system.
givenNameMatchScore	KycMatchMatchScoreResult	false	Indicates the similarity score assigned to the input value when it does not exactly match the value stored in the operator’s system. This property shall only be returned when the value of the corresponding match field is `false`.
familyNameMatch	KycMatchMatchResult	false	Indicates whether last name/ family name/ surname of the customer matches with the one on the Operator’s system.
familyNameMatchScore	KycMatchMatchScoreResult	false	Indicates the similarity score assigned to the input value when it does not exactly match the value stored in the operator’s system. This property shall only be returned when the value of the corresponding match field is `false`.
nameKanaHankakuMatch	KycMatchMatchResult	false	Indicates whether complete name of the customer in Hankaku-Kana format (reading of name) for Japan matches with the one on the Operator’s system.
nameKanaHankakuMatchScore	KycMatchMatchScoreResult	false	Indicates the similarity score assigned to the input value when it does not exactly match the value stored in the operator’s system. This property shall only be returned when the value of the corresponding match field is `false`.
nameKanaZenkakuMatch	KycMatchMatchResult	false	Indicates whether complete name of the customer in Zenkaku-Kana format (reading of name) for Japan matches with the one on the Operator’s system.
nameKanaZenkakuMatchScore	KycMatchMatchScoreResult	false	Indicates the similarity score assigned to the input value when it does not exactly match the value stored in the operator’s system. This property shall only be returned when the value of the corresponding match field is `false`.
middleNamesMatch	KycMatchMatchResult	false	Indicates whether the middle names of the customer matches with the one on the Operator’s system.
middleNamesMatchScore	KycMatchMatchScoreResult	false	Indicates the similarity score assigned to the input value when it does not exactly match the value stored in the operator’s system. This property shall only be returned when the value of the corresponding match field is `false`.
familyNameAtBirthMatch	KycMatchMatchResult	false	Indicates whether the Family Name At Birth of the customer matches with the one on the Operator’s system.
familyNameAtBirthMatchScore	KycMatchMatchScoreResult	false	Indicates the similarity score assigned to the input value when it does not exactly match the value stored in the operator’s system. This property shall only be returned when the value of the corresponding match field is `false`.
addressMatch	KycMatchMatchResult	false	Indicates whether complete billingAddress of the customer matches with the one on the Operator’s system.
addressMatchScore	KycMatchMatchScoreResult	false	Indicates the similarity score assigned to the input value when it does not exactly match the value stored in the operator’s system. This property shall only be returned when the value of the corresponding match field is `false`.
streetNameMatch	KycMatchMatchResult	false	Indicates whether the street name of the customer matches with the one on the Operator’s system.
streetNameMatchScore	KycMatchMatchScoreResult	false	Indicates the similarity score assigned to the input value when it does not exactly match the value stored in the operator’s system. This property shall only be returned when the value of the corresponding match field is `false`.
streetNumberMatch	KycMatchMatchResult	false	Indicates whether the street number of the customer matches with the one on the Operator’s system.
streetNumberMatchScore	KycMatchMatchScoreResult	false	Indicates the similarity score assigned to the input value when it does not exactly match the value stored in the operator’s system. This property shall only be returned when the value of the corresponding match field is `false`.
postalCodeMatch	KycMatchMatchResult	false	Indicates whether the postal code / zip code of the customer matches with the one on the Operator’s system.
regionMatch	KycMatchMatchResult	false	Indicates whether the region of the customer’s billingAddress matches with the one on the Operator’s system.
regionMatchScore	KycMatchMatchScoreResult	false	Indicates the similarity score assigned to the input value when it does not exactly match the value stored in the operator’s system. This property shall only be returned when the value of the corresponding match field is `false`.
localityMatch	KycMatchMatchResult	false	Indicates whether the locality of the customer’s billingAddress matches with the one on the Operator’s system.
localityMatchScore	KycMatchMatchScoreResult	false	Indicates the similarity score assigned to the input value when it does not exactly match the value stored in the operator’s system. This property shall only be returned when the value of the corresponding match field is `false`.
countryMatch	KycMatchMatchResult	false	Indicates whether the country of the customer’s billingAddress matches with the one on the Operator’s system.
houseNumberExtensionMatch	KycMatchMatchResult	false	Indicates whether the house number extension of the customer’s billingAddress matches with the one on the Operator’s system.
birthdateMatch	KycMatchMatchResult	false	Indicates whether the birthdate of the customer matches with the one on the Operator’s system.
emailMatch	KycMatchMatchResult	false	Indicates whether the email billingAddress of the customer matches with the one on the Operator’s system.
emailMatchScore	KycMatchMatchScoreResult	false	Indicates the similarity score assigned to the input value when it does not exactly match the value stored in the operator’s system. This property shall only be returned when the value of the corresponding match field is `false`.
genderMatch	KycMatchMatchResult	false	Indicates whether the gender of the customer matches with the one on the Operator’s system.

KycMatchApiError

1
2
3
4
5
6


{
  "code": "string",
  "title": "string",
  "ref": "string",
  "details": "string"
}

Name	Type	Required	Description
code	string	true	code of the error
title	string	true	title of the error
ref	string	true	ref of the error
details	string	true	details of the error