Start Building with PaytmPaytm Payment Gateway provides a secure, PCI-compliant way to accept Debit/Credit card, Net-Banking, UPI and Paytm wallet payments from your customers.
Understanding account credentials
Account credentials are available in your dashboard for both staging and production environment. These credentials consist of -
- MID (Merchant ID) - This is a unique identifier provided to every merchant by Paytm. MID is part of your account credentials and is different on staging and production environment. Your staging MID is available here and production MID will be available once your activation is complete.
- Merchant Key - This is a unique secret key used for secure encryption of every request. This needs to be kept on server side and should not be shared with anyone.
The Paytm Dashboard is a single window to manage your account -
Activate account to start accepting payments
Generate your staging and production account credentials
Switch views between staging and production transaction data
Check payments received from your customers
Check bank transfers Paytm makes into your account
Initiate refunds if you need to
Download all kinds of transaction reports
Fundamentals of collecting payments with Paytm:
- Your customer clicks on Pay button in your web/mobile application.
- Customer is shown a checkout form where she fills her payment details and authorizes the payment.
- After completion of transaction, Paytm posts the response (success or failed) on a Callback URL defined by you.
- As a recommended security measure, you validate each transaction response via a server-to-server (S2S) API call. Transaction revalidation protects from request/response tampering possible in browser calls. This S2S call is not required for Paytm plugins and hosted e-commerce website integration solutions.
- Based on the response received, you display order status to customer.
- See a real-time summary of payments received and other insights in your dashboard.
- Receive payments collected from customers in your bank account on next business day.
Detailed Payment Flow Explained
When a transaction request is received at Paytm's server, there are multiple validations carried out like valid source of request, structure of request, uniqueness of request etc. Once these validations are passed, a transaction is created.
Customer fills basic payment details to authorize the payment. Once the authorization is successful, money is debited from customer’s account. This transaction is a successful transaction.
If the customer drops out from the payment process or in the event of payment authorization failure, money is not deducted from customer’s account. This is marked as failed transaction.
Sometimes Paytm doesn't receive real-time transaction status from the bank. This can be due to many reasons such as network issues, technical errors at customer's/bank's end etc. This is marked as pending transaction. Refer this for detailed handling of pending transaction.
Payments received against successful transactions are credited into your bank account on T+1, where T is the date of successful transaction. Once the payment is credited, corresponding transaction is marked as Settled.
Sometimes there are use cases where you need to reverse payments for successful or settled transactions. The reversal transaction of a successful or settled payment is called refund transaction. Refer Refunds for more details.