Large Payment Collection

1. Merchant creates a VAN against an entity which could be an individual, business, or a group of individual/business from which payments need to be collected and reconciled. The entity can also be an invoice for which the payment needs to be received.
2. Merchant distributes the VAN to their respective customer. In case, the VAN is generated for Customer A, then it should only be distributed to Customer A.
3. Customer adds the VAN as a beneficiary with his bank. Once added, the customer can make as many transfers to the merchant.
4. On receiving each transfer, the merchant will be notified of the transfer with the entity details. Transfer and entity details will be available in the daily reports.
5. On T+1, the merchant will receive the settlement against all the transfers received on VANs generated by them.
6. If the merchant wants to return the partial or complete amount to the customer, they can initiate a refund.
7. Once the use case of accepting payment from the entity is complete, the merchant can disable(close) the VAN to avoid any further collections.

Third-Party Validation (TPV)

Third-Party Validation helps in securing transactions made in the Banking, Financial Services and Insurance (BFSI segment). Merchants in the BFSI segments are prone to cases of cybercrimes, asset appropriation, identity thefts, money laundering, accounting frauds etc. In order to reduce the risk, the Securities and Exchange Board of India (SEBI) requires that all payments made to BFSI merchants should be made from bank accounts that are already registered with the merchant. The bank account can be provided by the customer at the time of registration or enrollment for the scheme offered by the merchant.

Merchants can add Bank Accounts or TPVs to a given VAN for TPV check at the time of VAN creation using the Create VAN API. Bank Accounts or TPVs can be added post VAN creation using the Update VAN API.  A maximum of 10 Bank Accounts can be Active at any point in time during the VAN lifecycle. Incoming payments are accepted only when a customer makes payments from pre-registered Bank Account or TPVs. All payments originating from non-TPV Bank Accounts are rejected. Therefore, Paytm Payment Gateway is able to secure transactions for BFSI merchant.

Creation of VAN

VAN is the virtual account that is created over a physical account. These are only created to track the payments that are being received in the main physical account. Paytm partners with a bank to facilitate these virtual accounts over its own account. These VANs can be generated corresponding to the entity against which the reconciliation needs to be done. Hence in case of schools seeking fees from students, it needs generated corresponding to students. If the business is seeking a payment against an invoice, then VAN needs to be generated against an invoice. Once complete payment is received, the merchant can disable the VAN associated with that invoice.

VAN details comprise the following:

• VAN Account Number - This is a 16 digit alphanumeric account number which consists of the following:
  • First two characters - This is fixed as 11 by the partner bank.
  • Next 4 characters - This a merchant identifier called merchant prefix issued to the merchant at the time of onboarding. Merchant can also opt for names resembling their business names. Once a merchant identifier is taken, it cannot be allocated to any other merchant. You can see few examples of them in the table below:

    Merchant Name	Merchant Identifier
    Paytm	PYTM
    Sony	SONY
    IIT Kanpur	IITK

  • Last 10 characters - This is an alphanumeric ID that can be passed to the merchant. The merchant should pass the ID of the entity with which they want to reconcile the payment. Hence, in case of college seeking fees from students, it could be the Roll Number (provided it is unique). If the business is seeking a payment against an invoice, it can be a unique invoice ID.
• IFSC Code - PYTM0123456, which is a fixed identity.
• Beneficiary Name - One97 Communications Limited, which is a fixed identity.
  Example - Let us assume IIT Kanpur wants to collect VANs for its student. Hence, a sample VAN should appear as "10IITK20210023TA". Here, 20210023 is a unique Roll Number of each student in the institute and TA is the first letter of the first and last name of the student. This way a student will always remember the VAN corresponding to which the payment needs to be made.

VAN Lifecycle Management

• VAN can be generated using the Create VAN API. This is a bulk API wherein you can send up to 10 VAN creation requests altogether.

• Merchant must pass the entity related details that will be required at the time for reconciliation. All fields that are passed to us in UDF fields, customer details and purpose will be provided in reconciliation assets like Order Status API, Payment Webhook, and transaction report generated from the UMP.

• Merchant can also pass the list of bank accounts from which the payments can be accepted. The addition of bank accounts on a given VAN would ensure that TPV validation will be performed on that VAN. At any point in time, TPV validation can be performed for a maximum of 10 bank accounts. All these accounts should be in Active status.

• In case the response is not received to re-verify the status of the VAN creation request, the merchant can check the status using the Query VAN API.

• In case the merchants want to stop accepting payments via a particular VAN, then they can request the Update VAN API.

• Merchants can use VAN Order List API to fetch order details for a given MID.

