V1

Create a KYC request

To create a KYC request via the API, please refer to the example in the right margin of this page.

3 entry point are available according to the type of document sent :

POST /users/appuserid/kyc/identitycontrol to send an ID (only usable for private individuals)

POST /users/appuserid/kyc/addresscontrol to send a proof of adress (only usable for private individuals)

POST /users/appuserid/kyc to send any other supporting document

Sending the first item opens the request, then the next sendings will contribute to the request.
Warning : the name of the file sent must not exceed 100 caracters. The maximum size allowed in the request is 20 MB, the size per piece is 10 MB.

Validation of rejection of a KYC request

Verifying KYC requests takes a few seconds when using /idcontrol or /addresscontrol.
Please note that front and back sides of ID need to be sent in the same request in two different files. In addition, for the tests, proofs of adress and ID need to be real to be validated.

S-money verifies KYC requests within 48h. When the request is being processed, a notification is sent to the third-party server.

Requête :
POST /api/[domaine partenaire]/users/appuserid/kyc/ HTTP/1.1
Accept : application/vnd.s-money.v1+json
Content-Type : multipart/form-data ; boundary=-------------------------acebdf13572468
Authorization : Bearer ACCESS_TOKEN
---------------------------acebdf13572468
Content-Disposition : form-data ; name="file1" ; filename="img1.png"
Content-Type : image/png
[FILE CONTENT]
---------------------------acebdf13572468
Content-Disposition : form-data ; name="file2" ; filename="img2.png"
Content-Type : image/png
[FILE CONTENT]
---------------------------acebdf13572468
Content-Disposition : form-data ; name="file3" ; filename="img3.png"
Content-Type : image/png
[FILE CONTENT]
---------------------------acebdf13572468—

Réponse :
HTTP/1.1 201 CREATED
Content-Type : application/vnd.s-money.v1+json
Location : /api/[domaine partenaire]/users/appuserid/kyc/18

{

        "id":18,

        "requestdate":"2013-11-29T00:00:00",

        "status":1,

        "vouchercopies":[{

               "id":23339,

                "name":"carte d’identité",

                "type":1,

                "ContentType":"image/png",

                "size":523010,

                "Status":0,

                "Message":"Non vérifié",

                "AdditionnalStatus":0,

                "TreatmentDate": null,

                "ReceivedDate": "2017-05-22T09:54:26",

                "href":"/api/kyc/attachments/{id}"

        }, {…}]        

}