Wallets

A wallet is a payment tool, that allows you to send, receive and store funds in a specific currency. You can set up multiple wallets to conduct transactions in different currencies.

To set up a Fipto wallet, you need to provide the following information:

Add a wallet

Platform

1. In the platform, open the "Wallets" page.
2. Click "Add wallet".
3. Provide a name for your wallet and choose the specific asset it will hold.
4. Complete the process by clicking "Add wallet."

Congratulations! You have now successfully added a new wallet. Share your wallet's address with your business partners to start receiving payments. You can also use it to initiate payments when needed.

API

To create a wallet through the API, you'll need to include the name and the asset in the request body.

Here below is an example of a payload to create a wallet holding USDC:

{
  "data": {
    "type": "wallet",
    "attributes": {
      "name": "Stablecoin USDC - Project A",
      "asset": "USDC"
    }
  }
}

When the wallet is successfully created, the following JSON is returned:

{
    "meta": {
        "request_id": "0a78048d-8b66-4e04-a565-ded4b59d04b5"
    },
    "data": {
        "attributes": {
            "asset": "USDC",
            "name": "Stablecoin USDC - Project A",
            "balances": {
                "available": "0",
                "forecasted": "0"
            }
        },
        "id": "3mDCm5mkDZP1LOtVjYkysA",
        "type": "funds"
    }
}

The available balance represents the real-time balance in your wallet that you can use for transactions. On the other hand, the forecasted balance encompasses both the available balance and any upcoming funds expected in your wallet.

Wallet details

Wallet details serves as recipient addresses for your wallets. Wallet details are blockchain addresses for digital wallets and IBANs for fiat wallets.

You can create multiple wallet details for a single wallet, which is useful when interacting with various suppliers. This enables you to provide distinct wallet details to each supplier, facilitating payment tracking and simplifying reconciliation later on.

A wallet details has the following properties:

Platform

ℹ️

When you create a wallet via the dashboard, an initial wallet detail is automatically generated.

To create additional wallet details, follow these steps:

1. In the dashboard, go to the "Wallets" page.
2. Select a wallet to view its details.
3. Navigate to the "Wallet details" tab.
4. Choose a name for your wallet detail.

Congratulations! You have successfully created a new wallet detail. You can edit the name of your wallet detail at any time in the future.

API

ℹ️

When you create a wallet via the API, it won't automatically generate any wallet details.

To create a wallet detail, you need to include the name of the wallet detail in the request body.

Here below is an example of a payload to create a wallet detail for a digital wallet:

{
  "data": {
    "type": "wallet_details",
    "attributes": {
      "name": "My first wallet details"
    }
  }
}

When the wallet detail is successfully generated, the following JSON is returned:

{
  "meta": {
    "request_id": "cb92cae5-0b05-4b6e-84dd-d4de7a0b15ad"
  },
  "data": [
    {
      "id": "9C268e95-cBd5-bddf-7E0f-B1beD5B23970",
      "type": "wallet_details",
      "attributes": {
        "asset": "USDC",
        "address": "0x1F10c09f9D589417A64e4921996f7501D1Be058F"
      }
    }
  ]
}

The response includes details such as the asset associated with the wallet for which the wallet detail was created. Additionally, it provides a blockchain address, which serves as the wallet detail and can be shared with your suppliers and partners for sending and receiving funds.