• Merchant can also fetch all the VANs generated with their status using the VAN List API.

Distribution of VAN to the customers

• Once the VAN is generated, the merchant can distribute VANs amongst their customers via emails, SMS, Whatsapp, etc.
• As of now, Paytm will provide this functionality of distributing the VANs to the respective customers. But as of now, Paytm does not support this.

Caution: Merchant needs to ensure that there is no mixup in the VAN distribution amongst customers. Hence the VAN generated for a Customer A needs to be distributed to the Customer A. If not, the payment will be made by some other customer whereas payment will be notified to merchant against the Customer A.

Receiving payments in VAN

Once the VAN is created and distributed amongst the customers, they do the following:

1. Customer adds VAN details as a beneficiary in their bank account.

2. Once the account is added, the customer can initiate a transfer using NEFT, RTGS, IMPS, and UPI. Transfer limits associated with NEFT, RTGS, IMPS, and UPI are provided in the table below. There might be additional limits imposed by the user’s issuing bank.

3. On making the transfer, payment is received by Paytm's partner bank. The partner bank accepts the payment and notifies Paytm of the transfer received with the associated VAN details.

4. On receiving the payment notification, Paytm creates a successful order. This order has associated details that were passed in the Create VAN API.

5. Merchant gets payment completion Webhook with the transfer details. This also comprises the associated details that were passed in the Create VAN API.

6. In the case of TPV, the Partner bank performs TPV if bank accounts are associated with VAN. The partner bank rejects the payment where TPV fails and notifies Paytm of the failed transfer with the associated VAN details.  On receiving the payment notification, Paytm creates a failed order. Paytm notifies the merchant of a payment failure caused by TPV check failure by sending a failure webhook. Similar to the success webhook, the failure webhook also consists of associated details that were passed in the Create VAN API.

7. Merchant can also query the payments received using the Order list API  or Transaction Status API, which will provide a list of all payments between a time frame with VANs corresponding to each order.

8. Once complete payment is received, the merchant can disable(close) the VAN associated with that invoice.

9. Merchant will have access to payment and VAN details corresponding to transaction and settlement report generated from the Merchant Panel.

10. On T+1, Paytm will settle the collected amount into the customer's settlement account.

Type of fund transfer	Allowed on VAN	Amount Limit	Time taken to register payment
IMPS	Yes	INR 1 - INR 2 Lakh	Real-time
NEFT	Yes	INR 1 - Limit applied by your bank	Between 30 mins to 2 hours
RTGS	Yes	INR 2 Lakh - Limit applied by your bank	Real-time
UPI	No	Up to INR 1 Lakhs	Real-time

Integration testing on staging environment

You need to follow the steps below while testing on the staging environment:

1. Dummy VANs can be created on staging using the Create VAN API and Query VAN API. Actual money cannot be transferred in this VAN.
2. In order to initiate a payment in this VAN, a merchant needs to use this Paytm Utility. Here merchant needs to provide the following details:

   Name	Definition
   User Name	User name of the remitter. This could be a dummy user name which will be provided to the merchant in all reports and API.
   User Account Number	Account number of the remitter. This could be a dummy account number which will be provided to the merchant in all reports and API.
   User IFSC	IFSC code of remitter. This could be a dummy IFSC code which will be provided to the merchant in all reports and API.
   VAN	16 digit VAN number created via staging API. Note that payment will be created provided they entered VAN exists on staging.
   Transaction Amount	Amount for which a merchant wants to simulate the payment process.

3. On pressing Submit, Paytm will create a payment on staging. On successful creation, the merchant will:

   • Get an S2S webhook notifying payment completion

   • Merchant can see the order and payment details on the merchant dashboard

   • Merchant can query details of the order on the staging environment

   • Merchant can initiate a refund 

1. Customer visits your website or APP.
2. Customer adds goods/services into the shopping cart and proceeds to pay on the merchant's website.
3. Customer selects NEFT/RTGS/IMPS/UPI from the payment sources and clicks the Pay button. 
4. The customer gets the Account Number(VAN) to which NEFT/RTGS/IMPS/UPI transfer of exact order amount has to be made.
5. The customer adds the VAN as a beneficiary with his bank and makes a payment equal to order amount.
6. Merchant is notified of the transfer with the VAN details on receiving the payment corresponding to the order placed. Transfer details will be available in the daily reports as well as the dashboard.
7. On T+1, the merchant will receive the settlement against all the transfers received on VANs generated by customers.
8. Customers can place more than one order on a single VAN from the merchant's app or website. If two orders of the same amount are created on a VAN then the order placed last will be marked complete first on receipt of its corresponding payment amount.

Demo of Login User

Receiving payments in VAN

