Tracking orders

After creating a checkout session, you may want to track the status of the order in your own system. There are two mechanisms for this: the partner order identifier and webhooks.

Partner order identifier

Pass a partnerOrderIdentifier when creating the checkout session to link the BTC Direct order to your internal reference:

{
  "baseCurrency": "BTC",
  "quoteCurrency": "EUR",
  "paymentMethod": "creditCard",
  "quoteCurrencyAmount": 50,
  "walletAddress": "bc1...",
  "partnerOrderIdentifier": "your-internal-order-id-123"
}

This identifier is included in all webhook notifications for this order, making it easy to correlate events with your system.

Webhooks

To receive real-time status updates on orders, set up webhooks. BTC Direct sends HTTP POST requests to your configured endpoint when events occur (order created, paid, completed, cancelled, etc.).

Contact your account manager to configure webhooks for your account. See Webhooks for the full list of events and how to verify signatures.

Recommended approach

1. Generate a unique identifier in your system before creating the checkout.
2. Pass it as partnerOrderIdentifier in the checkout request.
3. Set up webhooks to receive order status updates with your identifier included.