Payment Flow

The infographic shows the general flow of a system using Express Checkout.

Order Creation

Creating your first Order

Order is the cornerstone for conducting payments with Juspay. Order to Juspay is akin to what a shopping cart to a merchant is. Order encapsulates all the information that is required for payment. All the payments, refunds, etc. are associated with an Order and it becomes the root reference.

Keeping in mind the fundamentals of distributed systems, we have let you choose your order_id when you create the order. This way, you can check the status of your order through our API whenever you want.

To know how to create the order, please refer to our API documentation

Nonetheless, please find the below snippet to quickly create an order. Note that you have to substitute the correct API Key.

curl -k https://api.juspay.in/orders \
    -u your_api_key: \
    -d "amount=10.00" \
    -d "order_id=ord_007" \
    -d "customer_id=guest_user_101" \
    -d "[email protected]" \
    -d "customer_phone=919988665522" \
    -d "product_id=:pid" \
    -d "description=Order Info

Mandatory Parameters

Different payment gateways & aggregators have a varying set of parameters that are mandatory. Depending on your backend gateway please ensure that the mandatory parameters are sent to avoid any failures.

Parameter	HDFC	ICICI	Axis	PayU	Citrus	PayTM	EBS	RazorPay	CCAvenue
order_id	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
amount	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
customer_id	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
customer_email	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
customer_phone	Optional	Optional	Optional	Yes	Yes	Yes	Yes	Yes	Yes
description	Optional	Optional	Yes	Yes	Yes	Yes	Yes	Yes	Yes
product_id	No	No	No	No	No	No	No	No	No
billing_address_first_name	No	No	No	Optional	Optional	No	Yes	No	Yes
billing_address_last_name	No	No	No	Optional	Optional	No	Yes	No	Yes
billing_address_line1	No	No	No	Optional	Optional	No	Yes	No	Yes
billing_address_line2	No	No	No	Optional	Optional	No	Yes	No	Yes
billing_address_line3	No	No	No	Optional	Optional	No	Yes	No	Yes
billing_address_city	No	No	No	Optional	Optional	No	Yes	No	Yes
billing_address_state	No	No	No	Optional	Optional	No	Yes	No	Yes
billing_address_country	No	No	No	Optional	Optional	No	Yes	No	Yes
billing_address_postal_code	No	No	No	Optional	Optional	No	Yes	No	Yes
billing_address_phone	No	No	No	Optional	Optional	No	Yes	No	Yes
billing_address_country_code_iso	No	No	No	Optional	Optional	No	Yes	No	Yes
shipping_address_first_name	No	No	No	Optional	Optional	No	Yes	No	Yes
shipping_address_last_name	No	No	No	Optional	Optional	No	Yes	No	Yes
shipping_address_line1	No	No	No	Optional	Optional	No	Yes	No	Yes
shipping_address_line2	No	No	No	Optional	Optional	No	Yes	No	Yes
shipping_address_line3	No	No	No	Optional	Optional	No	Yes	No	Yes
shipping_address_city	No	No	No	Optional	Optional	No	Yes	No	Yes
shipping_address_state	No	No	No	Optional	Optional	No	Yes	No	Yes
shipping_address_country	No	No	No	Optional	Optional	No	Yes	No	Yes
shipping_address_postal_code	No	No	No	Optional	Optional	No	Yes	No	Yes
shipping_address_phone	No	No	No	Optional	Optional	No	Yes	No	Yes
shipping_address_country_code_iso	No	No	No	Optional	Optional	No	Yes	No	Yes

To understand what each of these parameters is, please refer to our API documentation

Payment redirection

Redirection to Payment Gateway

Once the order has been created, the response will contain the payment link to which you can redirect the customer for entering payment information. If you are using the custom checkout page then the transaction can be called through API, SDK or PayV3 based on the platform being integrated.

Example Response

