# Mizaniya Pay

> Accept CIB and Edahabia card payments in DZD with the Mizaniya Pay Payment Gateway API.

- [Accept card payments with Mizaniya Pay](https://pg-docs.mizaniyapay.dz/index.md): Register a payment, send your customer to our hosted checkout, and get the result by webhook. Your server never touches card data.
- [Quickstart](https://pg-docs.mizaniyapay.dz/quickstart.md): Register your first payment and receive the result in five steps.
- [Authentication](https://pg-docs.mizaniyapay.dz/authentication.md): Authenticate every request with your API key in the x-api-key header.
- [Request & response format](https://pg-docs.mizaniyapay.dz/request-and-response.md): Conventions for bodies, amounts, dates, tracing, versioning and error handling.
- [The payment flow](https://pg-docs.mizaniyapay.dz/concepts/payment-flow.md): Four parties, one simple flow. You call two endpoints; Mizaniya Pay handles the card, the OTP and the bank.
- [Payment statuses](https://pg-docs.mizaniyapay.dz/concepts/payment-statuses.md): Lifecycle of a payment and what to do in each status.
- [Amounts and fees](https://pg-docs.mizaniyapay.dz/concepts/amounts-and-fees.md): All amounts are in centimes. Understand amount, fees and total.
- [Webhooks](https://pg-docs.mizaniyapay.dz/webhooks/overview.md): Get notified when a payment reaches a status you must act on. No polling needed.
- [Verify the signature](https://pg-docs.mizaniyapay.dz/webhooks/verify-signature.md): Check that a webhook really comes from Mizaniya Pay using HMAC-SHA256.
- [Webhook events](https://pg-docs.mizaniyapay.dz/webhooks/events.md): The events we send and what to do for each.
- [Test mode](https://pg-docs.mizaniyapay.dz/testing/test-mode.md): Integrate safely with a pk_test key. No card is charged and no money moves.
- [Test cards and OTP codes](https://pg-docs.mizaniyapay.dz/testing/test-cards-and-otp.md): Simulate every payment outcome in test mode.
- [Register a payment](https://pg-docs.mizaniyapay.dz/api-reference/register-payment.md): Creates a payment and returns the hosted checkout link.
- [Get a payment](https://pg-docs.mizaniyapay.dz/api-reference/get-payment.md): Returns the current status and, once final, the result to reconcile against.
- [Download the receipt](https://pg-docs.mizaniyapay.dz/api-reference/download-receipt.md): PDF receipt of a successful payment, in the language chosen at registration.
- [Email the receipt](https://pg-docs.mizaniyapay.dz/api-reference/email-receipt.md): Emails the receipt of a successful payment to an address you provide. Limited to 20 per hour.
- [API errors](https://pg-docs.mizaniyapay.dz/errors/api-errors.md): HTTP errors and their errorCode. Branch on errorCode, never on message.
- [Payment failure codes](https://pg-docs.mizaniyapay.dz/errors/payment-failure-codes.md): Codes returned in error.code when a payment fails, with a suggested message for the payer.


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