KYC/KYB server-to-server notifications
Notifications relating to KYC/KYB documents
- “document_validation” notification upon validation or refusal of a KYC/KYB document
You will receive an XML notification informing you of the validation status of every KYC/KYB document required for each seller account.
Please pay attention to the following fields:
- operation (document_validation)
- status (ok or nok)
- message (reason for the refusal)
- document_type (type of KYC/KYB document)
- document_type_label (designation of the KYC/KYB document)
- account_id (ID of the related seller account)
Example of a “document_validation” XML notification:
a1b23cc0a9b87aba4cd55eef6789a1b0
document_validation
nok
Not a proof of address
2018-06-29
2
Proof of address
12345678
- “identification” notification upon validation of all KYC/KYB documents
You will receive a final XML notification informing you that all KYC/KYB documents have been validated for a specific seller account.
Please pay attention to the following fields:
- operation (identification)
- status (ok)
- account_id (ID of the related seller account)
Example of an “identification” XML notification:
a1b23cc0a9b87aba4cd55eef6789a1b0
identification
ok
2018-01-21
12345678
Notifications relating to bank information
- “document_validation” notification for the uploaded bank account identification document (RIB/IBAN)
You will receive an XML notification informing you of the validation status of the uploaded bank account identification document (RIB/IBAN) for a specific seller account.
Please pay attention to the following fields:
- operation (document_validation)
- status (ok or nok)
- message (message relating to validation or reason for the refusal)
- document_type (type of document – 6)
- document_type_label (designation of the document – Bank)
- account_id (ID of the related seller account)
Example of a “document_validation” XML notification:
a1b23cc0a9b87aba4cd55eef6789a1b0
document_validation
nok
Verified except holder\’s first name
2018-06-29
6
Bank
12345678
- “bank_info_validation” notification for bank details manually input
You will receive an XML notification informing you of the validation status of bank details for a specific seller account.
Please pay attention to the following fields:
- operation (bank_info_validation)
- status (ok or nok)
- account_id (ID of the related seller account)
Example of a “bank_info_validation” XML notification:
a1b23cc0a9b87aba4cd55eef6789a1b0
bank_info_validation
ok
2018-07-29
12345678