Tracking fiat settlements

The first step is to load your account with fiat funds. You can do this by manually retrieving settlement details from the BVNK portal or by having your existing payment flows from other payment providers settle into your BVNK account. In this step, we will show how to find fiat funds that have been sent to your account using the Get transactions endpoint.

curl --request GET \
     --url https://api.sandbox.bvnk.com/api/transaction/255861 \
     --header 'Accept: application/json' \
     --header 'Authorization: Hawk id="B9jnE1U8eLblzHtNeJZRxfcq03CQKcmcP9FOrACMzXb1HfrxrePWsTfuP70JNns9", ts="1633010032", nonce="guGXrD", mac="uKeg+w1qXqzaF/8mOQGv8Y9IlRxyxTT+iINLe03EQ60="'

All you'll need to make this request is the id of the wallet you are querying. You can find your wallet IDs by querying the Get wallets endpoint.

Once you've submitted this request you'll receive a response detailing the transactions on the wallet:

[
  {
    "amount": -0.24,
    "context": {
      "id": "159d40d2-5e75-4441-baf0-4a6631cba13e",
      "fromCurrencyCode": "ETH",
      "toCurrencyCode": "EUR",
      "type": "IN",
      "reference": "38739c0d-4d3d-466c-89d4-afab5b73f74c",
      "uuid": "e8b06777-a538-4513-9400-3f9a348e7507",
      "status": "COMPLETE",
      "merchantId": "0a12a214-1619-43fa-9be1-0029f6a440a0",
      "subType": "merchantPayIn",
      "hash": null
    },
    "dateCreated": "2022-04-27T09:32:49Z",
    "description": "e8b06777-a538-4513-9400-3f9a348e7507",
    "hash": "X9b726136ecd0441cab1b40e2",
    "id": 76222874,
    "type": "paymentInFees",
    "wallet": {
      "address": "E36140086",
      "alternatives": [],
      "approxAvailable": "11502.7",
      "approxBalance": "11502.7",
      "available": 11502.7,
      "balance": 11502.7,
      "currency": {
        "code": "EUR",
        "depositFee": 0,
        "fiat": true,
        "icon": null,
        "id": 1773,
        "name": "Euro",
        "options": {},
        "pricePrecision": 2,
        "protocols": [],
        "quantityPrecision": 2,
        "supportsDeposits": true,
        "supportsWithdrawals": true,
        "withdrawalFee": 0.4,
        "withdrawalParameters": []
      },
      "custodianWallet": null,
      "depositFee": 0,
      "description": "Euro",
      "id": 255861,
      "lookup": null,
      "protocol": null,
      "supportsDeposits": true,
      "supportsWithdrawals": true,
      "withdrawalFee": 0.4
    }
  },
  {
    "amount": 24.62,
    "context": {
      "id": "159d40d2-5e75-4441-baf0-4a6631cba13e",
      "fromCurrencyCode": "ETH",
      "toCurrencyCode": "EUR",
      "type": "IN",
      "reference": "38739c0d-4d3d-466c-89d4-afab5b73f74c",
      "uuid": "e8b06777-a538-4513-9400-3f9a348e7507",
      "status": "COMPLETE",
      "merchantId": "0a12a214-1619-43fa-9be1-0029f6a440a0",
      "subType": "merchantPayIn",
      "hash": null
    },
    "dateCreated": "2022-04-27T09:32:49Z",
    "description": "170224",
    "hash": "Xb43b651882c44e2aa6c859dd",
    "id": 76222873,
    "type": "payIn",
    "wallet": {
      "address": "E36140086",
      "alternatives": [],
      "approxAvailable": "11502.7",
      "approxBalance": "11502.7",
      "available": 11502.7,
      "balance": 11502.7,
      "currency": {
        "code": "EUR",
        "depositFee": 0,
        "fiat": true,
        "icon": null,
        "id": 1773,
        "name": "Euro",
        "options": {},
        "pricePrecision": 2,
        "protocols": [],
        "quantityPrecision": 2,
        "supportsDeposits": true,
        "supportsWithdrawals": true,
        "withdrawalFee": 0.4,
        "withdrawalParameters": []
      },
      "custodianWallet": null,
      "depositFee": 0,
      "description": "Euro",
      "id": 255861,
      "lookup": null,
      "protocol": null,
      "supportsDeposits": true,
      "supportsWithdrawals": true,
      "withdrawalFee": 0.4
    }
  }
]

From this response, you'll be able to locate payments that have landed in the account as well as track the conversions and fees that have taken place.