# ZamuPay API Documentation

## Docs
- [Zamupay overview](https://docs.zamupay.com/zamupay-overview-1908307m0.md): 

## API Docs
- [Token Request](https://docs.zamupay.com/token-request-25375890e0.md): The ZamuPay API uses [OAuth2.0](https://oauth.net/2/) authentication and this requires `client_id`, `client_secret`, `grant_type`, `scope`. These **parameters** are provided once one is setup in the **ZamuPay System**. `Token Request` is a POST request responsible for returning the bearer token that is required for all the requests that are to be made. For this the required details are: `client_id`, `client_secret`, `grant_type`, `scope`
- [Payment Order Request](https://docs.zamupay.com/payment-order-request-25375891e0.md): **Note:** A valid token is required for authentication as it expires after every hour. Refer to `Token Request` to generate a new **token.**
- [Reject Order By OriginatorConversationId](https://docs.zamupay.com/reject-order-by-originatorconversationid-25375892e0.md): This request is used to reject an order already posted using a specified `originatorConversationId`
- [Express Deposit Request](https://docs.zamupay.com/express-deposit-request-25375893e0.md): **\===========================================================================**
- [Find Payment Order By OriginatorConversationId](https://docs.zamupay.com/find-payment-order-by-originatorconversationid-25375894e0.md): This request returns an order based on the `Id` which is the unique identifier that you provide with every `PostPaymentOrder` request together with the `IdType` which specifies the type of the Id to be passed. For this case `IdType` will be the **OriginatorConversationId**.
- [Find Express Deposit By OriginatorConversationId](https://docs.zamupay.com/find-express-deposit-by-originatorconversationid-25375895e0.md): This request returns an order based on the `OriginatingConversationId` which is the unique identifier that you provide with every `Post Express Deposit` request.
- [Bill Number](https://docs.zamupay.com/bill-number-25375896e0.md): This is a POST request that is responsible for saving billing information for a particular service.
- [Find Bill Number By Service Id and Account Number](https://docs.zamupay.com/find-bill-number-by-service-id-and-account-number-25375897e0.md): This is a <strong>GET</strong> request that returns the saved billing information using the `serviceId` and `accountNumber` <br>
- [Find Transaction Routes](https://docs.zamupay.com/find-transaction-routes-25375898e0.md): # <a href="#transaction-routes-1"></a>
- [Find Charges By TransactionTypeId](https://docs.zamupay.com/find-charges-by-transactiontypeid-25375899e0.md): This request returns the charges for a particular `Transaction Type`. It uses the `transactionTypeId` as the parameter obtained when querying [Find Transaction Routes](#transaction-routes) request.
- [Bill Request](https://docs.zamupay.com/bill-request-25375900e0.md): This is a POST request that is responsible for initiating an Express Deposit request.
- [Find Bill Request By Originator Converstion Id](https://docs.zamupay.com/find-bill-request-by-originator-converstion-id-25375901e0.md): This is a **GET** request that returns the status of a bill payment transaction.  
- [Find Bill Services](https://docs.zamupay.com/find-bill-services-25375902e0.md): This is a POST request that is responsible for initiating an Express Deposit request.
- [Account Number Validation Request](https://docs.zamupay.com/account-number-validation-request-25375903e0.md): This is a POST request that is responsible for validation of an account number.
- [Find Account Validation Status by SystemTraceAuditNumber](https://docs.zamupay.com/find-account-validation-status-by-systemtraceauditnumber-25375904e0.md): This is a **GET** request that is used to check the status of an Account Validation Request using a generated `SystemTraceAuditNumber` by the consumer.
- [Airtime Purchase](https://docs.zamupay.com/airtime-purchase-25375905e0.md): This is a POST request that is responsible for airtime purchases.
- [Find Airtime Purchases By OriginatorConversationId](https://docs.zamupay.com/find-airtime-purchases-by-originatorconversationid-25375906e0.md): This is a **GET** request that returns the status of an airtime purchase request.
- [Health Check](https://docs.zamupay.com/health-check-25375907e0.md): Ensures the functionality of all the API endpoints
- [Create Payment Link](https://docs.zamupay.com/create-payment-link-25375908e0.md): `ShortCode:` Unique identifier for the C2B
- [Find Payment Links By Id](https://docs.zamupay.com/find-payment-links-by-id-25375909e0.md): 
- [Update Payment Link](https://docs.zamupay.com/update-payment-link-25375910e0.md): `id:` The payment link Id generated
- [KYC Validation](https://docs.zamupay.com/kyc-validation-25375911e0.md): | Field Name | **Data Type** | State |
- [KYC Validation](https://docs.zamupay.com/kyc-validation-25375912e0.md): ## Sample success response
- [Balance Check](https://docs.zamupay.com/balance-check-25375913e0.md): This request allows you to retrieve your total balance and balance information from your wallet.