Exécuter une vérification de l’identité d’un client
POST /customeridentification/v1/identityprofiles
Pour procéder à une vérification de l’identité du client, vous devez lancer une requête POST au point de terminaison des profils d’identité.
Voir notre documentation API complète pour une description détaillée des paramètres requis pour la requête de vérification de l’identité du client.
L’exemple de demande suivant utilise le paramètre vendorCheck.
curl -X POST https://api.test.paysafe.com/customeridentification/v1/identityprofiles \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H ’Content-Type: application/json’ \
-d ’ {
"merchantRefNum": "KYC_1520461749",
"card": {
"cardNum": "4111111111111111",
"cardExpiry": {
"month": 2,
"year": 2019
},
"cvv": 123
},
"profile": {
"firstName":"John",
"lastName" : "Smith",
"email": "john.smith@myemail.com",
"currentAddress": {
"street": "100 Queen Street West",
"street2": "Unit 201",
"city": "Toronto",
"state": "ON",
"country": "CA",
"zip":"M5H2N2","zip": "M5H 2N2","zip": "M5H 2N2",
"monthsAtAddress": "20",
"phone": "647-788-3901"
},
"previousAddresses": [{
"city": "Calgary",
"state": "AB",
"street": "2124 Westchester street",
"street2": "string",
"zip": "M2H 2G6",
"country": "CA",
"monthsAtAddress": "30"
}],
"dateOfBirth": {
"day": "25",
"month": "12",
"year": "1980"
},
"sin": "123456789"
},
"customerIp": "1.1.1.1",
"vendorCheck": "EID_COMPARE"
} '
Avant d’essayer l’exemple, vous devez :
- Fournir un numéro de référence unique pour chaque transaction.
- Remplacer la clé API (après le -u) par la clé API que vous avez reçue.
La requête contient les paramètres suivants :
| Valeur | Type | Requis? | Description |
|---|---|---|---|
| merchantRefNum | string length<=255 | Oui | Il s’agit du numéro de référence du marchand, créé par ce dernier, et soumis dans le cadre de la requête. |
| carte | object | Non | Il s’agit des données de la carte incluses dans la requête. |
| card.cardNum | string longueur=8-20 | Non | Il s’agit du numéro de la carte. Il est requis seulement si l’objet de la carte est inclus dans la requête. |
| card.cardExpiry | object | Non | Il s’agit de la date d’expiration de la carte. Les paramètres suivants sont requis :
|
| card.cvv | string longueur=3-4 | Non | Il s’agit du code de sécurité à 3 ou 4 chiffres qui apparaît sur la carte, après le numéro de carte. |
| profile | complexe | Oui | Il s’agit d’informations personnelles de base sur le client. |
| profile.firstName | string length<=80 | Oui | Il s’agit du prénom du client. |
| profile.lastName | string length<=80 | Oui | Il s’agit du nom de famille du client. |
| profile.email | string length<=255 | Non | Il s’agit de l’adresse courriel du client. |
| profile.sin | string length=9 | Non | Il s’agit du numéro d’assurance sociale du client. |
| profile.currentAddress | object | Oui | Il s’agit de l’adresse actuelle du client. Les paramètres suivants sont requis :
|
| profile.previousAddresses | complexe | Non | Il s’agit d’un ensemble d’adresses antérieures du client. Si monthsAtAddress dans l’objet currentAddress est 24 ou moins, la requête relative à l’identité du client aura plus de chances d’aboutir si une adresse antérieure est mentionnée. |
| profile.dateOfBirth | complexe | Oui | Il s’agit de la date de naissance du client. Les paramètres suivants sont requis :
|
| customerIp | string longueur<=18 | Non | Il s’agit de l’adresse IP du client. |
| vendorCheck | string length<=80 | Oui | Vous devez inclure soit vendorCheck ou workflowId dans la requête, pas les deux. |
Paysafe informera le marchand lorsqu’il décidera d’utiliser ou non le paramètre vendorCheck ou workflowId, ainsi que la valeur à fournir pour le paramètre. Ces informations seront fournies à la fois pour les environnements de test et de production.
{
"id": "86dcb68d-cbd0-4878-8da7-ffc0e6554513",
"decision": "SUCCESS",
"merchantRefNum": "KYC_1520461749",
"card": {
"lastDigits": "1111",
"cardExpiry": {
"month": 2,
"year": 2019
}
},
"profile": {
"firstName":"John",
"lastName" : "Smith",
"email": "john.smith@myemail.com",
"currentAddress": {
"street": "100 Queen Street West",
"street2": "Unit 201",
"city": "Toronto",
"state": "ON",
"country": "CA",
"zip":"M5H2N2","zip": "M5H 2N2","zip": "M5H 2N2",
"monthsAtAddress": "20",
"phone": "647-788-3901"
},
"previousAddresses": [{
"city": "Calgary",
"state": "AB",
"street": "2124 Westchester street",
"street2": "string",
"zip": "M2H 2G6",
"country": "CA",
"monthsAtAddress": "30"
}],
"dateOfBirth": {
"day": "25",
"month": "12",
"year": "1980"
},
"sinLastFour": "6789"
},
"customerIp": "1.1.1.1",
"vendorCheck": "EID_COMPARE",
"providerResponses": {
"eidCompare": {
"id": "0f1266b9-ce28-4df2-bc3f-d4b746cc1ced",
"status": "SUCCESS",
"response": {
"assessmentComplete": {
"reasonCodes": [{
"description": "Telephone exchange does not match the FSA (first three characters) of the postal code for Current Address",
"code": "08"
}],
"decision": "Y",
"score": 25
}
}
}
}
}
La réponse comporte les paramètres supplémentaires suivants :
| Valeur | Type | Description |
|---|---|---|
| Id | string longueur=36 | Il s’agit de l’identifiant unique de la requête renvoyé dans la réponse. |
| card.lastDigits | string length=4 | Il s’agit des quatre derniers chiffres de la carte incluse dans la requête, renvoyés dans la réponse. |
| decision | enum | Il s’agit de la décision globale relative à l’identité du client renvoyée par Paysafe, en fonction des réponses des fournisseurs en aval. Les valeurs éventuelles sont :
|
| providerResponses.eidcompare | complexe | Il s’agit d’une réponse en lecture seule d’un fournisseur en aval que Paysafe utilise pour calculer la valeur decision. Cliquez ici pour des détails sur l’objet providerResponses. |