# Almara Pay Documentation

## Docs
- [Introduction](https://docs.transalink.io/introduction-2117710m0.md): 
- Definitions [Data Types](https://docs.transalink.io/data-types-2117711m0.md): 
- Definitions [Error Codes](https://docs.transalink.io/error-codes-2117712m0.md): 
- Definitions [MCCMNC Codes](https://docs.transalink.io/mccmnc-codes-2117713m0.md): 
- Authorization [Overview](https://docs.transalink.io/overview-2117714m0.md): 
- Payouts [Overview](https://docs.transalink.io/overview-2117715m0.md): 
- Payouts [Payment Order Request Information](https://docs.transalink.io/payment-order-request-information-2117716m0.md): 
- Payouts > Mobile Money Requests [Overview](https://docs.transalink.io/overview-2117717m0.md): 
- Pay-Ins > Payment Links [Overview](https://docs.transalink.io/overview-2117718m0.md): 
- Pay-Ins > Express Deposits [Overview](https://docs.transalink.io/overview-2117719m0.md): 
- Pay-Ins > C2B IPN (Callback) [C2B IPN Overview](https://docs.transalink.io/c2b-ipn-overview-2117720m0.md): 
- Card Payments [Overview](https://docs.transalink.io/overview-2117721m0.md): 
- Account Validation [Overview](https://docs.transalink.io/overview-2117722m0.md): 
- Platform Services > Airtime Purchase [Overview](https://docs.transalink.io/overview-2117723m0.md): 
- Platform Services > Bill Payments [Overview](https://docs.transalink.io/overview-2117724m0.md): 

## API Docs
- Authorization [Token Request](https://docs.transalink.io/token-request-34512096e0.md): The Almara Pay API uses [OAuth2.0](https://oauth.net/2/) authentication and this requires `client_id`, `client_secret`, `grant_type`, `scope`. 
- Authorization [Find Transaction Routes](https://docs.transalink.io/find-transaction-routes-34512097e0.md): # <a href="#transaction-routes-1"></a>
- Authorization [Health Check](https://docs.transalink.io/health-check-34512098e0.md): Ensures the functionality of all the API endpoints
- Payouts > Mobile Money Requests [Mobile Transfers- Safaricom (M-Pesa)](https://docs.transalink.io/mobile-transfers-safaricom-m-pesa-34512103e0.md): Almara Pay supports outbound payments (B2C) via Mobile Transfers to M-Pesa wallets.
- Payouts > Mobile Money Requests [Mobile Transfers - Airtel Money](https://docs.transalink.io/mobile-transfers-airtel-money-34512104e0.md): Almara Pay supports outbound payments (B2C) via Mobile Transfers to Airtel Money wallets.
- Payouts [Payment Order Requests - Business  Transfers](https://docs.transalink.io/payment-order-requests-business-transfers-34512099e0.md): Description
- Payouts [Payment Order Requests - Bank  Transfers](https://docs.transalink.io/payment-order-requests-bank-transfers-34512100e0.md): Description
- Payouts [Find Payment Order By OriginatorConversationId](https://docs.transalink.io/find-payment-order-by-originatorconversationid-34512101e0.md): This request retrieves the status of a payment order.
- Payouts [Reject Order By OriginatorConversationId](https://docs.transalink.io/reject-order-by-originatorconversationid-34512102e0.md): This request is used to reject an order already posted using a specified `originatorConversationId`
- Pay-Ins > Payment Links [Create Payment Link](https://docs.transalink.io/create-payment-link-34512105e0.md): `ShortCode:` Unique identifier for the C2B
- Pay-Ins > Payment Links [Find Payment Links By Id](https://docs.transalink.io/find-payment-links-by-id-34512106e0.md): 
- Pay-Ins > Payment Links [Update Payment Link](https://docs.transalink.io/update-payment-link-34512107e0.md): `id:` The payment link Id generated
- Pay-Ins > Express Deposits [Express Deposit Request](https://docs.transalink.io/express-deposit-request-34512108e0.md): **\===========================================================================**
- Pay-Ins > Express Deposits [Find Express Deposit By OriginatorConversationId](https://docs.transalink.io/find-express-deposit-by-originatorconversationid-34512109e0.md): This request retrieves the status of an express deposit order.
- Card Payments [Checkout Order Request](https://docs.transalink.io/checkout-order-request-34512110e0.md): **Note:** A valid token is required for authentication as it expires after every hour. Refer to `Token Request` to generate a new **token.**
- Card Payments [Query Checkout Request](https://docs.transalink.io/query-checkout-request-34512111e0.md): This endpoint describes how to query a  merchant initiated checkout request. 
- Card Payments [Checkout Callback Request](https://docs.transalink.io/checkout-callback-request-34512112e0.md): This document describes how to handle merchant-provided URL callbacks. 
- Account Validation [Account Number Validation Request](https://docs.transalink.io/account-number-validation-request-34512113e0.md): This is a POST request that is responsible for validation of an account number.
- Account Validation [Find KYC  Status by SystemTraceAuditNumber](https://docs.transalink.io/find-kyc-status-by-systemtraceauditnumber-34512114e0.md): Retrieves the status of a KYC request using the SystemTraceAuditNumber.
- Account Validation [Account Validation](https://docs.transalink.io/account-validation-34512115e0.md): This endpoint performs customer identity verification using provided KYC details.
- Account Validation [Find Account Validation Status by SystemTraceAuditNumber](https://docs.transalink.io/find-account-validation-status-by-systemtraceauditnumber-34512116e0.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.
- Platform Services > Airtime Purchase [Airtime Purchase](https://docs.transalink.io/airtime-purchase-34512117e0.md): This is a POST request that is responsible for airtime purchases.
- Platform Services > Airtime Purchase [Find Airtime Purchases By OriginatorConversationId](https://docs.transalink.io/find-airtime-purchases-by-originatorconversationid-34512118e0.md): This is a **GET** request that returns the status of an airtime purchase request.
- Platform Services > Customer Accounts [Balance Check](https://docs.transalink.io/balance-check-34512119e0.md): This request allows you to retrieve your total balance and balance information from your wallet.
- Platform Services > Customer Accounts [Find Charges By TransactionTypeId](https://docs.transalink.io/find-charges-by-transactiontypeid-34512120e0.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.
- Platform Services > Bill Payments [Bill Request Validation](https://docs.transalink.io/bill-request-validation-34512121e0.md): This is a POST request that is responsible for initiating a Bill  Request Validation.
- Platform Services > Bill Payments [Bill Request Payment](https://docs.transalink.io/bill-request-payment-34512122e0.md): This is a POST request that is responsible for initiating a Bill  Request Payment.
- Platform Services > Bill Payments [Find Bill Services](https://docs.transalink.io/find-bill-services-34512123e0.md): This is a GET request that  Retrieves a list of available bill payment services and supported billers.
- Platform Services > Bill Payments [Find Bill Number By Service Id and Account Number](https://docs.transalink.io/find-bill-number-by-service-id-and-account-number-34512124e0.md): This is a <strong>GET</strong> request that returns the saved billing information using the `ServiceId` and `AccountNumber` <br>
- Platform Services > Bill Payments [Find Bill Request By Originator Converstion Id](https://docs.transalink.io/find-bill-request-by-originator-converstion-id-34512125e0.md): This is a **GET** request that  retrieves the status of bill payment request using the OriginatorConversationId.
- Platform Services > Bill Payments [Bill Number](https://docs.transalink.io/bill-number-34512126e0.md): This is a POST request that is responsible for saving billing information for a particular service.