BVbvnk
Fiat Payments

Create fiat wallet

Changed on

Creates a fiat wallet for a specific Customer, generating a unique virtual account tied to the wallet.

For more information, how to apply it in the Embedded Wallets flow, refer to the Create a customer wallet guide.

post/ledger/v1/wallets

Request

Headers

X-Idempotency-Keystring uuid required
Example:1e74002e-74a1-48fd-b707-147c3187a3e1

Unique request identifier (any string, preferably in UUID format).

Request body

currencyCode'USD' | 'EUR' | 'GBP' | 'USDT' | 'POL' | 'PYUSD' | 'BTC' | 'SOL' | 'BNB' | 'XRP' | 'ETH' | 'LTC' | 'USDC' | 'USDG' | 'TRX' required

Currency code for the wallet.

namestring required

Name of the wallet.

customerReferencestring uuid required

Unique reference to the customer who owns the wallet.

Example request

{
  "currencyCode": "USD",
  "name": "My Customer Wallet",
  "customerReference": "b4e5c3d1-9a42-4e7b-8f34-7c6b2a89f3df",
  "instruction": {
    "walletProfile": "2a3fe604-2b14-4009-90b3-1e48f1a38b11"
  }
}

Response

Wallet created successfully.

idstring required

Unique wallet ID.

accountReferencestring uuid required

Account reference for this wallet.

customerReferencestring uuid required

Customer reference for this wallet.

namestring required

Name of the wallet.

status'ACTIVE' | 'INACTIVE' | 'TERMINATED' required

Status of the wallet.

capabilities'SAFEGUARDED'

Flag that shows that funds or assets are protected and kept separate from a company's own money. They can't be used for business operations or debts and remain available to the rightful owners.

Example response

{
  "id": "a:24092328494070:G5i4XZ9:1",
  "accountReference": "3399c975-e1c1-4acf-9a90-6cfbdcdeaaea",
  "customerReference": "b94dcf2a-d377-469e-8846-e21f65b18a77",
  "name": "Wallet XYZ987",
  "status": "ACTIVE",
  "balance": {
    "value": 10,
    "currencyCode": "GBP"
  },
  "ledgers": [
    {
      "accountHolderName": "System Pay Services (Malta) Limited",
      "accountNumber": "DE10601202004579784373",
      "code": "BEUCESMMXXX",
      "accountNumberFormat": "SWIFT",
      "paymentReference": "REF DZ0XJL4",
      "bank": {
        "identificationCode": "BEUCESMMXXX",
        "name": "Banco Europa Continental, S.A.",
        "address": {
          "addressLine1": "123 Main St",
          "addressLine2": "Apt 4B",
          "region": "California",
          "city": "Los Angeles",
          "country": "US",
          "postCode": "90001"
        }
      }
    }
  ],
  "capabilities": "SAFEGUARDED"
}

Changes