Bank integration

Top-up-in-system account from bank account

Doing a top-up, the customer performs a normal bank transfer to the special transit account with specifying in-system account identifier. These transfers are processed on the bank side manually or using bank integration and the requested account is topped up using SDK Cloud wallet APIs.

To validate in-system account, use the POST​/coins​/validate endpoint and request the next values:

{
"serial":"string"
}

To calculate the commission use POST /bank-top-ups/calculate endpoint and request:

{
"coinSerial":"string",
"amount":0.01
}

This step can be skipped if the commission is not set up in the system.

To top-up the account use the POST /bank-top-ups/with-bank endpoint and request:

{
"coinSerial":"string",
"amount":0.01,
"bankAccountNumber":"string",
"iban":"string",
"bankId":"string",
"fullName":"string"
}

This use case flow with possible integrations:

Transfer from in-system

If you want to get the list of your accounts, use Get/coins endpoint. You will get the coinSerial value then.

When you have the commission set up in the system, use the POST /bank-withdrawals/calculate endpoint to calculate the commissions.

{
"coinSerial":"string",
"amount":0.01,
"bankAccountNumber":"string",
"iban":"string",
"bankId":"string",
"fullName":"string"
}

Save the requestIdentifier response value then.

To accept the request, use POST /bank-withdrawals/{requestIdentifier}/accept endpoint and request values by requestIdentifier.

To decline the request, use POST /bank-withdrawals/{requestIdentifier}/decline and request requestIdentifier then.

The use case flow visualisation with possible integrations: