Refunds

Caution

B4bit Pay does not currently expose a refund endpoint on the public API. Refunds are handled manually by the support team.

Why

Blockchain payments are irreversible. A “refund” is not a standard operation like with credit cards: it requires generating a new transaction from the merchant to the customer.

Current process

1. The customer requests a refund from the merchant through the usual channels (email, customer service).
2. The merchant writes to support@b4bit.com including:
   • identifier of the original payment (UUID).
   • reference of the order in your internal system.
   • Amount to refund (total or partial).
   • Customer’s blockchain address to receive the refund.
3. B4bit Pay support coordinates the refund by executing a manual transaction from the merchant’s balance to the customer’s address.
4. Record — save in your system a link between the original identifier and the refund transaction (blockchain tx hash) for traceability.

Tips

• Always save the reference on POST /orders/ in a format that lets you locate the order later (for example, your internal order ID).
• Ask the customer for the destination address on the same network where the original payment was received, to avoid bridging fees.
• Verify available balance in your merchant account before confirming the refund to the customer.

Roadmap

The ability to initiate refunds via API is under evaluation. Subscribe to the changelog to be notified when it ships.