---
updatedAt: 2026-10-07T18:18:23.000Z
agentTools:
  projectIndex: https://docs.payb.is/llms.txt
---

# Crypto Pay-outs Integration Guide

## Introduction

This guide describes the technical integration of Paybis Send into your platform, enabling you to initiate and manage cryptocurrency payouts to end users using pre-funded fiat balances.
Paybis Send supports payouts for a wide range of partners, including PSPs, Acquirers, Merchants, payroll providers, e-commerce platforms, and other payout-driven platforms.

## Prerequisites

* **Implement request signing**: Secure all API requests by implementing request signing. See our [Signing Requests Guide](https://docs.payb.is/reference/pb-send-signing-requests) for details.
* **(Optional) Merchant-facing UI**: Build a user interface that uses Paybis Send APIs to allow merchants or internal users to initiate payouts, track transactions, and view payout history.
* **(Optional) Admin panel integration**: Integrate Paybis Send into your admin or operations panel to enable your team to initiate payouts on behalf of merchants and monitor transaction statuses.

## Send Crypto Flow

### 1. (Optional) Check Pre-funded Balance

Ensure that sufficient funds are available in your **pre-funded fiat balance** (EUR, USD, GBP, or other supported currencies) to cover the payout amount. See the [Get Available and Hold Balances](https://docs.payb.is/reference/getbalancesv1) reference.

### 2. Validate Wallet Address

Use the **Crypto Address Screening API**  to verify that the end-user's crypto wallet address is valid and well-formated. This step is recommended to avoid potential payout issues.

See the [Crypto Address Screening API](https://docs.payb.is/reference/userscreeningv1) reference.

### 3. Request a Quote

Call the **Quote API** to receive a real-time quote for the selected fiat-to-crypto currency pair.
 The quote reflects the exact crypto amount that will be sent based on the specified fiat payout value.

See the [Quote API](https://docs.payb.is/reference/createquotev1) reference.

### 4. Execute Send Crypto Transaction

Use the **Execute API** to submit the payout request to Paybis.
Paybis will convert the required fiat amount from your pre-funded balance and execute the crypto payout to the specified wallet address.

See the [Execute API Endpoint](https://docs.payb.is/reference/executeeventv1) reference.

### 5. Transaction Statuses and Reconciliation

Paybis notifies you about payout status changes via the **Transaction Data Webhook**.
 Implement webhook handling to update transaction states, reconcile balances, and keep your system in sync.

See the [Transaction Data Webhook](https://docs.payb.is/reference/webhooks-for-paybis-send) reference.

### Available Environments

**Sandbox**:

A testing environment for your integration.

* Use the provided sandbox API key and URL.
* IP whitelisting is not enforced in the sandbox.
* Crypto payouts are executed on testnet blockchains. See the [Sandbox Testing](https://docs.payb.is/reference/pb-send-sandbox-testing) section for more details.

**Production**:

The live environment for processing real transactions.

* Use the production API key and base URL.
* **IP whitelisting** is enforced and must be configured before going live.
* Real fiat balances and live blockchain transactions are used.

## Managing Paybis Send Prefunding Balance

To ensure uninterrupted service and avoid payout failures, it's your responsibility to proactively monitor and maintain prefunded balance.

**Topping Up Your Balance:**

**Each partner is assigned a dedicated virtual IBAN (vIBAN) during onboarding.**

You can top up your pre-funded balance with fiat funds via bank transfer rails (SEPA, Instant SEPA, FPS, SWIFT) or in stablecoins.

All incoming deposits are processed automatically and credited to your balance without manual intervention.

**Key Points**

* **Responsibility**
  You are responsible for ensuring that your pre-funded fiat balance remains sufficient to cover upcoming payouts.
* **Currency**
  Balances are held in fiat currencies (EUR, USD, GBP, and others).
   Fiat funds are converted to crypto at the time of payout based on the quoted exchange rate.

<Callout icon="✅" theme="okay">
  Proper balance management ensures smooth operations and prevents payout failures.
</Callout>

## Additional Considerations

* **Supported Cryptos and Fiats**: Refer to the [Supported Assets](https://docs.payb.is/docs/pb-send-supported-assets) section for the full list of available currencies.
* **Testing**: Use testnet assets and small amounts when testing in the sandbox environment.
* **Key Generation**: Generate an RSA key pair for request signing and provide the public key to Paybis during onboarding.
* **Webhook URL**: To receive payout updates, provide your webhook URL to Paybis.

<Callout icon="📘" theme="info">
  For assistance with Paybis Send API integration, request signing, webhooks, sandbox setup, vIBANs, or pre-funded balance management, please contact your Paybis account manager or designated support team.
</Callout>