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. |