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 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 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 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 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 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 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 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.

✅
Proper balance management ensures smooth operations and prevents payout failures.

Additional Considerations

Supported Cryptos and Fiats: Refer to the 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.

📘
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.