V1

Send data to the third-party server

Send data to the third-party server

The third-party server has to make available a server url enabling the S-money server to notify it when a request item is validated or rejected. With every notification the status and the fonction of the user can evolve.

The call to the S-money server is made using the method HTTP POST with a content-type : application/json

The HTTP request parameters are :

Parameters Type Description
type Int Operation type
4 = KYC
parameters parameters Callback details

Parameters

Parameters Type Description
user user Object displaying user details
demand demand Object displaying details of the request associated with the user
attachments [attachment] Tab displaying the detail of one or several items

User

Parameter Type Description
id long Client S-money ID
appuserid string Client ID for the third-party application
status int 1 = OK
2 = Frozen
3 = On the fly
4 = Closing
5 = Closed
6 = Waiting for KYC (transfers blocked)
7 = Blocked
role int 1 = Client
2 = Extended client (KYC)

Demand

Parameter Type Description
id long KYC request ID
status int 0 = Incomplete
1 = Pending
2 = Rejected
3 = Accepted
message string Reason entered by the operator

Attachment

Parameter Type Description
id long Item ID
status int 0 = Pending
1 = Valid
2 = Invalid
3 = Incomplete
4 = Not verified
type int 0 = Bank account details
1 = ID
2 = Proof of adress
3 = KBIS
4 = Other
additionalStatus int 0 = Not vérified
1 = Compliant, consistent and valid
2 = Falsified (if ID falsified or minor)
3 = Unreadable or cut
4 = Item missing or out of scope (If ID : Only Verso with missing back / if bank account details : Bank out of scope / if proof of adress : Provider out of scope)
5 = Not consistent / data (if ID : Name - surname are reversed / if proof of adress : error on the holder)
6 = Not consistent / data : other error
7 = Expired
8 = Compliant, consistent and valid but not qualifiable (If bank account details or proof of adress : verified except for name of the holder not verified)
9 = Out of scope (Not an ID, or not bank account details, or not a proof of adress)
message string Reason entered by the operator