POSTUpdate Transaction API

Use Case

This API updates txnAmount , goods , shippingInfo , extendInfo in order details in Native flow.

Request Attributes

Content Type : JSON

Head

Attribute	Description
txnToken string mandatory	This is the unique transaction token received in the response of Initiate Transaction API. It is valid for 15 minutes. Example: f0bed899539742309eebd8XXXX7edcf61588842333227
version string optional	Version of the API. Example: v1
channelId string optional	The parameter value identifies the Channel for which API call is initiated.
requestTimestamp string optional	EPOCH timestamp of the time at which request is being sent. Example: 1588402269
clientId string optional	Paytm use the merchant key on the basis of clientId parameter value. It requires only if the merchant has more than one key.
signature string mandatory	Paytm validates the request and ensures that parameters are not tempered by verifying the signature in the request. For creating the checksum (signature) refer to the steps given in Checksum Logic. Note: Create the signature using the body parameter of the request.

Body

Attribute

Description

txnAmount

object

mandatory

This parameter is an object and should contain the value of transaction i.e. amount and currency type.
Example: {"value" : "1.00", "currency" : "INR"}

TxnAmount

Attribute	Description
value string mandatory	This parameter contains the amount to be charged to the customer and can have two places of decimal. Example: 1.00
currency string mandatory	This parameter indicates the currency in which transaction amount is to be deducted. Possible Values: INR

goods

array of object

optional

This contain the goods info for an order

GoodsInfo

Attribute

Description

merchantGoodsId

string

optional

Unique id for the goods item (item no)

merchantShippingId

string

optional

Merchant shipping id

snapshotUrl

string

optional

Product Image URL

description

string

mandatory

Description of product

category

string

optional

Category of Product

quantity

string

mandatory

Quantity ordered

unit

string

optional

Unit of quantity (KG/Litre)

price

object

mandatory

Price of product

Money

Attribute	Description
value string mandatory	This parameter contains the amount to be charged to the customer and can have two places of decimal. Example: 1.00
currency string mandatory	This parameter indicates the currency in which transaction amount is to be deducted. Possible Values: INR

extendInfo

object

optional

Extended info of goods

ExtendedInfo

Attribute	Description
udf1 string optional	User define parameter 1. Merchant will receive this parameter in the callback and transaction status API response.
udf2 string optional	User define parameter 2. Merchant will receive this parameter in the callback and transaction status API response.
udf3 string optional	User define parameter 3. Merchant will receive this parameter in the callback and transaction status API response.
mercUnqRef string optional	Merchant's reference text which comes in final response of Process Transaction API from Paytm
comments string optional	Comments
subwalletAmount string optional	This parameter is required to limit the maximum amount that could be deducted from a particular subwallet. This parameter is only used for payMode Balance (Paytm Wallet). Possible Keys: FOOD, GIFT, MULTI_PURPOSE_GIFT, TOLL, CLOSED_LOOP_WALLET, CLOSED_LOOP_SUB_WALLET, FUEL, INTERNATIONAL_FUNDS_TRANSFER, CASHBACK, GIFT_VOUCHER. e.g. "subwalletAmount":{ "FOOD": "2"} Note: As per compliance rules, you need to send the Food item amount separately to Paytm.

shippingInfo

array of object

optional

This contain the shipping info for an order.

ShippingInfo

Attribute

Description

merchantShippingId

string

optional

Merchant shipping id

trackingNo

string

optional

Tracking no of shipment

carrier

string

optional

Shipping carrier name

chargeAmount

object

optional

Shipping amount

Money

Attribute	Description
value string mandatory	This parameter contains the amount to be charged to the customer and can have two places of decimal. Example: 1.00
currency string mandatory	This parameter indicates the currency in which transaction amount is to be deducted. Possible Values: INR

countryName

string

optional

Shipping country name

stateName

string

optional

Shipping state name

cityName

string

optional

Shipping city name

address1

string

optional

