Skip to content

PayTM

PZ Integration option

Payment flow

  1. The customer selects PayTM as a payment method.
  2. The merchant requests a wallet number from PaySage.io and shows it to the customer.
  3. The customer makes a transfer on the given wallet.
  4. The customer copies the transaction ID from the receipt and enters it on the payment form.
  5. The merchant creates a payment through PaySage.io API and passes that transaction ID.
  6. PaySage.io activates the payment and notifies the merchant when the transaction is completed.

Info

Check the supported currencies and countries with your account manager.

This integration option supports the following operations:

Wallet number request

Request

To request the wallet number, send a GET request to https://api.paysage.io/beyag/pkm/paytm/wallet/{currency}, where {currency} stands for the currency in the ISO-4217 format, for example USD.

Response

You will get a 200 HTTP response status code if your request is processed successfully. Otherwise, the response from PaySage.io contains an error explanation message.

Example of the response to a successful request 
{
  "wallet": "123456789",
  "status": "ok"
}
Example of the error response 
{
  "status": "fail",
  "message": "An error has occurred while fetching a wallet. Try again later, please."
}

Payment

Request

After your customer sent you the transaction ID, send a payment request with the following data:

Parameter Type Description
method object A section of the payment method.
type * required
 string paytm
customer object A section of information about your customer.
first_name * conditionally required
 string The customer's first name. Contact Tech Support Team for details.
last_name * conditionally required
 string The customer's last name. Contact Tech Support Team for details.
email * required
 string The customer's email address.
additional_data object A section of additional transaction data.
transaction_id * conditionally required
 string The transaction ID received from your customer. Contact Tech Support Team for details.
Response

The paytm response section will have parameters copied from the request. Additionally, you'll get the parameter form to build a form where the customer should be redirected to finalize the payment.

Payout

Request

Info

Contact the Tech Support Team to check how to pass the correct amount.

Send a payout request with the following data:

Parameter Type Description
method object A section of the payment method.
type * required
 string paytm
channel * conditionally required
 string A unique identifier of the user making the payment. Contact the Tech Support Team for details.
account * required
 string 10 digits of the bank account number.
Response

The paytm response section will have the parameters copied from the request.