V1

Request a reference of a bank transfer top-up

Sequence diagram

Send the data of the bank transfer top-up request to the S-money server.

To send the data of the bank transfer top-up request, please have a look at the example in the right margin of this page.

Send the data of the completed transfer top-up to the third-party server

The third party server should provide the S-money server with a url, so that the latter can communicate the result of the top-up execution. Note that more top-ups can come with the same reference. .

The HTTP POST method is used to invoke the S-money server.

The parameters of the HTTP request are :

Parameter Type Description
id long Top-up operation ID
reference string Transfer operation ID
error Int Error code for failed payments, 0, if no errors.
type Int Operation type
8 = bank transfer top-up
status Int Operation status
-1 = unknown
0 = waiting
1 = Realised
2 = refunded
3 = refused
4 = waiting for validation
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