1. Payment is received by Paytm's partner bank when the customer makes NEFT/RTGS/IMPS/UPI transfer to VAN.
2. The partner bank accepts the payment and notifies Paytm of the transfer with the associated VAN details.
3. On receiving the payment notification, Paytm validates the order amount and order validity. If both conditions are verified Paytm maps the payment corresponding to the pending VAN order.
4. Merchant gets payment completion Webhook with the transfer details. This also comprises the associated details of the VAN number and its purpose.
5. Merchant can also query the status of the payment using the Transaction Status API,  which gets the transaction status corresponding to the requested OrderId.
6. Merchant will have access to payment and VAN details corresponding to transaction and settlement report generated from the Merchant Panel.
7. On T+1, Paytm will settle the collected amount into the merchant's settlement bank account.

The below flowchart explains the payment journey in detail.

Integration Steps

1. Choose a suitable checkout flow for integration on your app or website. Note that the Large Payment Collection product is available below checkouts.
   1. JS checkout (Available) - Read about JS Checkout integration here.
   2. Custom Checkout (Coming soon)
   3. All-in-One Sdk( Coming soon)

   Important: Integrating with  Initiate Transaction API is mandatory for the merchant to Large payments on JS checkout.

2. Log in to the Merchant Dashboard (UMP Panel) to request activation for Large Payment Collection. Alternatively, you can contact the onboarding team or your KAM for placing the activation request.

   Note: Large Payment Collection is only available to select enterprise customers with high transaction volumes and established businesses. Get in touch to request access to Paytm Large Payment Collection solution.

3. Provide the Merchant Identifier for your business. The merchant setup team will reach out to you to configure the Merchant Prefix required to create the VAN. The construct of the Paytm VAN is described below:
    

   Name	Placement	Description
   Paytm Prefix	First two characters	This is fixed as 11 by the partner bank.
   Merchant Prefix	Next 4 characters (in CAPS)	This a merchant identifier called merchant prefix issued to the merchant at the time of onboarding. Merchant can also opt for names resembling their business names. Once a merchant identifier is taken, it cannot be allocated to any other merchant. For Example: Paytm can opt for a merchant prefix as PYTM.
   identificationNo	Last 10 characters	This is 10 digits alphanumeric string that forms the last 10 digits of the VAN. While merchants can use this in multiple ways possible, this can be unique to the entity against which reconciliation is required. The length of this is fixed and hence needs to be accommodated while passing this number.

4. Select the suitable VAN customization preference. You can either predetermine the last 10 characters of VAN (identificationNo) for a given customer and the same will be used to create the customer VAN. Else, you can pass this responsibility to us wherein Paytm will collect the mobile number of the customer and use it as a substitute to identificationNo of a VAN. The two preferences for VAN customization are discussed below:
   1. Merchant Managed - Here the identificationNo for a given customer is decided by the merchant. Therefore, the merchant needs to mandatorily pass identificationNo and Merchant Prefix in the Initiate Transaction API. PG constructs the 16 character VAN number using the identificationNo and displays the same to the customer.

      Merchant	Paytm Prefix	Merchant Prefix	identificationNo (Provided by merchant)	Virtual Account Number
      Paytm Money	11	PMON	9876533333 Here, 9876533333 is the 10 char unique folio number of each Paytm Money Customer	11PMON9876533333

   2. Paytm Managed - In the case merchant wants Paytm to manage VAN creation, the merchant needs to mandatorily pass merchant prefix only in the initiate transaction API. PG constructs the 16 character VAN using the mobile number of the customer and displays the same to the customer.

      Merchant	Paytm Prefix	Merchant Prefix	identificationNo (Provided by merchant)	Virtual Account Number
      Paytm Money	11	PMON	9432568398 Here, 9432568398 is the mobile number of the customer provided and validated by OTP verification	11PMON9432568398

      Caution:

      1. Merchant Prefix is mandatory to input for Paytm Managed flow whereas both Merchant Prefix and identificationNo both are mandatory for Merchant Managed Flow.
      2. You will be able to choose either one of the two available VAN creation configurations for your MID.

5. Select the order timeout required for Large Payment Collection Payment Source. Note that any payment made by the customer to the VAN post order timeout expiry will be automatically refunded to the customer. 

6. The customer is provided with the VAN for the given order as per the configured customization preference described in Step 3. Along with VAN, the IFSC Code and Beneficiary name are also shared with the customer on the merchant app or website.

7. Last, validate transaction response using the Transaction Status API. The status should be treated as the final status of the transaction. Paytm provides payment response on both Callback URL and Webhook URL. Please refer to the sample response for payment sources here.