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 5 = In progress 7 = Ignored |
| 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 |