{
  "order_id": "1478851764",
  "id": "ord_e294a26e66ad4336a992ceab81ad704c",
  "status": "CREATED",
  "status_id": 1,
  "payment_links": {
    "web": "https://api.juspay.in/merchant/pay/ord_e294a26e66ad4336a992ceab81ad704c",
    "mobile": "https://api.juspay.in/merchant/pay/ord_e294a26e66ad4336a992ceab81ad704c?mobile=true",
    "iframe": "https://api.juspay.in/merchant/ipay/ord_e294a26e66ad4336a992ceab81ad704c"
  }

payment_links attribute will be present in both /order/create API and /order/status API. We have provided three variants to make it easy for your customers. As the name implies, these are best suited for the respective channels.

Variant	Description
web	Renders a desktop-optimized version of the checkout page
mobile	Renders a mobile-optimized version of the checkout page
iframe	Provides an iFrame that you can embed as part of your checkout page

Payment methods

All the payment methods enabled in your account will be displayed to the user. This is to ensure maximum acceptance which improves your success rate significantly. To enable only required payment methods pass an extra parameter to the payment URL

To enable only Netbanking, pass the following parameter: payment_options=nb. To enable only Wallets, pass the following parameter: payment_options=wallet. To enable Netbanking and Wallets together, pass the following parameter: payment_options=nb|wallet.

<iframe src="https://api.juspay.in/merchant/ipay/ord_e294a26e66ad4336a992ceab81ad704c?payment_options=nb"
width="630" height="400"
style="border: 1px solid #CCC;padding: 20px;height: auto;min-height: 300px;">
</iframe>

Sample code for creating an iFrame with EMI support:

<iframe src="https://api.juspay.in/merchant/ipay/ord_e294a26e66ad4336a992ceab81ad704c?is_emi=true&emi_tenure=6&emi_bank=HDFC&payment_options=card"
width="630" height="400"
style="border: 1px solid #CCC;padding: 20px;height: auto;min-height: 300px;">
</iframe>

Expiry

Links become invalid as soon as the order expires. The default expiry is 15 minutes from the time of creation. This value is customizable via our dashboard. Please follow this link to customize it to your need.

The maximum expiry time is 24 hours. This limit is set due to security restrictions. If you wish to extend the expiry period, then please reach out to us. Your chances of convincing us will improve significantly if you use a good random generator for Order ID attribute.

Payment Response

Payment Response
Once the payment is complete the user is redirected to the return_url configured by you. Following is the typical destination where the user is taken to:

HTTP GET https://merchant.shop.com/paymentresponse/handler?order_id=order_id_007&status=CHARGED&status_id=21&signature=euKzwwiUztPPg3MCEYpgKZfcyTr1uQq1hzKkhP8G1vQ%253D&signature_algorithm=HMAC-SHA256`

Please note that the parameters are sent using HTTP GET by default. To enable HTTP POST for your MID, please drop an email to [email protected]

Transaction Status codes and their meaning

Status	ID	Meaning
NEW	10	Newly created order
PENDING_VBV	23	Authentication is in progress
VBV_SUCCESSFUL	24	Authorization is in progress
CHARGED	21	Successful transaction
AUTHENTICATION_FAILED	26	User did not complete authentication
AUTHORIZATION_FAILED	27	User completed authentication, but the bank refused the transaction
JUSPAY_DECLINED	22	User input is not accepted by the underlying PG
AUTHORIZING	28	Transaction status is pending from bank
COD_INITIATED	29	User has Cash on Delivery as payment mode
STARTED	20	Transaction is pending. Juspay system isn't able to find a gateway to process a transaction
AUTO_REFUNDED	36	Transaction is automatically refunded
CAPTURE_INITIATED	33	Capture pending for the pre-authorized transaction
CAPTURE_FAILED	34	Capture failed for the pre-authorized transaction
VOID_INITIATED	32	Void pending for the pre-authorized transaction
VOIDED	31	Void is successful for the pre-authorized transaction
VOID_FAILED	35	Void failed for the pre-authorized transaction
NOT_FOUND	40	Provided order id is not created at Juspay

Transaction is successful only if you receive CHARGED as the value in status. For all other cases, you must assume that the payment has failed or the finite status is not known from the upstream gateway at the moment.

Status Verification

After the redirect, the authenticity should be verified using the signature in the response. The signature parameter in the return_url gives the HMAC signature computed using the algorithm specified by the signature_algorithm parameter. The HMAC is calculated using the following algorithm:

Get all the parameters (key=value pairs) from the return_url.
It is assumed that the parameters in the return_url are converted into key/value pairs.
All parameters except signature and signature_algorithm are used in the following steps.
Percentage encode each key and value pairs.
Sort the list of parameters alphabetically (ASCII based sort) by encoded key.
For each key/value pair:
- Append the encoded key to the output string.
- Append the '=' character to the output string.
- Append the encoded value to the output string.
- If there are more than one key/value pairs, append a '&' character to the output string.
Percentage encode the generated string.
The HMAC of the string can be calculated using the Response Key configured in merchant settings.
Percentage encode the generated hash, validate against the signature in response (the signature should percentage decoded once before comparing with the generated hash).

To enable the signature generation at JusPay end for the payment response, you must first create a response key under Settings of Juspay dashboard [https://dashboard.expresscheckout.juspay.in/]. Once you have created a key successfully, navigate to Settings-->General (https://dashboard.expresscheckout.juspay.in/) section and select "Yes" for the option "Use signed response".

Once you have completed the above two steps, all the redirection to your website from JusPay will have the signature and the algorithm.

The signature algorithm used by JusPay is HMAC-SHA256. The algorithm is explicitly passed as an argument so that verification is accurate. Newer or more secure algorithms might be introduced in the future.

It is also possible to check the status using the order status API. Based on the response object, a success confirmation page or failure message can be shown to the customer. Since this is an authenticated call, done from the server side, signature verification is not required.

#Python example for HMAC signature verification

python
import urllib
import hmac
import hashlib
import base64

key = 'your_secret_key'
# params := key/value dictionary except `signature`
#           and `signature_algorithm`
# signature := "5ctBJ0vURSTS9awUhbTBXCpUeDEJG8X%252B6c%253D"
# signature_algorithm := "HMAC-SHA256"

encoded_sorted = []
for i in sorted(params.keys()):
    encoded_sorted.append(urllib.quote_plus(i) + '=' + \
      urllib.quote_plus(params.get(i)))

encoded_string = urllib.quote_plus('&'.join(encoded_sorted))
dig = hmac.new(key, \
              msg=encoded_string, \
              digestmod=hashlib.sha256).digest()

assert urllib.quote_plus(base64.b64encode(dig).decode()) == \
       signature

#Ruby example for HMAC signature verification:**
python
require 'uri'
require 'cgi'
require 'openssl'
require 'Base64'

key = "your_secret_key"
# params := key/value hash except `signature`
#           and `signature_algorithm`
# signature := "5ctBJ0vURSTS9awUhbTBXCpUeDEJG8X%252B6c%253D"
# signature_algorithm := "HMAC-SHA256"

encoded_sorted = []
params.keys.sort.each { |k| encoded_list << URI.encode(k) + \
                        "=" + URI.encode(params[k]) }

encoded_string = CGI.escape(encoded_sorted.join("&"))

hash_string = CGI.escape(Base64.encode64(OpenSSL::HMAC. \
                        digest(OpenSSL::Digest.new('sha256'), \
                        key, data)).strip())
hash_string == URI.decode(return_url). \
                  split("signature=")[1].split("&")[0]

import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.TreeMap;

import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import javax.xml.bind.DatatypeConverter;


public class Util {

    /**
     * @param args
     */
    public static void main(String[] args) {
        Ccw8ZE5fkr0%3D&signature_algorithm=HMAC-SHA256
        LinkedHashMap<String, String> param = new LinkedHashMap<String, String>();
        param.put("order_id", ":order_id");
        param.put("status", ":status");
        param.put("status_id", ":status_id");
        
        System.out.println("param :: "+param);
        
        String expectedHashparam="OHEZ3sYJa%2F9ZyNZ79u3r4p4F2p9O8%2FjSCcw8ZE5fkr0%3D";
        
         String scretkey=":Response key";
        
        try {
            System.out.println(" return value :: "+validateHMAC_SHA256(param,expectedHashparam,scretkey));
        } catch (InvalidKeyException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (UnsupportedEncodingException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (NoSuchAlgorithmException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }
     public static boolean validateHMAC_SHA256(Map<String, String> params, String expectedHash, String key)
                throws java.io.UnsupportedEncodingException, java.security.NoSuchAlgorithmException,
                java.security.InvalidKeyException, java.io.UnsupportedEncodingException {
            if (key == null) return false;

            Map<String, String> sortedParams = new TreeMap<String, String>(params);
            
            System.out.println(""+sortedParams);

            StringBuilder queryStr = new StringBuilder("");
            for (String curkey : sortedParams.keySet())
                queryStr.append(curkey + "=" + sortedParams.get(curkey) + "&");
            queryStr.deleteCharAt(queryStr.length() - 1);
            System.out.println("queryStr ::"+queryStr);
            String message = URLEncoder.encode(queryStr.toString(), "UTF-8");
           
            Mac hasher = Mac.getInstance("HmacSHA256");
            hasher.init(new SecretKeySpec(key.getBytes(), "HmacSHA256"));
            byte[] hash = hasher.doFinal(message.getBytes());
            String generatedSign = (URLEncoder.encode(DatatypeConverter.printBase64Binary(hash), "UTF-8"));
            System.out.println("generatedSign ::"+generatedSign);
            return (generatedSign.equals(expectedHash));
        }

}

function verify_hmac($params, $secret) {
           $receivedHmac = $params['signature'];
           // UrlEncode key/value pairs
           $encoded_params;
           foreach ($params as $key => $value) {
               if($key!='signature' && $key != 'signature_algorithm') {
                   $encoded_params[urlencode($key)] = urlencode($value);
               }
           }
           ksort($encoded_params);
           $serialized_params = "";
           foreach ($encoded_params as $key => $value) {
               $serialized_params = $serialized_params . $key . "=" . $value . "&";
           }
           $serialized_params = urlencode(substr($serialized_params, 0, -1));
           $computedHmac = base64_encode(hash_hmac('sha256', $serialized_params, $secret, true));
           $receivedHmac = urldecode($receivedHmac);
           return urldecode($computedHmac) == $receivedHmac;
       }

const crypto = require('crypto');

function verify_hmac(params, secret) {

  var paramsList = [];
  for (var key in params) {
    if (key != 'signature' && key != 'signature_algorithm') {
      paramsList[key] = params[key];
    }
  }

  paramsList = sortObjectByKeys(paramsList);

  var paramsString = '';
  for (var key in paramsList) {
    paramsString = paramsString + key + '=' + paramsList[key] + '&';
  }

  let encodedParams = encodeURIComponent(paramsString.substring(0, paramsString.length - 1));
  let computedHmac = crypto.createHmac('sha256', secret).update(encodedParams).digest('base64');
  let receivedHmac = decodeURIComponent(params.signature);

  console.log("computedHmac :", computedHmac)
  console.log("receivedHmac :", receivedHmac)

  return decodeURIComponent(computedHmac) == receivedHmac;
}

function sortObjectByKeys(o) {
  return Object.keys(o)
    .sort()
    .reduce((r, k) => ((r[k] = o[k]), r), {});
}

console.log(verify_hmac({"status_id":"21","status":"CHARGED","order_id":"**6**3**","signature":"******crdU/AW8BkpqnMHK2********TE=","signature_algorithm":"HMAC-SHA256"},{{Response Key}}))

Order Status

The order should always be fulfilled by checking the status from the server using /order/:order_id API explained here. Status along with many other data will be returned as part of the /order/:order_id API. This is an alternative to the GET params in return_url.

Failing to do status verification will result in hackers gaming your system. So, please ensure that status verification is in place before you go LIVE with us.
Example request

curl -X GET \
  https://api.juspay.in/orders/wv_test_ord_110011 \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -H 'version: 2018-10-25' \

{
  "merchant_id": "wv_test",
  "order_id": "wv_test_ord_110011",
  "customer_id": "[email protected]",
  "product_id": "",
  "status": "CHARGED",
  "status_id": 21,
  "amount": 400,
  "currency": "INR",
  "refunded": false,
  "amount_refunded": 0,
  "return_url": "http://skyview./order/cc-confirm",
  ....
}

The above response is truncated for brevity. However, as you can see above, the status was received as CHARGED. This indicates that the payment was successful and so, you can proceed with the fulfilment of the order.Also ensure to verify the parameters like amount, payment_method, payment_method_type in the response are as per the details present in your system.

Status Conflicts

In a typical payment using ExpressCheckout, the control goes from your Checkout Page to Juspay's servers, then to Payment Gateway(PG) or Aggregator, and then to the Bank pages for the second-factor authentication. You will then be redirected to the PG page after the payment is authenticated and authorized, and then back to your inventory confirmation page. In all the above cases there can be timeouts due to bad network or bank/PG downtime. This leads to temporary status conflict between Juspay and/or the PG/bank, as we missed the updated response after the payment.

These conflicts are reconciled periodically when we get the updated status from the PG. The updated status for an order will be notified to the merchant via emails or webhooks. You can also poll the current status of the order using /order/status API to check for an update. This can also be triggered individually for each order, from the order details page in the merchant dashboard.

To enable email alerts, please contact [email protected].

The notification will be sent when the status changes from PENDING_VBV/AUTHORIZATION_FAILED to CHARGED.

Webhooks

After the completion of every payment/refund call, Juspay will provide direct notification to your server regarding the event. These are called Webhooks. You must configure a valid HTTPS endpoint that is reachable from our servers to consume these notifications. Our servers will push data using HTTPS POST call to your endpoint.

Based on the API version configured in the dashboard, webhooks will be triggered for the events below.

Payment Success
Payment Failure
Refund Success
Refund failure
Order Creation
Transaction Creation
Refund Moved to Manual Review.

Why webhooks?

Payment redirection using customers' browsers are not reliable all the time. There would be instances where customers' devices would be on low-quality connections and thereby the final redirection might not succeed. In such cases, a webhook call can help you complete the order for the customer.

But care must be taken while consuming the webhook data. Since you might receive both webhook and customer redirection around the same time, you should not process the order twice. This is true for most cases.

In very rare scenarios, our webhook call pertaining to order might hit your server more than once. This can happen due to network fluctuations. So, care must be taken to ensure that such scenarios are handled too.

Events

Event Name	Description	Webhook API version
ORDER_SUCCEEDED	Generated when payment is successful for an order	For all the versions
ORDER_REFUNDED	Generated when a refund is successful	For all the versions
ORDER_FAILED	Generated when an order payment fails	For all the versions >= "2016-07-19"
ORDER_REFUND_FAILED	Generated when an order refund fails	For all the versions
TXN_CREATED	Generated when payment is initiated for an order	For all the versions >= "2016-10-27"
REFUND_MANUAL_REVIEW_NEEDED	Generated when the refund status is ambiguous and the refund has to be manually reconciled by the merchant with the payment processor.	For all the versions
REFUND_INITIATED	Generated when refund is initiated for an order	For all the versions
AUTO_REFUND_SUCCEEDED	Generated when the transaction is auto refunded and refund is success	For all the versions >= "2019-11-11"
AUTO_REFUND_FAILED	Generated when the transaction is auto refunded and refund is failure	For all the versions >= "2019-11-11"
MANDATE_CREATED	Generated when the mandate is created	For all the versions
MANDATE_ACTIVATED	Generated when the mandate is successful registered	For all the versions
MANDATE_FAILED	Generated when the mandate registration fails	For all the versions
MANDATE_REVOKED	Generated when the mandate is revoked by the merchant	For all the versions
NOTIFICATION_FAILED	Generated when the mandate notification is failed	For all the versions
NOTIFICATION_SUCCEEDED	Generated when the mandate notification is success	For all the versions
ORDER_AUTHORIZED	Generated for pre-auth enabled transactions when the payment is AUTHORIZED	For all the versions
TXN_CHARGED	Transaction level webhook, generated when a transaction become successful	For all the versions >="2020-10-31"
TXN_FAILED	Transaction level webhook, generated when a transaction fails	For all the versions >="2020-10-31"

Webhook API version can be configured in the dashboard -> Settings -> Webhooks Tab -> Webhook API version

Response structure for Webhook

{
  "id": "evt_gsu1c0r7umcfrxeb",
  "date_created": "2015-06-03T10:42:25Z",
  "event_name": "ORDER_SUCCEEDED",
  "content": {
    "order": {
        /* Complete order data as obtained from /order/:order_id API */
    }
}

Webhook Authentication

We support Basic HTTP Authentication for your Webhook URL. Using Username and password fields to authenticate the webhook call is mandatory. Please ensure that special characters like @ are not used in username.

Handling Failures
If your server is not reachable and we receive a non-200 response when we are attempting webhook notification, we would mark the webhook notified section in our dashboard as False. Hence, consume webhooks on with 200 response code.

You would receive webhook events from the following IPs

Production:
13.126.232.13
35.154.93.248
65.2.117.44
3.110.250.172

Sandbox:
52.221.151.249
13.228.4.195
13.234.141.165
3.111.27.22
3.109.41.51

Caveats:

Although our webhooks are reliable, it is always suggested that you use our GetOrderStatus API to poll our systems, in case you do not receive the webhooks in time.

This will handle the cases where the webhooks could not be notified to your system. The threshold beyond which you start polling our system can be decided basis your business use case.

PAYLOAD

{
  "id": "evt_hk0a9ccu6qwkcryg",
  "date_created": "2018-12-05T13:53:24Z",
  "event_name": "ORDER_SUCCEEDED",
  "content": {
    "order": {
      "gateway_id": 18,
      "product_id": "",
      "auth_type": "THREE_DS",
      "customer_phone": "7598504535",
      "bank_error_message": "",
      "date_created": "2018-12-05T13:48:48Z",
      "order_id": "3e0411f7-a4b1-466b-85b2-ea55d1ba6496",
      "currency": "INR",
      "amount": 600,
      "id": "ord_c4345ba45dd3457c85fe8299f5321f53",
      "udf2": "",
      "udf1": "",
      "refunded": false,
      "udf6": "",
      "udf5": "",
      "amount_refunded": 0,
      "udf4": "",
      "txn_id": "MID-3e0411f7-a4b1-466b-85b2-ea55d1ba6496-1",
      "udf3": "",
      "card": {
        "saved_to_locker": false,
         "card_issuer": "",
         "card_brand": "MASTERCARD",
         "card_reference": "008485a49f2edfb9e62cefaa0cb95b13",
         "card_type": "CREDIT",
         "card_fingerprint": "1gkmbuaauq6ts9hv6v2oos4qgc",
         "expiry_year": "2023",
         "using_saved_card": true,
         "card_isin": "553227",
         "name_on_card": "",
         "last_four_digits": "",
         "expiry_month": "04"
       },
       "merchant_id": "MID",
       "payment_method_type": "CARD",
       "payment_links": {
         "iframe": "https://sandbox.juspay.in/merchant/ipay/ord_c4345ba45dd3457c85fe8299f5321f53",
         "web": "https://sandbox.juspay.in/merchant/pay/ord_c4345ba45dd3457c85fe8299f5321f53",
         "mobile": "https://sandbox.juspay.in/merchant/pay/ord_c4345ba45dd3457c85fe8299f5321f53?mobile=true"
       },
       "status": "CHARGED",
       "txn_uuid": "rkuk1mu7y77ltiam",
       "status_id": 21,
       "customer_email": "",
       "udf7": "",
       "udf8": "",
       "udf9": "",
       "bank_error_code": "",
       "return_url": "http://88.99.31.206:8222/transactions/online_payment_status",
       "payment_gateway_response": {
         "rrn": "201812<HIDDEN>0010016862<HIDDEN>6345",
         "created": "2018-12-05T13:53:24Z",
         "resp_code": "01",
         "txn_id": "MID-3e0411f7-a4b1-466b-85b2-ea55d1ba6496-1",
         "epg_txn_id": "201812<HIDDEN>0010016862<HIDDEN>6345",
         "resp_message": "Txn Success",
         "auth_id_code": ""
       },
       "payment_method": "MASTERCARD",
       "customer_id": "6989",
       "udf10": ""
    }
  }
 }

{
   id: "evt_V2_3df6bc9f1ec525074110",
   event_name: "TXN_CREATED",
   date_created: "2021-12-25T17:43:48Z",
   content: {
      order: {
         upi: "FILTERED",
         udf9: "",
         udf8: "",
         udf7: "",
         udf6: "",
         udf5: "",
         udf4: "",
         udf3: "",
         udf2: "",
         udf10: "",
         udf1: "",
         txn_uuid: "euloYxKvUtEyLM",
         txn_id: "ms-5090881-1",
         txn_detail: {
            txn_uuid: "euloYxwtEyLM",
            txn_id: "mlus-5090881-1",
            txn_amount: "1000",
            "tax_amount": {},
            "surcharge_amount": {},
            status: "PENDING_VBV",
            redirect: false,
            order_id: "501",
            net_amount: "1000",
            gateway_id: "23",
            gateway: "RAZORPAY",
            express_checkout: false,
            error_message: "",
            "error_code": {},
            currency: "INR",
            created: "2021-12-25T17:43:48Z"
         },
         status_id: "23",
         status: "PENDING_VBV",
         return_url: "https://m.io/",
         refunded: false,
         product_id: "",
         payment_method_type: "UPI",
         payment_method: "UPI",
         payment_links: {
            web: "https://api.juspay.in/merchant/pay/ordeh_369a60af44c",
            mobile: "FILTERED",
            iframe: "https://api.juspay.in/merchant/ipay/ordeh_3619814d0aaf44c"
         },
         payer_app_name: "FILTERED",
         order_id: "5090881",
         "offers": [],
         "metadata": {},
         merchant_id: "mdsfads",
         id: "ordeh_369a60d1aaf44c",
         "gateway_reference_id": {},
         gateway_id: "23",
         effective_amount: "100",
         date_created: "2021-12-25T17:43:46Z",
         customer_phone: "FILTERED",
         customer_id: "FILTERED",
         customer_email: "FILTERED",
         currency: "INR",
         "bank_pg": {},
         bank_error_message: "",
         bank_error_code: "",
         auth_type: "",
         amount_refunded: 0,
         amount: "100"
      }
   }
}

{
   id: "evt_V2_aa922a168f1875",
   event_name: "ORDER_REFUNDED",
   date_created: "2021-12-25T18:26:36Z",
   content: {
      order: {
         upi: "FILTERED",
         udf9: "",
         udf8: "",
         udf7: "",
         udf6: "",
         udf5: "",
         udf4: "",
         udf3: "",
         udf2: "",
         udf10: "",
         udf1: "",
         txn_uuid: "euloYyLM131444",
         txn_id: "merchantid-5090881-1",
         txn_detail: {
            txn_uuid: "euloYyLM131444",
            txn_id: "merchantid-5090881-1",
            txn_amount: "1000",
            "tax_amount": {},
            "surcharge_amount": {},
            status: "CHARGED",
            redirect: false,
            order_id: "50",
            net_amount: "1000",
            gateway_id: "23",
            gateway: "RAZORPAY",
            express_checkout: false,
            error_message: "",
            error_code: "",
            currency: "INR",
            created: "2021-12-25T17:43:48Z"
         },
         status_id: "21",
         status: "CHARGED",
         return_url: "https://api.juspay.in/end",
         refunds: [
            {
               unique_request_id: "5090881R1",
               status: "SUCCESS",
               sent_to_gateway: "true",
               refund_type: "STANDARD",
               refund_source: "RAZORPAY",
               ref: "rfnd_IboEU",
               initiated_by: "API",
               id: "5091R21",
               error_message: "processed",
               created: "2021-12-25T18:14:41Z",
               amount: "1000"
            }
         ],
         refunded: "true",
         product_id: "",
         payment_method_type: "UPI",
         payment_method: "UPI",
         payment_links: {
            web: "https://api.juspay.in/merchant/pay/ordeh_369814d0aaf44c",
            mobile: "FILTERED",
            iframe: "https://api.juspay.in/merchant/ipay/ordeh_369a6014d0aaf44c"
         },
         payment_gateway_response: {
            txn_id: "merchantid-5090881-1",
            rrn: "13595791",
            resp_message: "",
            resp_code: "captured",
            epg_txn_id: "pay_Ib2JBJ6",
            created: "2021-12-25T17:44:22Z",
            auth_id_code: ""
         },
         payer_vpa: "FILTERED",
         payer_app_name: "FILTERED",
         order_id: "5090881",
         "offers": [],
         "metadata": {},
         merchant_id: "merchantId",
         id: "ordeh_369a60d10aaf44c",
         "gateway_reference_id": {},
         gateway_id: "23",
         effective_amount: "FILTERED",
         date_created: "2021-12-25T17:43:46Z",
         customer_phone: "FILTERED",
         customer_id: "FILTERED",
         customer_email: "FILTERED",
         currency: "INR",
         "bank_pg": {},
         bank_error_message: "",
         bank_error_code: "",
         auth_type: "",
         amount_refunded: "1000",
         amount: "1000"
      }
   }
}

{
      "id": "evt_V2_ecefe48954744d5ea3af0367c0efa",
      "event_name": "AUTO_REFUND_SUCCEEDED",
      "date_created": "2022-01-17T20:18:00Z",
      "content": {
        "order": {
          "upi": "FILTERED",
          "udf9": "",
          "udf8": "",
          "udf7": "",
          "udf6": "",
          "udf5": "",
          "udf4": "",
          "udf3": "",
          "udf2": "",
          "udf10": "",
          "udf1": "",
          "txn_uuid": "eulg95RS244tt2LBHgcejY",
          "txn_id": "merchantid-1234567890-1",
          "txn_detail": {
            "txn_uuid": "eulg95RS244tt2LBHgcejY",
            "txn_id": "merchantid-1234567890-1",
            "txn_amount": "FILTERED",
            "tax_amount": null,
            "surcharge_amount": null,
            "status": "AUTO_REFUNDED",
            "redirect": "true",
            "order_id": "1234567890",
            "net_amount": "FILTERED",
            "gateway_id": "12",
            "gateway": "PAYU",
            "express_checkout": false,
            "error_message": "",
            "error_code": "",
            "currency": "INR",
            "created": "2022-01-17T17:31:16Z"
          },
          "status_id": "36",
          "status": "AUTO_REFUNDED",
          "return_url": "https://api.juspay.in/end",
          "refunds": "FILTERED",
          "refunded": "true",
          "product_id": "",
          "payment_method_type": "UPI",
          "payment_method": "UPI",
          "payment_links": {
            "web": "https://api.juspay.in/merchant/pay/ordeu_fc811a1d2fc642vr35b064dab2939bf",
            "mobile": "FILTERED",
            "iframe": "https://api.juspay.in/merchant/ipay/ordeu_fc811a1d2fc642vr35b064dab2939bf"
          },
          "payment_gateway_response": {
            "txn_id": "merchantid-1234567890-1",
            "rrn": "20141144519960923",
            "resp_message": "Success|Completed Using Callback",
            "resp_code": "success",
            "epg_txn_id": "145722242435561",
            "created": "2022-01-17T17:31:17Z",
            "auth_id_code": "NA"
          },
          "payer_vpa": "FILTERED",
          "order_id": "1234567890",
          "offers": [],
          "merchant_id": "merchantid",
          "id": "ordeu_fc811a1d2fc642vr35b064dab2939bf",
          "gateway_reference_id": null,
          "gateway_id": "12",
          "effective_amount": "FILTERED",
          "date_created": "2022-01-17T17:31:16Z",
          "customer_phone": "FILTERED",
          "customer_id": "FILTERED",
          "customer_email": "FILTERED",
          "currency": "INR",
          "bank_pg": "FILTERED",
          "bank_error_message": "",
          "bank_error_code": "",
          "auth_type": "",
          "amount_refunded": "7928.1",
          "amount": "7928.1"
        }
      }
    }

{
      "id": "evt_V2_de87f4ff1ca043b783e1df92deeec47f",
      "event_name": "AUTO_REFUND_FAILED",
      "date_created": "2022-01-16T06:38:04Z",
      "content": {
        "order": {
          "wallet": {
            "txn_flow_type": null
          },
          "udf9": "",
          "udf8": "",
          "udf7": "",
          "udf6": "",
          "udf5": "",
          "udf4": "",
          "udf3": "",
          "udf2": "FILTERED",
          "udf10": "",
          "udf1": "FILTERED",
          "txn_uuid": "eulovH4tt31eKY4uRXTfmbT",
          "txn_id": "merchantId-1223344556677-1",
          "txn_detail": {
            "txn_uuid": "eulovH4tt31eKY4uRXTfmbT",
            "txn_id": "merchantId-1223344556677-1",
            "txn_amount": "1003.94",
            "tax_amount": null,
            "surcharge_amount": null,
            "status": "AUTO_REFUNDED",
            "redirect": "true",
            "order_id": "202112311323219600",
            "net_amount": "1000.94",
            "gateway_id": "39",
            "gateway": "PHONEPE",
            "express_checkout": false,
            "error_message": "",
            "error_code": "",
            "currency": "INR",
            "created": "2021-12-31T13:23:35Z"
          },
          "status_id": "36",
          "status": "AUTO_REFUNDED",
          "return_url": "https://api.juspay.in/end",
          "refunds": [
            {
              "unique_request_id": "erf_e17533321c842f19",
              "status": "FAILURE",
              "sent_to_gateway": "true",
              "refund_type": "STANDARD",
              "refund_source": "PHONEPE",
              "ref": "",
              "initiated_by": "API",
              "id": "ps715cb24443442f19",
              "expected_refund_credit_time": "2022-01-16T08:00:00Z",
              "error_message": "Payment Failed. REVERSAL_BLOCKED",
              "created": "2022-01-16T06:32:01Z",
              "amount": "1003.94"
            },
            {
              "unique_request_id": "erf_12c45ttt6d3344c4a",
              "status": "FAILURE",
              "sent_to_gateway": "true",
              "refund_type": "STANDARD",
              "refund_source": "PHONEPE",
              "ref": "",
              "initiated_by": "API",
              "id": "psc441b6d3344c4a",
              "expected_refund_credit_time": "2022-01-06T15:00:00Z",
              "error_message": "Payment Failed. REVERSAL_BLOCKED",
              "created": "2022-01-06T12:59:04Z",
              "amount": "1003"
            },
            {
              "unique_request_id": "vzohsMLt45yhhA7Egk",
              "status": "FAILURE",
              "sent_to_gateway": "true",
              "refund_type": "STANDARD",
              "refund_source": "PHONEPE",
              "ref": "",
              "initiated_by": "AUTO_REFUNDED",
              "id": "psohs44ttt16qEJA7E6gk",
              "expected_refund_credit_time": "2022-01-06T12:00:00Z",
              "error_message": "Payment Failed. REVERSAL_BLOCKED",
              "created": "2022-01-06T10:04:02Z",
              "amount": "1003.94"
            },
            {
              "unique_request_id": "w7Wj6treedFQKBYdjip",
              "status": "FAILURE",
              "sent_to_gateway": "true",
              "refund_type": "STANDARD",
              "refund_source": "PHONEPE",
              "ref": "",
              "initiated_by": "AUTO_REFUNDED",
              "id": "psWjBeZFQK645fghhdjip",
              "expected_refund_credit_time": "2022-01-06T12:00:00Z",
              "error_message": "Payment Failed. REVERSAL_BLOCKED",
              "created": "2022-01-06T09:58:00Z",
              "amount": "1003.94"
            },
            {
              "unique_request_id": "33JWJsX6Q666SMbE",
              "status": "FAILURE",
              "sent_to_gateway": "true",
              "refund_type": "STANDARD",
              "refund_source": "PHONEPE",
              "ref": "",
              "initiated_by": "AUTO_REFUNDED",
              "id": "psJWJsX6Q3555SMbE",
              "expected_refund_credit_time": "2022-01-06T12:00:00Z",
              "error_message": "Payment Failed. REVERSAL_BLOCKED",
              "created": "2022-01-06T09:53:21Z",
              "amount": "1003.94"
            },
            {
              "unique_request_id": "hNhFRvrrr3riFNW9",
              "status": "FAILURE",
              "sent_to_gateway": "true",
              "refund_type": "STANDARD",
              "refund_source": "PHONEPE",
              "ref": "",
              "initiated_by": "AUTO_REFUNDED",
              "id": "pshFRvk55537riFNW9",
              "expected_refund_credit_time": "2022-01-06T12:00:00Z",
              "error_message": "Payment Failed. REVERSAL_BLOCKED",
              "created": "2022-01-06T09:47:39Z",
              "amount": "1003.94"
            },
            {
              "unique_request_id": "aY4Kpp9j64rgfyTB1e",
              "status": "FAILURE",
              "sent_to_gateway": "true",
              "refund_type": "STANDARD",
              "refund_source": "PHONEPE",
              "ref": "",
              "initiated_by": "AUTO_REFUNDED",
              "id": "ps4Kpp6y6yerbyTB1e",
              "expected_refund_credit_time": "2022-01-06T12:00:00Z",
              "error_message": "Payment Failed. REVERSAL_BLOCKED",
              "created": "2022-01-06T09:45:07Z",
              "amount": "1003.94"
            }
          ],
          "refunded": false,
          "product_id": "",
          "payment_method_type": "WALLET",
          "payment_method": "PHONEPE",
          "payment_links": {
            "web": "https://api.juspay.in/merchant/pay/ordeh_f977493e477a43535ed228fd72078",
            "mobile": "FILTERED",
            "iframe": "https://api.juspay.in/merchant/ipay/ordeh_f977493e477a43535ed228fd72078"
          },
          "payment_gateway_response": {
            "txn_id": "merchantId-1223344556677-1",
            "rrn": "NA",
            "resp_message": "SUCCESS",
            "resp_code": "PAYMENT_SUCCESS",
            "epg_txn_id": "T2112322444547957251953",
            "created": "2022-01-06T09:45:06Z",
            "auth_id_code": "NA"
          },
          "order_id": "202112311323219600",
          "offers": [],
          "merchant_id": "merchantId",
          "id": "ordeh_f977493e477a43535ed228fd72078",
          "gateway_reference_id": null,
          "gateway_id": "39",
          "effective_amount": "FILTERED",
          "date_created": "2021-12-31T13:23:30Z",
          "customer_phone": "FILTERED",
          "customer_id": "FILTERED",
          "customer_email": null,
          "currency": "INR",
          "bank_pg": null,
          "bank_error_message": "",
          "bank_error_code": "",
          "auth_type": "",
          "amount_refunded": 0,
          "amount": "1003.94"
        }
      }
    }

{
    "id": "evt_V2_40d3TEST50a7913a991",
    "date_created": "2023-05-24T13:29:20Z",
    "event_name": "REFUND_INITIATED",
    "content": {
        "order": {
            "upi": "test",
            "order_id": "LeD-cI_test6sXouBg",
            "udf3": "",
            "status": "CHARGED",
            "amount": 843,
            "auth_type": "",
            "refunded": true,
            "udf8": "",
            "udf5": "",
            "payment_method": "UPI",
            "gateway_id": 12,
            "refunds": [
                {
                    "status": "PENDING",
                    "amount": 843,
                    "sent_to_gateway": false,
                    "unique_request_id": "108847",
                    "created": "2023-05-24T13:29:20Z",
                    "initiated_by": "API",
                    "error_message": "",
                    "id": null,
                    "ref": null
                }
            ],
            "udf2": "bike",
            "payment_method_type": "UPI",
            "txn_uuid": "mozwpTEST7XSPXrD",
            "udf4": "",
            "customer_id": "test",
            "udf10": "",
            "bank_pg": "UPI-PG",
            "payment_links": {
                "iframe": "https://api.juspay.in/merchant/ipay/ordeu_efad75fTEST7f31e2fd0cf24cb",
                "web": "https://api.juspay.in/merchant/pay/ordeu_efad75TEST7a7f31e2fd0cf24cb",
                "mobile": "https://api.juspay.in/merchant/pay/ordeu_efad7TEST37a7f31e2fd0cf24cb?mobile=true"
            },
            "effective_amount": 843,
            "udf1": "android_app_native",
            "payment_gateway_response": {
                "auth_id_code": "136722",
                "created": "2023-05-14T03:25:26Z",
                "rrn": "313461389925",
                "gateway_response": {
                    "field6": "test",
                    "address2": "test",
                    "email": "test",
                    "udf3": "",
                    "status": "success",
                    "phone": "test",
                    "amount": "843.00",
                    "txnid": "TESTko_pp-LeD-cI_jTESTsXouBg-2",
                    "state": "",
                    "udf8": "",
                    "udf5": "",
                    "hash": "21d0de017acf1b20eb5689124027fbe5d7b0ccfce95f002d04be089a5b99506315df1259ea44eaTESTcb36fde",
                    "field0": "test",
                    "furl": "https://api.juspay.in/v2/pay/response/acTESTo_pp/mozwpjxTESTXSPXrD",
                    "discount": "0.00",
                    "udf2": "bike",
                    "lastname": "test",
                    "field7": "test",
                    "country": "test",
                    "payment_source": "payuTESTeS2S",
                    "card_token": "test",
                    "error": "E0TEST0",
                    "surl": "https://api.juspay.in/v2/pay/response/TEST_pp/mozwpTEST7XSPXrD",
                    "curl": "https://api.juspay.in/v2/pay/response/TEST/mozwpTESTF7XSPXrD",
                    "field1": "test",
                    "mode": "UPI",
                    "udf4": "",
                    "field4": "test",
                    "udf10": "",
                    "udf1": "androiTESTve",
                    "zipcode": "test",
                    "mihpayid": "17355TEST438",
                    "bank_ref_num": "3134TEST89925",
                    "addedon": "2023-05-14 08:55:04",
                    "error_Message": "No Error",
                    "key": "test",
                    "city": "test",
                    "field5": "test",
                    "address1": "test",
                    "field8": "test",
                    "unmappedstatus": "captured",
                    "card_no": "test",
                    "firstname": "test",
                    "productinfo": "quot plaTESTFor yo",
                    "net_amount_debit": "8TEST3",
                    "PG_TYPE": "UPI-PG",
                    "field2": "test",
                    "udf7": "",
                    "bankcode": "INTESTNT",
                    "field9": "SuccTESTllback",
                    "udf9": "",
                    "bank_ref_no": "31TEST925",
                    "udf6": "",
                    "field3": "test"
                },
                "epg_txn_id": "173TEST3438",
                "txn_id": "TEST-LeD-cI_jKwTESTBg-2",
                "resp_message": "Success|Completed Using Callback",
                "resp_code": "success"
            },
            "payer_app_name": "test",
            "product_id": "",
            "txn_detail": {
                "order_id": "LeD-cITESTsXouBg",
                "status": "CHARGED",
                "net_amount": 843,
                "error_code": "",
                "gateway_id": 12,
                "surcharge_amount": "test",
                "txn_uuid": "mozwpjTESTPXrD",
                "gateway": "PAYU",
                "created": "2023-05-14T03:25:04Z",
                "tax_amount": "test",
                "txn_amount": 843,
                "error_message": "",
                "currency": "INR",
                "redirect": false,
                "express_checkout": false,
                "txn_id": "test_pp-LeD-TESTXouBg-2",
                "txn_flow_type": "test"
            },
            "amount_refunded": 843,
            "payer_vpa": "test",
            "customer_email": "test",
            "currency": "INR",
            "customer_phone": "test",
            "bank_error_message": "",
            "id": "ordeu_efadTESTe2fd0cf24cb",
            "txn_id": "test_pp-LeD-TEST6sXouBg-2",
            "merchant_id": "test_pp",
            "maximum_eligible_refund_amount": "test",
            "udf7": "",
            "date_created": "2023-05-14T03:23:04Z",
            "bank_error_code": "",
            "offers": [],
            "udf9": "",
            "gateway_reference_id": "payu_gTESTrod",
            "status_id": 21,
            "udf6": ""
        }
    }
}