Payment cards

Updated on 01 Jun 2023

Top-up account from the payment card

In this case, any transit account should be specified for top-up in the system and using integrations with card payment provider payment card is debited.

If it is required, integration with the bank can be also built to perform transfer between transit accounts.

To see the list of your accounts, use GET/coins and save the response value coinSerial.
Calculate commission using POST​ /bank-top-ups​/calculate endpoint. Request the values with:

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

Save the requestIdentifier received value.

Accept top-up request with POST​/bank-top-ups​/{requestIdentifier}​/accept API endpoint and receive the requestIdentifier value then.

Decline top-up request with POST​/bank-top-ups​/{requestIdentifier}​/decline API endpoint, receiving the requestIdentifier value.

Payment cards

Money withdraw from the system to the payment card

In this case, any transit account should be specified for withdrawal in the system and using integrations with card payment provider payment card is credited.

If it is required, integration with the bank can be also built to perform transfer between transit accounts or to perform settlement with the card payment provider.

To see the list of your accounts, use GET/coins and save the response value coinSerial.

Calculate commission using POST /bank-withdrawals/calculate endpoint. This step can be skipped if the commission is not set up in the system.

To create the withdrawal request, use POST /bank-withdrawals/with-bank endpoint, requesting values:

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

Save the requestIdentifier value then.

Accept withdrawal request with POST /bank-withdrawals/{requestIdentifier}/accept API endpoint and receive the requestIdentifier value then.

Decline withdrawal request with POST /bank-withdrawals/{requestIdentifier}/decline API endpoint, receiving the requestIdentifier value.

Use case visualisation with possible integrations:Payment cards