BVbvnk
Fiat Payments

Get fiat wallet

Changed on

Retrieves a specific wallet by its ID.

Deprecated: use GET /ledger/v2/wallets/{id} instead.

get/ledger/v1/wallets/{id}

Request

Path parameters

idstring required
Example:a:24092328494070:G5i4XZ9:1

The ID of the wallet that you want to retrieve

Response

OK

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

  • 97d6c0d2fe2eRevision changes
    • breaking

      the / response's property type changed from object to array for status

    • warning

      removed the optional property // from the response with the status

    • info

      endpoint deprecated

    • info

      added the required property to the response with the status