​
What is a Payin?

In Bluerails, a Payin represents an inbound transaction – funds flowing into one of your Accounts within your Organization. Payments record the reception of assets from external sources, whether initiated via traditional banking rails or direct cryptocurrency transfers. Think of a Payin as the mechanism and record for crediting your Bluerails Accounts with funds from the outside world.

​
How Payins Work

Funds can be received into your Accounts through two primary methods:

​
1. Fiat via Virtual Accounts

You can provision virtual bank account details (like IBANs) linked to your Bluerails Accounts. When fiat currency (e.g., EUR, USD) is sent to these virtual account details via standard bank transfers (SEPA, SWIFT, etc.), Bluerails receives the funds. Crucially, incoming fiat is automatically converted into USDC (USD Coin) stablecoin. The resulting USDC amount, potentially less any conversion fees, is credited to the designated Bluerails Account balance. A Payment record is created, detailing the original fiat amount, the conversion, and the final USDC credited.
Bank Transfer(EUR)
Virtual Account
Auto-Convertto USDC
Bluerails Account(+USDC)

​
2. Direct Crypto Deposits

Each Bluerails Account capable of holding a specific cryptocurrency (e.g., USDC, ETH, BTC) can have associated deposit addresses. You can provide these addresses to your customers or use them for your own transfers. When cryptocurrency is sent directly to the correct address on the corresponding blockchain, Bluerails detects the transaction after network confirmations. The received crypto amount (less any network fees if applicable by the sender) is credited directly to the balance of that specific crypto asset within the designated Account. A Payin record is created, documenting the crypto asset, amount, and destination Account.
Crypto Wallet (ETH)
Direct Crypto Deposit
Account (+ETH)
Bluerails Accounts are designed to be multi-asset. As shown above, you can receive USDC derived from fiat deposits and also receive other cryptocurrencies like ETH directly into the same account.

​
Resulting Account State

After receiving funds from both fiat (converted to USDC) and direct crypto deposits, your Bluerails Account can hold multiple asset balances simultaneously:
Bluerails Account
USDC Balance (from Fiat)
ETH Balance (Direct Deposit)

​
Payin Lifecycle & Status

A Payin typically goes through several stages, reflected in its status:
  1. Initiated/Pending: The transfer has been detected or initiated but is not yet final.
  2. Processing/Converting: The funds are being processed (e.g., compliance checks, fiat conversion).
  3. Completed: The funds have been successfully credited to the target Account’s balance.
  4. Failed: The payin could not be completed due to an error.
You can track the status of payins via API calls or by subscribing to webhook events.
Refer to the Payin API Reference for detailed endpoint specifications.
Once funds are in your Accounts, you can manage them or initiate Payouts (Outbound).