Shipping address 1

address2

string

optional

Shipping address 2

firstName

string

optional

Receiver first name

lastName

string

optional

Receiver last name

mobileNo

string

optional

Receiver mobile no

zipCode

string

optional

Receiver zip code

string

optional

Valid email of the user.

Example: vaibhav41094@gmail.com

extendInfo

object

optional

Merchant can pass any order specific information that is required to be passed here.

ExtendedInfo

Attribute	Description
udf1 string optional	User define parameter 1. Merchant will receive this parameter in the callback and transaction status API response.
udf2 string optional	User define parameter 2. Merchant will receive this parameter in the callback and transaction status API response.
udf3 string optional	User define parameter 3. Merchant will receive this parameter in the callback and transaction status API response.
mercUnqRef string optional	Merchant's reference text which comes in final response of Process Transaction API from Paytm
comments string optional	Comments
subwalletAmount string optional	This parameter is required to limit the maximum amount that could be deducted from a particular subwallet. This parameter is only used for payMode Balance (Paytm Wallet). Possible Keys: FOOD, GIFT, MULTI_PURPOSE_GIFT, TOLL, CLOSED_LOOP_WALLET, CLOSED_LOOP_SUB_WALLET, FUEL, INTERNATIONAL_FUNDS_TRANSFER, CASHBACK, GIFT_VOUCHER. e.g. "subwalletAmount":{ "FOOD": "2"} Note: As per compliance rules, you need to send the Food item amount separately to Paytm.

Response Attributes

Content Type : JSON

Head

Attribute	Description
version string	Version of the API. Example: v1
responseTimestamp string	EPOCH timestamp of the time at which response is being sent. Example: 1588402269
clientId string	Paytm use the merchant key on the basis of clientId parameter value. It requires only if the merchant has more than one key.
signature string	Paytm validates the request and ensures that parameters are not tempered by verifying the signature in the request. For creating the checksum (signature) refer to the steps given in Checksum Logic. Note: Create the signature using the body parameter of the request.

Body

Attribute

Description

resultInfo

object

This parameter gives the information about the result of the API response

ResultInfo

Attribute	Description
resultCode string	This is the resultCode corresponding to a particular message and is returned to the merchant. It's maximum length is 64. The different result codes corresponding to this API are mentioned below.
resultStatus string	This parameter indicates the status of API call. Possible Values: S, For Success F, For Failure U For Unknown
resultMsg string	This parameter is the result message which contains information about the result.The different result messages corresponding to this API are mentioned below.
isRedirect boolean	This flag indicates that number of retries are over and user is to be redirected from cashier page.
bankRetry boolean	This flag indicates that retry is allowed at bank's end or not.
retry boolean	This flag indicates that retry is allowed at bank's end or not.

extraParamsMap

object

Map for any extra information (in case of error).

Response Codes & Messages

resultCode	resultStatus	resultMsg
0000	S	Success
1006	F	txnToken sent in request has expired or is invalid
1111	F	transaction already in process
2005	F	Checksum provided is invalid
2013	F	Different mids sent in initiate transaction request and updateTransactionRequest
2014	F	Different orderIds sent in initiate transaction request and updateTransactionRequest
0000900	U	System error

⇾

Staging

Production

https://securegw-stage.paytm.in/theia/api/v1/updateTransactionDetail?mid={mid}&orderId={order-id} copy icon

REQUEST

RESPONSE

CURL

JAVA

NODE

PHP

PYTHON

DOTNET

curl -X POST 'https://securegw-stage.paytm.in/theia/api/v1/updateTransactionDetail?mid={mid}&orderId=ORDERID_98765' \
--header 'Content-Type: application/json' \
--data '{"body":{"txnAmount":{"value":"1.00","currency":"INR"},"userInfo":{"custId":"CUST_001"}},"head":{"txnToken":"2f61025f332b444197d8b9d1e509c07e1589794795189","signature":"{signature}"}}'