# Blockra

> Accept crypto payments with the Blockra API.

## Docs

- [POST /checkout/sessions — Create a Checkout Session](https://docs.blockra.io/api-reference/create-checkout-session.md): Create a Blockra hosted checkout session and get a redirect URL for your buyer. Accepts amount, currency, label, reference, email, and redirect URLs.
- [Create a Crypto Payment — POST /payments](https://docs.blockra.io/api-reference/create-payment.md): Create a crypto payment for a fiat amount. Blockra locks the exchange rate, generates a deposit address, and returns deposit details to show your buyer.
- [Create a Payment Link — POST /payment-links](https://docs.blockra.io/api-reference/create-payment-link.md): Create a reusable, shareable payment link for a fixed or buyer-chosen amount. Requires payment_links:write.
- [Create a Webhook Endpoint — POST /webhooks](https://docs.blockra.io/api-reference/create-webhook.md): Register an endpoint to receive payment events. The signing secret is returned once, here. Requires webhooks:write.
- [Request a Withdrawal — POST /withdrawals](https://docs.blockra.io/api-reference/create-withdrawal.md): Withdraw your balance to an external wallet. Blockra deducts the payout and network fee, then signs and broadcasts. Requires withdrawals:write.
- [Delete a Webhook Endpoint — DELETE /webhooks/{id}](https://docs.blockra.io/api-reference/delete-webhook.md): Remove a webhook endpoint so it stops receiving events. Requires webhooks:write.
- [Get Balance — GET /balance](https://docs.blockra.io/api-reference/get-balance.md): Read your available and pending balance per coin, with live USD estimates and a 30-day series. Requires balance:read.
- [Retrieve a Customer — GET /customers/{id}](https://docs.blockra.io/api-reference/get-customer.md): Fetch a single customer by ID, including lifetime totals and their most recent payments. Requires customers:read.
- [Retrieve a Payment by ID — GET /payments/{id}](https://docs.blockra.io/api-reference/get-payment.md): Fetch a single payment by its ID. Returns the full payment object including status, deposit details, fiat breakdown, and on-chain confirmation count.
- [List Customers — GET /customers](https://docs.blockra.io/api-reference/list-customers.md): Retrieve a paginated, filterable list of the customers who have paid you. Filter by email, order count, total spent, and date. Requires customers:read.
- [List Payment Links — GET /payment-links](https://docs.blockra.io/api-reference/list-payment-links.md): Page through your payment links with filters and sorting. Requires payment_links:read.
- [List All Payments — GET /payments](https://docs.blockra.io/api-reference/list-payments.md): Retrieve a paginated, filterable list of your Blockra payments. Filter by status, asset, date range, and amount. Requires the payments:read scope.
- [List Webhook Endpoints — GET /webhooks](https://docs.blockra.io/api-reference/list-webhooks.md): Page through your registered webhook endpoints. Secrets are never returned. Requires webhooks:read.
- [List Withdrawals — GET /withdrawals](https://docs.blockra.io/api-reference/list-withdrawals.md): Retrieve your most recent withdrawals, newest first. Requires withdrawals:read.
- [Update a Payment Link — PATCH /payment-links/{id}](https://docs.blockra.io/api-reference/update-payment-link.md): Enable or disable a payment link. Requires payment_links:write.
- [Blockra API Authentication: API Keys, Scopes & Rate Limits](https://docs.blockra.io/authentication.md): Blockra uses secret API keys prefixed bk_ to authenticate requests. Learn how to create a key, pass it in requests, and manage scopes.
- [Blockra API Error Handling: Codes, Envelope & Examples](https://docs.blockra.io/errors.md): Every Blockra API response uses a consistent envelope. Learn how to handle errors by HTTP status and error code with practical examples.
- [How to Accept Crypto Payments Using the Blockra API](https://docs.blockra.io/guides/accept-payments.md): Learn how to create a payment, display a deposit address to your customer, and track the payment status through to completion using the Blockra API.
- [Integrate Blockra Hosted Checkout for Crypto Payments](https://docs.blockra.io/guides/hosted-checkout.md): Create a Blockra checkout session and redirect your buyer to a hosted payment page. Blockra handles coin selection, deposit UI, and confirmation.
- [Blockra: Accept Crypto Payments via REST API Overview](https://docs.blockra.io/introduction.md): Blockra is a crypto payment gateway. Create a charge, show the buyer a deposit address, and receive net fiat once the payment confirms on-chain.
- [Receive and Verify Blockra Webhook Event Notifications](https://docs.blockra.io/webhooks.md): Register an HTTPS endpoint to receive real-time Blockra payment events. Includes signature verification examples in Node.js and Python.