Skip to main content
Add crypto as a payment method at checkout. Breet generates a unique wallet address per order, tracks the payment on-chain, and notifies your store when the transaction is confirmed so you can fulfill the order.

​
How it works

1

Generate an address for the order

When a customer selects crypto at checkout, call the generate-address endpoint with the order ID as the label. This creates a dedicated deposit address tied to that order.
2

Display payment instructions

Show the wallet address, expected amount, and a QR code on your checkout page. The customer sends crypto from any wallet.
3

Receive a webhook confirmation

Breet sends a webhook when the payment is confirmed on-chain. Match the deposit to the order using the label or destinationAddress.
4

Fulfill the order

Once the webhook confirms full payment, update the order status and begin fulfillment.
5

Settle funds (optional)

How funds are handled after a payment depends on your setup:
  • Without auto-settlement: payments are converted and held in your wallet in your chosen currency (USD, NGN, or GHS). You can view the balance on your dashboard and withdraw manually whenever you’re ready.
  • With per-address auto-settlement: each payment is automatically converted and paid out to the bank account linked to that specific address. Enable it via the API. See the auto-settlement guide.
  • With business-wide auto-settlement: all payments across all addresses are automatically withdrawn to a single destination (bank account or stablecoin address). Enable it from your dashboard under Settings > Automatic Settlement.
You can set your preferred holding currency from the dashboard under Settings > Crypto Settings.

​
Generate an address per order

curl -X POST "https://api.breet.io/v1/trades/sell/assets/ASSET_ID/generate-address" \
  -H "x-app-id: YOUR_APP_ID" \
  -H "x-app-secret: YOUR_APP_SECRET" \
  -H "X-Breet-Env: production" \
  -H "Content-Type: application/json" \
  -d '{"label": "order-98765"}'
Replace ASSET_ID with a supported asset you want to accept for this order. The label field ties the address to your order ID, making reconciliation straightforward when the webhook arrives.
Generate a fresh address for every order. This makes it easy to match payments to orders without relying on amount matching.

​
What Breet handles

  • Generating unique wallet addresses per order
  • Monitoring blockchains for incoming payments
  • Sending webhook notifications with payment details
  • Converting crypto to local fiat via auto-settlement
  • Payouts to your business bank account

​
What you handle

  • Adding crypto as a payment option in your checkout flow
  • Displaying the wallet address, amount, and QR code to the customer
  • Listening for and processing webhook events
  • Matching payments to orders using the label or address
  • Handling order fulfillment after payment confirmation
  • Managing underpayments or overpayments in your order logic

​
Example user journey

  1. Fatima adds items to her cart on an online store and proceeds to checkout.
  2. She selects Pay with crypto and chooses USDT on Solana.
  3. The store calls Breet’s generate-address endpoint with label: "order-98765" and displays the wallet address with the amount due.
  4. Fatima sends the exact USDT amount from her wallet.
  5. Breet detects the payment and sends a trade.completed webhook to the store’s server.
  6. The store matches the webhook to order 98765, marks it as paid, and begins shipping.
  7. The crypto payment is held in the store’s wallet balance (or auto-settled to the store’s bank account if enabled).

​
FAQ

Yes. Each call to the generate-address endpoint returns a unique wallet address. Pass your order ID in the label field so incoming payments are automatically mapped to the correct order when the webhook fires.
Breet reports the exact amount received in the webhook payload. If the amount is less than the order total, the webhook still fires with the partial amount. Your application should compare the received amount against the order total and decide how to handle it. You can prompt the customer to send the remaining balance, or cancel the order based on your business rules.
Yes. Crypto payments are borderless by nature. Any customer with a crypto wallet can send funds to the generated address regardless of their location. No additional configuration is needed for international payments.
Blockchain confirmation times vary by network. Fast networks like Solana typically confirm in seconds, while Bitcoin may take 5–60 minutes. Use the trade.pending webhook to show the customer that their payment has been detected, and trade.completed to confirm it. Consider setting a reasonable timeout and allowing customers to retry if the payment window expires.