Payout Integration Guide

Paytm Payouts is feature-rich and simple to use payout service that enables businesses to send money to recipients in their wallets or directly in their bank accounts using Paytm dashboard or APIs.

Note: Paytm Payouts is available only to enterprise customers. Get in touch to request access to Paytm Payouts.

1. Add funds to the Funding Account using IMPS/NEFT/RTGS.
2. Create sub-accounts also known as Disbursal Accounts to organize funds and secure any manual payments.
3. Start making payments using Paytm Dashboard or APIs.

Funding Account

This is an account provided to every business and has a unique account number and IFSC code. You can use these account details to transfer money to this funding account.

Disbursal Account

This is a sub-account that can be created from Paytm Dashboard. You can create any number of disbursal accounts. You can transfer funds to disbursal account from funding account and you can also claim back funds from disbursal accounts into funding account.

Disbursal accounts help to:

• Organize your funds - Example: As a business, you can create different disbursal accounts for different departments and purposes and transfer funds per assigned budgets.
• Secure your payments - Every disbursal account comes with built-in maker-checker functionality. You can assign access to different users to make payments and to approve these payment requests.

Note: Approvers will only need to approve payments done from Paytm Dashboard. Payments done using APIs do not need additional approvals.
Payments cannot be done from the funding account directly for security reasons. It can only be done from disbursal accounts.

1. Merchant transfers money to Funding Account. Account number and IFSC code details are available on Paytm Dashboard.

2. Merchant logs in Paytm Dashboard to ensure fund availability and transfer funds to Disbursal Account to be used for making payments.

3. Use Bank Transfer API or Wallet Transfer API to initiate a payment request. Checksumhash is required for making payment request to ensures that the request wasn't tampered in transit.

   Note: API keys to generate/verify checksumhash are available on Paytm dashboard. Also, please work with our Merchant Integration team to make sure your IPs are whitelisted.

4. Paytm will validate the request and initiate payment if the validation is successful.

5. Once the payment is complete, status is posted on the merchant provided callback URL in the payment request.

   Note: Please work with our Merchant Integration team and your network team to make sure our public IPs are whitelisted on your network in order to receive callback request.

6. Verify checksumhash received in response to ensure response wasn't tampered and verify the status with Disbursal Status API.

7. Paytm returns the payment status in API response.

8. Verify and record payment status in your system.

Find the detailed interaction of each system component in the flowchart below:
 

Once the test payments are complete in the staging environment, move your code to live environment with production account details. Note that production accounts details are available on Paytm Dashboard. As mentioned above, please make sure that IP whitelisting rules are in place before going live.

In case of any issues with integration, please get in touch.

Paytm Payouts now provides webhook for listening the order status when a reversal takes place, you can integrate the same by visiting the link to perform your house-keeping jobs in your organisation.

Paytm is now providing APIs to its merchant to be used for their funding and disbursal needs . Once you have signed up at our merchant site, you will be able to use the following APIs as per your usecase.