Partner API
  1. Partner Operations
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Balances & Transaction History
        • Get Balances
        • Get Transaction History
        • Create Wallet
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • SEPA Transfers
        • Get SEPA Deposit Info
        • Get SEPA Deposit Contact List
        • Create a SEPA Transfer
        • Get SEPA Transfer Details
      • Crypto Withdrawal
        • Get Network Fee
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • Crypto Deposits
        • Update Travel Rule
      • Orders
        • Get Rates
        • Retrieve Order Rate and Create a Lock
        • Create and Finalize an Order
        • Get Order Details
      • Payment link & Checkout Link
        • Generate Payment Link
        • Generate Hosted Checkout
        • Get Payment Link Details
    • User Operations
      • Onboarding & KYC Flow
        • Create User Account
        • Method A: Add KYC File
        • Method B: Creating KYC Verification
        • Method B: Redirect to Verification
        • Method B: Get KYC Status
        • Add User Verification
        • Add POA File
      • Account Management
        • Update Existing User
        • Delete User
        • Suspend User
        • Unsuspend User
      • Balances & Transaction History
        • Get User Balances
        • Get User Transaction History
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • SEPA Transfers
        • Get SEPA Deposit Info
        • GET SEPA Deposit Contact List
        • Create a SEPA Transfer
        • Get SEPA Transfer Details
      • Crypto Withdrawal
        • Get Network Fee
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • Crypto Deposits
        • Update Travel Rule
      • Internal Transfers
        • Create a Transfer
        • Get Transfer Details
      • Virtual Cards
        • Create Virtual Card
        • Get All User Cards
        • Get Card Details
        • Update Card PIN
        • Block Card
        • Unblock Card
        • Get Card Limits
        • Update Card Limits
        • Delete Card
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • User & KYC Webhooks
        • User Balance Generation Webhook
        • KYC File Added Webhook
        • POA Verification Status Webhook
        • KYC Verification Status Webhook
        • Create Wallet Webhook
      • Transfers & Payments Webhooks
        • P2P Transfer Webhook
        • Partner SEPA Transfer Webhook
        • User SEPA Transfer Webhook
        • SEPA Deposit Webhook
        • Crypto Withdrawal Webhook
        • Crypto Deposit Webhook
        • Exchange Webhook
        • Card Transaction Webhook
        • Order status Webhook
        • Payment Link Webhook
      • Card Webhooks
        • Card 3DS Code Webhook
        • Card Activation Code Webhook
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. Partner Operations

Payment Links & Checkout

This module enables Partners to accept cryptocurrency payments that are automatically converted into Euro (EUR). You can generate a ready-to-use payment interface for your customers without building your own complex crypto-handling backend.

Use Cases & Implementation Variants#

Choose the integration type that best fits your business flow:

1. Payment Link (Invoicing & Manual Requests)#

Best for sending payment requests directly to clients (e.g., via email, SMS, or chat) or for B2B settlements.
Usage: You generate a link and send it to the payer manually.
Configuration: Uses the standard P100 system configuration (Standard Profile).
Scenario: A freelance client needs to pay an invoice, or you are settling a specific deal manually.

2. Hosted Checkout (App & Website Integration)#

Designed for seamless integration into your application or e-commerce flow. This is a white-label solution where the payment screen feels like part of your platform.
Usage: Your application redirects the user automatically during a purchase flow.
Configuration: Uses a Partner-specific configuration (White-label).
Scenario: A user tops up their wallet in your app or buys a product in your online store.
Key Features:
Full Branding: Displays your logo and colors.
Custom Rules: Applies your specific settings for link expiry and underpayment handling.

Core Endpoints#

Create Payment Link
Generate a shareable link for manual distribution (Standard Profile).
Create Hosted Checkout
Generate a white-label checkout session for app integration.
Get Payment Link Details
Retrieve real-time status, blockchain transactions, and payer information.

Typical Workflow#

1.
Generate: Call the appropriate endpoint based on your use case (Payment Link for invoices, Hosted Checkout for apps).
2.
Direct the User:
For Payment Links: Share the url with your client via your preferred communication channel.
For Hosted Checkout: Automatically redirect your user's browser/app to the returned url.
3.
Customer Action: The customer selects a payment method (Manual Transfer, MetaMask, or WalletConnect) and sends funds.
4.
Monitor:
Payment Link Webhook: Receive instant notifications when funds are detected on the blockchain.
Polling: Use Get Payment Link Details to track the status and view detected transfers in the transactions array.

Key Features#

Automated Conversion to EUR#

The system manages exchange rate volatility. Once a payment is detected and confirmed, the cryptocurrency is instantly converted to Euro (EUR) and settled to your balance.

Underpayment Handling#

If a user sends less than the required amount, the system enters an "Awaiting Completion" state. The user is prompted to pay the missing balance within the configured Underpayment Window to finalize the order.

Multi-Transaction Support#

A single payment link can track multiple blockchain transfers (e.g., an initial payment followed by a top-up). All detected attempts are listed in the transactions array, facilitating easy reconciliation.
Previous
Get Order Details
Next
Generate Payment Link
Built with