API Identité du client
- Value Added Service
- Canada
- Europe & UK
- United States
- Latest
L’API Identité du client Paysafe permet aux marchands d’effectuer des contrôles d’identité de connaissance du client (KYC) sur leurs clients avec une seule requête à l’API.
L’API est facile à utiliser, et une fois que vous avez reçu une réponse de connaissance du client de Paysafe, vous pouvez intégrer votre client en toute confiance. Voici un aperçu du processus.
Aperçu Identité du client
-
Recueillez un minimum d’informations de base sur le client.
-
Soumettre une demande de vérification de l’identité du client à Paysafe; les paramètres requis sont énumérés ici. La requête ressemblera à ceci, mais vous n’avez pas besoin de toutes les informations présentées ici :
POST https://api.test.paysafe.com/customeridentification/v1/identityprofiles
{
"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": "50",
"phone": "647-788-3901"
},
"dateOfBirth": {
"day": "25",
"month": "12",
"year": "1980"
},
"sin": "123456789"
},
"customerIp": "1.1.1.1",
"vendorCheck": "EID_COMPARE"
} -
-
Paysafe envoie votre requête aux fournisseurs en aval, qui sont déterminés par le paramètre vendorCheck ou workflowId utilisé dans la requête. Lors de votre inscription, Paysafe vous indiquera lequel de ces deux paramètres doit être utilisé, ainsi que la valeur à fournir dans la requête.
-
La réponse de Paysafe ressemblera à l’exemple ci-dessous.
{
"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"
},
"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
}
}
}
}
}
-
-
Dans cette réponse, vous pouvez voir que la valeur du paramètre "decision" est SUCCESS. Cela signifie que le client a passé avec succès le contrôle connaissance de l’identité du client.
-
Si la valeur du paramètre de décision est ERROR, cela pourrait indiquer que la requête n’a pas pu être achevée pour une raison quelconque, par exemple un dépassement de délai avec un fournisseur en aval. En cas d’une ERROR, vous pouvez réexécuter la requête de contrôle de l’identité du client avec le point de terminaison rerunfailedchecks en utilisant l’identifiant renvoyé dans la réponse. Par exemple, l’identifiant renvoyé ci-dessus est : 86dcb68d-cbd0-4878-8da7-ffc0e6554513.
POSThttps://api.test.paysafe.com/customeridentification/v1/identityprofiles/86dcb68d-cbd0-4878-8da7-ffc0e6554513/rerunfailedchecks
-
Si la requête de contrôle de l’identité du client est traitée avec succès lorsque vous la réexécutez, vous recevrez une réponse comme celle de l’étape 4 ci-dessus.
