3**# Integration flow**

1. API Authentication (Partner login):

Taly authenticates your API requests using your account’s authorization key. you have to include your token while making any API request/call and if you don’t add it or you send an incorrect/expired token Taly will return an error.

To get your token you need to call the Merchant login API using your login credentials

How to get your API username and password? please follow the below steps:-

Login to your merchant portal using the owner account (or you can ask the owner account to forward these details to you)
Navigate to "Keys" tab under settings
Copy your merchant username and password
use the copied username and password in login API to get your token

📘
You can practice and find more information about Login API , under API Reference tab

2. Calculate expected downpayment for On-Site Messaging:

When the customer is in the product detail page you need to show him the expected calculation for the downpayment for that product on your product banner

📘
Call this API Product banner calculator API, under API Reference tab you will find all the requirements

3. Create order (Initiate Order):

when the customer clicks “Place order” button you can initiate an order through taly by calling this API and pass through all the payment information in the request. The response will have OrderID, orderToken and checkout_url. Please retain the order token to fetch the information about the order later and then redirect the customer to checkout_url to complete the transaction via Taly

📘
You can practice and find more information about Initiate order API, under API Reference tab

4. Get Order details (Status, Details, & more):

This API is created to help you to check the order status after 30 minutes if you didn't get any response from us in case there is any network failure or the customer has decided to close the browser, and the redirection was not happened hence you will not know the order status until you get a response from our webhook if you integrate with it or you can call Get order details API to get the updated order status and other details

You can also call this API after the order gets completed to check the order status and other details if needed

📘
You can practice and find more information about Get order details API, under API Reference tab

5. Refunds:

The refund option is available on your Taly's partners portal where you can initiate a refund request directly for a specific order (login to the partners portal is required using your merchant user name and password)  If you you want to use your OMS (order management system) to initiate the refund request so you can use the below API to submit your request and get the response without interacting with our partners portal.

📘
You can practice and find more information about Refund API , under API Reference tab