Initiate Transaction Request

The request for Initiate Transaction API.

Note: The json request needs to be encrypted before sending as explained in earlier sections

Key	DS	Required	Details
merchantPaymentReferenceId	string	Yes	Unique transaction id generated by the merchant to track this payment request. It is alphanumeric with a max length of 50 characters. `<=` 50 characters Example: MER-PAY-183-406
merchantOrderId	string	Yes	Unique order id generated by the merchant to track this order. It is alphanumeric with a max length of 50 characters. `<=` 50 characters Example:MER-ORD-183-406
txnInfo currency(string) amount(string)	object	Yes	Currency Currency in which transaction amount is to be deducted. Note that we have strict validation on currency, merchant has to send the amount in decided currency in the contract. Example:INR Amount Amount to be charged to the customer with accuracy to 2 decimal places. Example:700.00
merchantOrderDetailsUrl	string	Yes	Merchant needs to send the URL which will take the user to the order details screen of the particular order on their website. Example:https://merchant.com/order/ORD-123-456
transactionContext	string	Yes	Base 64 encoded cart details. transactionContext may vary based on category.

Transaction context:

{
  "fareDetails": {
    "totalAmount": "700.00",
    "payableAmount": "700.00"
  },
  "cartDetails": {
    "cartItems": [
      {
        "category": "SHOPPING",
        "itemId": "12345", // not mandatory
        "price": "350.00", // not mandatory
        "itemName": "Chocolate Box",  // not mandatory
        "quantity": 2,  // not mandatory
        "address": {  // not mandatory
          "addressString": "Sabha pearl, 2nd floor80 feet road, Indiranagar",
          "city": "Bengaluru",
          "pincode": "560038",
          "country": "India"
        },
        "shippingInfo": {
          "deliveryType": "STANDARD",  // not mandatory
          "time": {  // not mandatory
            "timestamp": 1573467980,  
            "zoneOffSet": "+05:30"  
          }
        }
      }
    ]
  }
}

Example:

ewogIGZhcmVEZXRhaWxzOiB7CiAgICB0b3RhbEFtb3VudDogNzAwLjAwLAogICAgcGF5YWJsZUFtb3VudDogNzAwLjAwCiAgfSwKICBjYXJ0RGV0YWlsczogewogICAgY2FydEl0ZW1zOiBbCiAgICAgIHsKICAgICAgICBjYXRlZ29yeTogU0hPUFBJTkcsCiAgICAgICAgaXRlbUlkOiAxMjM0NSwKICAgICAgICBwcmljZTogMzUwLjAwLAogICAgICAgIGl0ZW1OYW1lOiBDaG9jb2xhdGUgQm94LAogICAgICAgIHF1YW50aXR5OiAyLAogICAgICAgIGFkZHJlc3M6IHsKICAgICAgICAgIGFkZHJlc3NTdHJpbmc6IFNhYmhhIHBlYXJsLCAybmQgZmxvb3I4MCBmZWV0IHJvYWQsIEluZGlyYW5hZ2FyLAogICAgICAgICAgY2l0eTogQmVuZ2FsdXJ1LAogICAgICAgICAgcGluY29kZTogNTYwMDM4LAogICAgICAgICAgY291bnRyeTogSW5kaWEKICAgICAgICB9LAogICAgICAgIHNoaXBwaW5nSW5mbzogewogICAgICAgICAgZGVsaXZlcnlUeXBlOiBTVEFOREFSRCwKICAgICAgICAgIHRpbWU6IHsKICAgICAgICAgICAgdGltZXN0YW1wOiAxNTczNDY3OTgwLAogICAgICAgICAgICB6b25lT2ZmU2V0OiArMDU6MzAKICAgICAgICAgIH0KICAgICAgICB9CiAgICAgIH0KICAgIF0KICB9Cn0=

Initiate Transaction Request​

Initiate Transaction Request