# XPayLabs

## Docs

- [HMAC-SHA256 Request Signing — XPayLabs API Authentication](https://docs.xpaylabs.com/api-reference/authentication.md): Complete reference for computing HMAC-SHA256 signatures to authenticate XPayLabs API requests, including the signing algorithm and per-request fields.
- [XPayLabs API Error Codes and How to Handle Them](https://docs.xpaylabs.com/api-reference/errors.md): XPayLabs returns structured error responses with HTTP-compatible status codes. Learn the error format, common codes, and how to handle failures.
- [Create a Collection Order | POST /v1/order/createCollection](https://docs.xpaylabs.com/api-reference/order/create-collection.md): Create a collection order to receive crypto payments. Returns a unique deposit address and checkout URL for the customer to send funds.
- [Create a Payout Order | POST /v1/order/createPayout](https://docs.xpaylabs.com/api-reference/order/create-payout.md): Initiate a payout from your gateway wallet to an external blockchain address. Requires a valid receive address for the specified chain.
- [Get Compact Order Status | GET /v1/order/getOrderStatus](https://docs.xpaylabs.com/api-reference/order/order-status.md): Quickly retrieve just the status of an order by orderId and sign. Returns only the PaymentOrderStatus object for lightweight polling.
- [Get Pay Link Details | GET /v1/order/pay](https://docs.xpaylabs.com/api-reference/order/pay-link.md): Retrieve checkout details for a collection order, including the deposit address, amount, and current status. Used to render the customer-facing checkout page.
- [Get Order Status | GET /v1/order/status/{orderId}](https://docs.xpaylabs.com/api-reference/order/status.md): Retrieve the full status and details of an order by its orderId. Returns the NotifyOrder object with status, amount, transaction info, and fee.
- [XPayLabs REST API Reference — Concepts & Structure](https://docs.xpaylabs.com/api-reference/overview.md): The XPayLabs API is a REST API with JSON request/response bodies secured by HMAC-SHA256 signing. Learn about the base URL, request format, response shape, and rate limits.
- [List Supported Symbols | GET /v1/symbol/supportSymbols](https://docs.xpaylabs.com/api-reference/symbols/support-symbols.md): Retrieve the list of supported blockchain tokens configured on your gateway. Filter by chain or symbol to narrow results.
- [XPayLabs Webhook Event Types — Complete Reference](https://docs.xpaylabs.com/api-reference/webhooks/events.md): Complete reference for all XPayLabs webhook event types — order events (PENDING, SUCCESS, EXPIRED, FAILED) and collection events (PENDING, SUCCESS, FAILED).
- [Webhook Notifications — XPayLabs Event Callbacks Reference](https://docs.xpaylabs.com/api-reference/webhooks/overview.md): XPayLabs delivers signed webhook callbacks to your configured endpoint URL when order or collection status changes. Learn how to configure endpoints and verify payloads.
- [Authenticate API Requests with HMAC-SHA256 Signatures](https://docs.xpaylabs.com/authentication.md): XPayLabs uses HMAC-SHA256 request signing for API authentication. Learn how to compute the sign field with your merchant token for secure API calls.
- [XPayLabs API Error Handling — Codes, Causes, and Solutions](https://docs.xpaylabs.com/concepts/errors.md): XPayLabs returns structured error responses with HTTP status codes. Learn about common error scenarios, validation failures, and how to handle them gracefully.
- [Understanding Collection Orders — The Core of XPayLabs Payments](https://docs.xpaylabs.com/concepts/payments.md): Learn how XPayLabs models payment collection: the lifecycle of a collection order from creation to on-chain confirmation, order statuses, and the PaymentAddress object.
- [Automatic Fund Settlement — Hot-to-Cold Wallet Sweeps](https://docs.xpaylabs.com/concepts/settlements.md): XPayLabs automatically sweeps received funds from hot wallets to your configured cold storage addresses. Learn about the settlement flow, timing, and configuration.
- [XPayLabs Webhooks — Real-Time Blockchain Payment Notifications](https://docs.xpaylabs.com/concepts/webhooks.md): XPayLabs sends signed HTTP callbacks to your server when on-chain payment events occur. Learn how webhooks work, the payload format, and how to verify signatures.
- [XPayLabs FAQ — Self-Hosted Crypto Payment Infrastructure](https://docs.xpaylabs.com/faq.md): Answers to common questions about XPayLabs — from deployment and configuration to supported chains, webhooks, and security.
- [Accept Crypto Payments with XPayLabs Collection Orders](https://docs.xpaylabs.com/guides/accept-payments.md): Step-by-step guide to accepting stablecoin payments via XPayLabs. Create a collection order, generate a checkout page, and handle the webhook callback.
- [Crypto Payments for AI Agents](https://docs.xpaylabs.com/guides/ai-agents.md): Enable your AI agents to send and receive stablecoin payments autonomously using XPayLabs. Non-custodial, self-hosted payment infrastructure for agentic workflows.
- [Node.js Integration with XPayLabs Node.js SDK](https://docs.xpaylabs.com/guides/nodejs-integration.md): Integrate crypto payments into your Node.js application using the official @xpaylabs/node-sdk package. Includes npm setup, configuration, webhook handling, and full API examples.
- [Send Crypto Payouts with XPayLabs Payout Orders](https://docs.xpaylabs.com/guides/payouts.md): Learn how to send crypto payments from your gateway wallet to external blockchain addresses using the XPayLabs payout API.
- [Spring Boot Integration with XPayLabs Java SDK](https://docs.xpaylabs.com/guides/spring-boot-integration.md): Integrate crypto payments into your Spring Boot application using the official XPayLabs Java SDK. Includes Maven setup, configuration, webhook handling, and full API examples.
- [Test Your XPayLabs Integration with Testnet Networks](https://docs.xpaylabs.com/guides/testing.md): Test your XPayLabs payment integration using blockchain testnets. Configure testnet endpoints, get faucet tokens, and verify the complete collection-to-webhook flow.
- [XPayLabs: Self-Hosted Crypto Payment Infrastructure](https://docs.xpaylabs.com/introduction.md): XPayLabs is a self-hosted, non-custodial crypto payment infrastructure. Deploy on your own servers to accept stablecoin payments across TRON, EVM chains, and SUI with zero gateway fees.
- [Deploy XPayLabs and Create Your First Collection in Under 15 Minutes](https://docs.xpaylabs.com/quickstart.md): Learn how to deploy XPayLabs with Docker Compose, configure your merchant token, and create your first crypto payment collection via the REST API.
- [Troubleshoot XPayLabs Gateway and Integration Issues](https://docs.xpaylabs.com/troubleshooting.md): Diagnose and resolve common issues with XPayLabs — including signature errors, connection problems, scanner issues, and webhook failures.