Receive fiat funds via SWIFT

• Direct model
• Embedded model
• Fiat

To receive fiat funds in your BVNK virtual account, you can deposit EUR, GBP, or USD from a registered bank account. This guide explains how SWIFT wallets work and how to obtain the deposit details your senders need.

To receive funds via SWIFT, you can use one of the following account types:

• Named. The wallet has its own SWIFT account details, and operations look like a regular deposit. Senders transfer funds directly to the account number issued in your business name.
• Pooled. Multiple customers share a consolidated SWIFT account, and BVNK uses the payment reference to allocate incoming funds to the correct wallet.

---

Prerequisites

Before depositing funds, ensure you have:

• A fiat wallet with the SWIFT payment method enabled. See Set up wallets.
• A registered bank account on your BVNK Settings page (for Portal deposits).

---

Receive funds via SWIFT

Select your account type to follow the matching flow.

Named account

How it works

The wallet is issued with its own SWIFT account details in your business name. Senders transfer funds directly to the account number, and BVNK credits incoming funds to your wallet automatically based on the account number—no payment reference is required.

Get deposit details

Retrieve the deposit details to share with the sender via the API or the BVNK Portal.

API

Send the GET ledger/v2/wallets/{id} request.

In the response, locate the paymentInstruments array and extract the accountHolderName, accountNumber, and bankDetails.bic fields.

{
    "id": "a:25052061784520:mVeJ2rA:1",
    "name": "USD SWIFT",
    "customer": {
        "id": "a1f84b6c-9e23-4d17-b590-7c4a83de2f10",
        "name": "Meridian Healthcare"
    },
    "status": "ACTIVE",
    "balance": {
        "amount": 52080.00,
        "currency": "USD"
    },
    "paymentInstruments": [
        {
            "type": "FIAT",
            "accountHolderName": "MERIDIAN HEALTHCARE SERVICES LTD",
            "accountNumber": "GB29MDTR60000131926819",
            "bankDetails": {
                "name": "Meridian Trust Bank PLC",
                "bic": "MDTRGB2LXXX",
                "nid": {
                    "value": "600001",
                    "type": "SORT_CODE"
                }
            }
        }
    ],
    "createdAt": "2025-05-20T10:17:45.200Z",
    "updatedAt": "2025-06-15T09:22:31.480Z"
}

Portal

1. Go to Portal and navigate to the Wallets section.

2. In the Wallets list, locate the fiat wallet you want to fund and select it.

3. Go to the Wallet Details tab and review the displayed account details:

   • Beneficiary name
   • Account number or IBAN
   • Bank code

Provide payment instructions to senders

Share the following details with anyone sending funds to your wallet:

Parameter	API field name	Description
Beneficiary name	accountHolderName	The name of the account holder for the BVNK SWIFT account.
Account number	accountNumber	The IBAN or account number for the BVNK SWIFT account.
Bank code	bankDetails.bic	The bank identifier code for the receiving bank.

Pooled account

How it works

Multiple wallets share a single SWIFT account issued under the BVNK-owned legal entity. BVNK identifies the destination wallet from the payment reference included in the transfer.

When you receive a SWIFT pay-in to a pooled account:

1. The sender initiates a payment from their bank to the BVNK pooled SWIFT account.
2. BVNK receives the payment and checks the payment reference field.
3. Based on the reference, BVNK assigns the payment to the correct wallet.

If the payment reference is missing or incorrect, BVNK cannot automatically match the payment. In this case, provide proof of payment, such as a bank statement or transfer confirmation, so BVNK can manually credit your wallet. This process may delay the availability of your funds.

Get deposit details

Retrieve the deposit details to share with the sender via the API or the BVNK Portal.

API

Send the GET ledger/v2/wallets/{id} request.

In the response, locate the paymentInstruments array and extract the accountNumber, bankDetails.bic, and remittanceInformationPrefix fields. The remittanceInformationPrefix is unique to your wallet and is how BVNK allocates incoming funds.

{
    "id": "a:25031472839104:kR7mHxQ:1",
    "name": "USD SWIFT pooled",
    "customer": {
        "id": "a1f84b6c-9e23-4d17-b590-7c4a83de2f10",
        "name": "Meridian Healthcare"
    },
    "status": "ACTIVE",
    "balance": {
        "amount": 48250.75,
        "currency": "USD"
    },
    "paymentInstruments": [
        {
            "type": "FIAT",
            "accountHolderName": "System Pay Services (Malta) Limited",
            "accountNumber": "MT84MALT011000012345MTLCAST001S",
            "remittanceInformationPrefix": "REF DZ0XJL4",
            "bankDetails": {
                "name": "Bank of Valletta plc",
                "bic": "VALLMTMT"
            }
        }
    ],
    "createdAt": "2025-03-14T09:12:33.104Z",
    "updatedAt": "2025-06-02T11:45:07.463Z"
}

Portal

1. Go to Portal and navigate to the Wallets section.

2. In the Wallets list, locate the fiat wallet you want to fund and select it.

3. Click Deposit.

   

4. Review the displayed account details:

   • Account holder name
   • Account number or IBAN
   • SWIFT/BIC code
   • Payment reference

   

Provide payment instructions to senders

Share the following details with anyone sending funds to your wallet:

Parameter	API field name	Description
Beneficiary name	accountHolderName	The name of the account holder for the BVNK pooled SWIFT account.
Account number	accountNumber	The IBAN or account number for the BVNK pooled SWIFT account.
SWIFT/BIC code	bankDetails.bic	The bank identifier code for the receiving bank.
Payment reference	remittanceInformationPrefix	Unique reference for your wallet. Senders must include this value in the payment instructions so BVNK can allocate the funds to your wallet.

info

Instruct external senders to include the remittanceInformationPrefix value as the payment reference when transferring funds to your BVNK SWIFT wallet. The sending bank must include this value in the payment instructions to link the payment to your account.

Ensure senders use the same payment reference for all future transfers to your BVNK wallet.

---

Test in sandbox

To simulate a SWIFT pay-in in the sandbox environment, send the POST /payment/v2/payins/simulation request:

{
  "walletId": "a:24092328494070:G5i4XZ9:1",
  "method": "SWIFT",
  "remittanceInformation": "REF DZ0XJL4 Invoice 12345",
  "amount": 1500,
  "currency": "USD",
  "originator": {
    "name": "Emily Kaldwin",
    "bankAccount": {
      "accountNumber": "GB87SYPE04082500000904",
      "accountNumberFormat": "IBAN",
      "bankCode": "SRLGGB2L"
    }
  }
}

For more simulation options, see Try fiat payments in simulator.

---

What's next?

• Send payments to customers
• Refund fiat pay-ins
• Configure webhooks to receive real-time notifications about incoming payments