Quick Reference
API Endpoints
Test
Production
Contacts
Developer support
developers@beadpay.io
General inquiries
info@beadpay.io
Settlement Currencies (Fiat)
United States Dollar
USD
Live
Canadian Dollar
CAD
Pending
Tender Types (Crypto)
Bitcoin
BTC (Bitcoin)
Live
⚡Bitcoin Lightning
BTC (Bitcoin)
Live
USD Coin - Ethereum
USDC (ERC-20)
Live
USD Coin - Polygon
USDC (Polygon)
Live
⚡Bitcoin (BTC) on the Lightning Network provides near-instant payments at very low costs to customers, making it ideal for in-store transactions. Lightning Network also has fewer payment exceptions for a more reliably smooth payment experience for both merchants and customers.
Payment Status Definitions
Created
The payment has been successfully created and is ready for processing.
Processing
A transaction for the payment has been observed on the blockchain and is awaiting necessary blockchain confirmations to be considered Completed (or Underpaid, Overpaid, etc.)
Completed
The customer sent the correct amount of cryptocurrency, the transaction has received the minimum necessary blockchain confirmations and the amount sent has been converted to the requested fiat settlement currency (if applicable).
Underpaid
The customer sent less crypto than the requested amount. Funds will not be converted and must be returned to the customer. Bead handles refunds on behalf of Merchants; however, if no customer email is provided at the time of payment, a customer email must be submitted via API or the Bead Portal to initiate the refund.
Overpaid
The customer sent more crypto than the requested amount. The requested amount will be converted and the payment is considered Completed from the Merchant perspective. The overpaid amount will not be converted and must be returned to the customer. Bead handles refunds on behalf of Merchants; however, if no customer email is provided at the time of payment, a customer email must be submitted via API or the Bead Portal to initiate the refund.
Expired
The payment expiry has elapsed and the payment is no longer accessible.
Invalid
An irregular event has occurred during the payment process. Funds received will not be converted and must be returned to the customer. Examples of Invalid payment scenarios include:
a transaction arriving after the quote has expired
multiple transactions being received
when a transaction cannot be converted for any reason
In almost all cases, funds must be returned to the customer. Bead handles refunds on behalf of Merchants; however, if no customer email is provided at the time of payment, a customer email must be submitted via API or the Bead Portal to initiate the refund.
Cancelled
The payment has been manually cancelled by the customer or Merchant from their Bead Portal) and the payment is no longer accessible.
PartiallyRefunded
One or more refunds have been issued to the customer and the total of all refunds is less than the original payment amount.
FullyRefunded
One or more refunds have been issued to the customer and the total of all refunds equal the original payment amount.
Compatible Wallets
Bead allows for crypto payments from any cryptocurrency wallet.
Last updated