Bead Developers
  • Introduction
  • Quick Start
  • Authentication
  • Payments
    • Create Payment
    • Payment Statuses
    • Payment Webhooks
    • Test Transactions - Crypto
    • Changelog
  • Entity Management
    • Onboarding
    • Merchant Management
      • Get Merchant
      • Changelog
    • Location Management
      • Create Location
      • Get Location
      • List Locations
      • Update Location
      • Delete Location
      • Changelog
    • Terminal Management
      • Terminal Lifecycle (Concepts)
      • Create Terminal
      • Get Terminal
      • List Terminals
      • Update Terminal
      • Delete Terminal
      • Webhook Management
      • Changelog
  • Settlement
    • Batches
    • Settlement Details
  • Reporting
    • Payment History Concepts
      • Pagination and Sorting
    • Partner Payments
    • Merchant Payments
    • Terminal Payments
    • Changelog
  • Reference Guide
    • Core Concepts
      • Environments & Base URLs
      • Authentication
      • Error Codes
    • Enumerations & Schemas
      • Tender Types
        • Crypto
        • Alternative Payments
      • Settlement Currencies
      • Common Field Types
    • Endpoint Index
      • Table View (All APIs)
      • Download OpenAPI / Postman
    • Payment Scenarios
      • Under- and Over-Payment Handling
      • Reclaiming Unconverted Crypto
    • Operational Guides
      • Compatible Crypto Wallets
      • Webhook Event Reference
    • Support & Contacts
      • Integration Support
      • Escalation Contacts
    • Changelog
  • FAQs & Troubleshooting
    • Authentication FAQs
    • Payments FAQs
      • Resolving “403 Forbidden” When Creating Payments
    • Environment & Testing
      • How to Test Klarna Payments
      • How to Prepare for USDC Testing
      • How to Test Klarna Payments
    • Webhooks & Error Codes
Powered by GitBook
On this page
  • What you’ll find here
  • How to use this section
  1. Reference Guide

Operational Guides

PreviousReclaiming Unconverted CryptoNextCompatible Crypto Wallets

Last updated 10 days ago

Operational Guides cover everything that happens after an API call succeeds: webhook consumption, reconciliation, customer-side flows, and real-world edge cases. Think of this section as your run-book for production.

What you’ll find here

Page
What it covers

Payload schema, HMAC verification, retry logic, and best-practice checklist.

Popular wallets that work out of the box, minimum capabilities, and caveats.

Guides for partial / over-payments and reclaiming unconverted crypto.

Default quotas, 429 handling, and back-off strategy.

(Coming soon) Refund Scenarios

Full and partial refund flows once the refund API is public.

How to use this section

  1. Start with the Webhook Event Reference to build a secure, idempotent listener.

  2. Consult Payment Scenarios for edge-case handling so your UI and support team know what to do when a payment is under- or over-paid.

  3. Reference Compatible Crypto Wallets when doing end-to-end QA on testnets and mainnet.

  4. Keep Rate Limits in mind when load-testing or deploying to high-traffic environments.

Bookmark this area; it evolves alongside the API to include new events, refund flows, and operational best practices.

Webhook Event Reference
Compatible Crypto Wallets
Payment Scenarios
Rate Limits & Throttling