V1
Create a bank card payment
Send the data of the card payment request to the S-money server
To create a bank card payment, please have a look at the example in the right margin of this page.
Send the data of the completed payment to the third-party server
The third-party server needs to provide the S-money server with an url server, so that the latter can communicate the results of the payment execution.
The HTTP POST method is used to invoke the third-party server.
The parameters of the HTTP request are :
| Parameter | Type | Description |
|---|---|---|
| id | string | Operation OrderId |
| error | Int | Error code for failed payments, 0 if no error. 1 = The merchant needs to contact the bank of the holder 2 = Payment refused 3 = Payment cancelled by the client 4 = Holder not 3D-Secure enrolled 5 = 3D-Secure authentication error 6 = SystemPay technical error |
| type | Int | Operation type 1 = card payment |
| status | Int | Operation status -1 = unknown 0 = waiting 1 = completed 2 = refunded 3 = refused 4 = waiting for validation 5 = Cancelled 6 = waiting to be sent |
| sequencenumber | Int | Sequence number of the multiple payment (if multiple payment) |
| userid | String | User identifier in the third-party application |
| userstatus | Int | User status 0 = Not confirmed 1 = OK 2 = Frozen 3 = On the fly 4 = Being closed 5 = Closed 6 = Waiting for KYC (transfers blocked) |
Redirection at the end of a card payment
The third-party server should provide the S-money server with an url which allows the S-money server to redirect the client to the third-party environment.
The url can be either associated to a web scheme (http/https) or a private scheme when a request will be made from a third-party application.
Returned information should be used only for informative purposes and should not be, under any circumstances, used for the payment validation by the server.
The parameters of the HTTP request are :
| Parameter | Type | Description |
|---|---|---|
| Id | String | OrderId of the payment |
| type | Int | Operation type 1 = card payment |
| Result | Int |
Transaction status
0 : No errors.
2 : The merchant needs to contact the bank of the holder.
5 : Payment refused.
17 : Client cancellation.
30 : Request format error. To compare with the value of
vads_extra_result.
96 : Technical error of the payment. |