# Payzah Cards API

- [Wasl B2B Cards API: Sell Digital Gift Cards and Vouchers](https://docs.gowasl.app/introduction.md): Learn how the Wasl Cards API lets merchants connect to a cards and vouchers platform to sell digital gift cards through their own sales channels.
- [Wasl Cards API: Getting Started with Integration](https://docs.gowasl.app/getting-started.md): Register your merchant account, obtain your private key and credentials, and make your first authenticated request to the Wasl Cards API in minutes.
- [Wasl Cards API: Core Concepts and Key Terminology](https://docs.gowasl.app/concepts.md): Understand the key building blocks of the Wasl Cards API — vendors, cards, balances, transactions, tokens, and the two integration environments.
- [Wasl Cards API: End-to-End Integration Request Flow](https://docs.gowasl.app/guides/request-flow.md): Walk through the complete Wasl Cards API sequence — from authentication and catalog caching to order placement and delivering card codes to customers.
- [Wasl Cards API Authentication and Session Tokens](https://docs.gowasl.app/guides/authentication.md): Learn how to obtain a session token, attach it to every API request, handle token expiry, and resolve authentication errors with the Wasl Cards API.
- [Wasl Cards API: Browse and Cache the Card Catalog](https://docs.gowasl.app/guides/card-catalog.md): Retrieve the full list of available gift cards and drill into per-vendor denominations, pricing, and multilingual names using the Wasl Cards API.
- [Placing Gift Card Orders with the Wasl Cards API](https://docs.gowasl.app/guides/placing-orders.md): Check available stock, initiate a card reservation, and confirm payment to receive card codes — a full order walkthrough for Wasl Cards API merchants.
- [Wasl Cards Console Panel: Replacements and Reports](https://docs.gowasl.app/guides/console-panel.md): Use the Wasl Cards Console Panel to replace faulty cards, view sales reports, and monitor transaction activity — all from the merchant dashboard.
- [Security Overview: Protecting Your Wasl Integration](https://docs.gowasl.app/security/overview.md): Learn how Wasl secures your API integration through token-based authentication, IP whitelisting, and strict data integrity controls.
- [Wasl API Error Codes: Causes and How to Fix Them](https://docs.gowasl.app/security/error-codes.md): A complete reference for all eight Wasl API error codes — what triggers each one and the exact steps to resolve it in your integration.
- [POST /api-service/card/login — Get Authorization Token](https://docs.gowasl.app/api-reference/authentication/get-token.md): Authenticate with the Wasl Cards API using your merchant credentials and receive a session token required for all subsequent requests.
- [GET /api-service/card/get-card-list — Get Card List](https://docs.gowasl.app/api-reference/cards/get-card-list.md): Retrieve the full catalog of available gift and prepaid card vendors, including their unique IDs and localized names in English and Arabic.
- [Get Card Details List — Wasl Cards API Reference](https://docs.gowasl.app/api-reference/cards/get-card-details.md): Fetch all available denominations for a specific card vendor, including localized names, pricing, and current stock levels for each denomination.
- [Get Card Balance Details — Wasl Cards API Reference](https://docs.gowasl.app/api-reference/cards/get-card-balance.md): Check the real-time available stock quantity for a specific card denomination before placing an order to avoid insufficient balance errors.
- [Initiate a Wasl Card Request: Reserve Cards for an Order](https://docs.gowasl.app/api-reference/orders/initiate-card-request.md): Reserve cards and receive a transaction_id to use in the confirm-order step. This call is required before any card order can be confirmed.
- [Confirm a Wasl Card Order and Retrieve Card Codes](https://docs.gowasl.app/api-reference/orders/confirm-order.md): Finalise a reserved card order by submitting your payment reference, and receive redeemable card codes and numbers ready for delivery to your customers.
- [Wasl Cards API Webhooks: Overview, Setup, and Security](https://docs.gowasl.app/api-reference/webhooks/overview.md): Understand how Wasl pushes real-time order and delivery events to your server via HTTP POST webhooks, and how to verify them securely.
- [Wasl Webhook: Order Delivery Status Update Events](https://docs.gowasl.app/api-reference/webhooks/status-update.md): Receive real-time order status changes, driver location, and tracking links as Wasl pushes delivery progress events to your webhook URL.
- [Wasl Webhook: Busy Mode Activation and Revocation](https://docs.gowasl.app/api-reference/webhooks/busy-mode.md): Handle Wasl busy mode webhook events so your integration automatically pauses order submissions when Wasl temporarily stops accepting new orders.
- [Wasl Webhook: Post-Order Creation Delivery Details](https://docs.gowasl.app/api-reference/webhooks/post-order-creation.md): Receive estimated pickup and delivery times, delivery fee, and distance immediately after Wasl successfully creates and assigns an order.
- [Wasl Webhook: Final Order Update After Completion](https://docs.gowasl.app/api-reference/webhooks/order-update.md): Receive the final delivery fee, distance, and full order details after Wasl marks an order as complete, for reconciliation and record-keeping.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.