Payments

Bead provides a unified, secure, and streamlined solution for accepting crypto and digital wallet payments through a hosted payment page. The Payments API simplifies integration so your customers can select their preferred payment method without leaving your checkout experience.

Payments work together with Reporting and Settlement:

• Payments create and track individual transactions

• Reporting provides historical payment views for partners, merchants, and terminals

• Settlement shows how payments are grouped into settlement batches and when funds are available

Key features

• Hosted payment page A secure hosted checkout experience that reduces integration complexity and keeps sensitive flows off your infrastructure.

• Real time webhooks Status change notifications delivered to your application so you can react as payments move through their lifecycle.

• Payment status API Simple GET endpoint to retrieve the latest status for a single payment using its trackingId.

• Settlement aware reporting Payment records include settlement related fields such as paymentSettlementStatusCode that you can use with the Settlement APIs for reconciliation.

API capabilities

Hosted payment Generate hosted URLs for customers to complete their payments. The hosted page handles tender selection, crypto and wallet flows, and customer prompts.

Payment status Check payment status using a simple API call by trackingId. Use this for ad hoc checks and troubleshooting.

Webhooks Configure real time status updates delivered to your backend so you do not need to poll the status endpoint.

Reporting and settlement Use Reporting to retrieve payment history for partners, merchants, and terminals. Use Settlement to see how those payments were grouped into settlement batches and when funds became available.

Get started

• Quick Start Use the Quick Start guide to obtain an access token, create a hosted payment, present it to a customer, and confirm the result in Sandbox.

• Create payment See the Create Payment page for full request and response details for POST /payments/crypto, including headers, body fields, and example flows.

• Payment statuses See the Payment Statuses page to learn how to retrieve the current status of a payment, understand each status value, and handle non happy path outcomes.

• Payment webhooks See the Payment Webhooks page to configure terminal level and per payment webhooks, review payloads, and implement robust handlers.

• Test crypto transactions See the Test Crypto Transactions page for guidance on obtaining supported test assets, acquiring fee tokens where needed, and completing end to end test payments.

For reconciliation and settlement views:

• Use Reporting (Partner Payments, Merchant Payments, and Terminal Payments) to build payment history dashboards.

• Use Settlement (Merchant settlements and Payment settlements) to see how payments are grouped into settlement batches and when funds are available to merchants.