KYC – Notifications

In order to inform you of events related to KYC/KYB document validation, the HiPay platform can send your application a server-to-server notification.

To set your notification URL, please submit a request to our Support team (specifying HiPay Marketplace).

Response fields  

Field nameDescription
md5contentSHA1 encoding of the field
operationName of the notification (document_validation)
status

– ok: the document is validated

– nok: the document is not validated

messageDescription of the status
dateDate of the notification (YYYY-MM-DD)
timeTime of the notification (HH:MM:SS Time zone)
document_type

Type of KYC/KYB document

(please see here for a detailed description)

document_type_labelDescription of the document (please see here for a detailed description)
account_idHiPay account ID for which the KYC/KYB was uploaded

Callback messages  

Please find hereafter the various reasons for refusal provided by notification.

Invalid date
Unreadable
Missing data
Inconsistency: {personalized-msg}
Not verified: missing document
Invalid document type
Falsified
Front missing
Supplier outside the scope
Bank outside the scope
Inconsistent
Other
Invalid Address
Expired

Response example  

Example of a KYC/KYB document notification in XML format 

<?xml version="1.0" encoding="UTF-8"?>
<notification>
   <md5content>d9e43bb0a9b92aba4fb22eed4164a1f0</md5content>
   <result>
      <operation>document_validation</operation>
      <status>nok</status>
      <message>Not a proof of address</message>
      <date>2018-06-29</date>
      <time>16:39:42 Europe/Paris+0200</time>
      <document_type>2</document_type>
      <document_type_label>Proof of address</document_type_label>
      <account_id>543210</account_id>
   </result>
</notification>