Step 1: Create New Order (REST API) 🔗

Use the below url to create an order in your (backend) server.

UAT URL: https://uatapiv2.payg.in/payment/api/order

Production URL: https://apiv2.payg.in/payment/api/order

/create


Authorization: basic authentication with base64encoded

PayGAuthentication –
<MerchantAuthenticationKey>: <MerchantAuthenticationToken>:M: <MID>
  
                  
                        
                           {
                              "MID": "3EMF9915EF35567",
                              "UniqueRequestId": "TEST512scx3",
                              "UserDefinedData": {
                                  "UserDefined1": ""
                              },
                              "ProductData": "{'PaymentReason':'OnlineOrder for OrderNo- 1234'}",
                              "RequestDateTime": "06232023",
                              "RedirectUrl": "https://payg.in",
                              "TransactionData": {
                                  "AcceptedPaymentTypes": "",
                                  "PaymentType": "",
                                  "SurchargeType": "",
                                  "SurchargeValue": "",
                                  "RefTransactionId": "",
                                  "IndustrySpecificationCode": "",
                                  "PartialPaymentOption": ""
                              },
                              "OrderAmount": "3",
                              "OrderType": "",
                              "OrderAmountData": {
                                  "AmountTypeDesc": "3",
                                  "Amount": "2"
                              },
                              "CustomerData": {
                                  "CustomerId": "123456",
                                  "CustomerNotes": "Mens clothing",
                                  "FirstName": "Ayush",
                                  "LastName": "Rane",
                                  "MobileNo": "7887673322",
                                  "Email": "ayushtesting12@gmail.com",
                                  "EmailReceipt": "true",
                                  "BillingAddress": "76, Sch. 115",
                                  "BillingCity": "Indore",
                                  "BillingState": "MP",
                                  "BillingCountry": "India",
                                  "BillingZipCode": "452011",
                                  "ShippingFirstName": "Ayush",
                                  "ShippingLastName": "Rane",
                                  "ShippingAddress": "76, Sch. 115",
                                  "ShippingCity": "Indore",
                                  "ShippingState": "MP",
                                  "ShippingCountry": "India",
                                  "ShippingZipCode": "452011",
                                  "ShippingMobileNo": "9987887733"
                              },
                              "IntegrationData": {
                                  "UserName": "Ayush",
                                  "Source": "3213",
                                  "IntegrationType": "",
                                  "HashData": "",
                                  "PlatformId": "1"
                              }
                          }
  
 

         
router.post('/create_order_post', function(req, res, next) {
   
   var form_post=JSON.parse(JSON.stringify(req.body));

   

   let headerurl = `${config.AuthenticationKey}:${config.AuthenticationToken}:M:${config.MerchantKeyId}`;
   let encode_header_credentail = encode.encode(headerurl, 'base64');
   
   var options = {
      method: 'POST',
      url: config.paymentURL+'/create',
      headers: 
      {
         'postman-token': '6b698fc7-a018-1a8c-bdc5-c2852851152f',
         'cache-control': 'no-cache',
         'content-type': 'application/json',
         authorization: 'Basic '+encode_header_credentail 
      },
      body: 
      { 
         Merchantkeyid: config.MerchantKeyId,
         UniqueRequestId: shortid.generate(),
         OrderStatus: 'Initiating',
         UserDefinedData: { UserDefined1: '' },
         RequestDateTime: '02/09/2021',
         RedirectUrl: config.RedirectUrl,
         TransactionData: 
         { 
            AcceptedPaymentTypes: '',
            PaymentType: '',
            SurchargeType: '',
            SurchargeValue: '',
            RefTransactionId: '',
            IndustrySpecificationCode: '',
            PartialPaymentOption: '' 
         },
         OrderAmount: form_post.OrderAmount,
         OrderType: 'MOBILE',
         OrderAmountData: { 
            AmountTypeDesc: form_post.AmountTypeDesc, Amount: form_post.Amount 
         },
         CustomerData: 
         { 
            CustomerId: form_post.CustomerId,
            CustomerNotes: form_post.CustomerNotes,
            FirstName: form_post.FirstName,
            LastName: form_post.LastName,
            MobileNo: form_post.MobileNo,
            Email: form_post.Email,
            EmailReceipt: form_post.EmailReceipt,
            BillingAddress: form_post.BillingAddress,
            BillingCity: form_post.BillingCity,
            BillingState: form_post.BillingState,
            BillingCountry: form_post.BillingCountry,
            BillingZipCode: form_post.BillingZipCode,
            ShippingFirstName: form_post.ShippingFirstName,
            ShippingLastName: form_post.ShippingLastName,
            ShippingAddress: form_post.ShippingAddress,
            ShippingCity: form_post.ShippingCity,
            ShippingState: form_post.ShippingState,
            ShippingCountry: form_post.ShippingCountry,
            ShippingZipCode: form_post.ShippingZipCode,
            ShippingMobileNo: form_post.ShippingMobileNo ,
         },
         IntegrationData: 
         { 
            UserName: form_post.UserName,
            Source: 'MobileSDK',
            IntegrationType: '11',
            HashData: form_post.HashData,
            PlatformId: form_post.PlatformId 
         } 
      },
      json: true 
   };
   request(options, function (error, response, body) {
     if (error) throw new Error(error);
     
   //res.render('thanks', {title:"Thanks", OrderKeyId: body.OrderKeyId,PaymentProcessUrl:body.PaymentProcessUrl });

   open(body.PaymentProcessUrl, function (err) {
      if ( err ) throw err;    
   });

   
   });
});


      

   {
      "OrderKeyId": "93281250227M10404UTEST512scx3",
      "MerchantKeyId": 10121,
      "UniqueRequestId": "TEST512scx3",
      "OrderType": "PAYMENT",
      "OrderAmount": 3,
      "OrderId": null,
      "OrderStatus": null,
      "OrderPaymentStatus": 0,
      "OrderPaymentStatusText": null,
      "PaymentStatus": 0,
      "PaymentTransactionId": null,
      "PaymentResponseCode": 0,
      "PaymentApprovalCode": null,
      "PaymentReasonCode": null,
      "PaymentTransactionRefNo": null,
      "PaymentResponseText": null,
      "PaymentMethod": null,
      "PaymentAccount": null,
      "OrderRefundTransactionId": 0,
      "RefundPaymentResponseCode": 0,
      "RefundPaymentResponseText": null,
      "RefundDateTime": null,
      "CardType": null,
      "CardLevel": null,
      "OrderNotes": null,
      "PaymentDateTime": null,
      "UpdatedDateTime": null,
      "PaymentProcessUrl": "https://uat.payg.in/paymentv6/payment-form?OrderKeyId=93281250227M10404UTEST512scx3",
      "CustomerData": {
          "CustomerId": "123456",
          "CustomerNotes": "Mens clothing",
          "FirstName": "Ayush",
          "LastName": "Rane",
          "MobileNo": "7887673322",
          "Email": "ayushtesting12@gmail.com",
          "EmailReceipt": true,
          "BillingAddress": "76, Sch. 115",
          "BillingCity": "Indore",
          "BillingState": "MP",
          "BillingCountry": "India",
          "BillingZipCode": "452011",
          "ShippingFirstName": "Ayush",
          "ShippingLastName": "Rane",
          "ShippingAddress": "76, Sch. 115",
          "ShippingCity": "Indore",
          "ShippingState": "MP",
          "ShippingCountry": "India",
          "ShippingZipCode": "452011",
          "ShippingMobileNo": "9987887733"
      },
      "ProductData": "{'PaymentReason':'OnlineOrder for OrderNo- 1234'}",
      "OrderPaymentCustomerData": {
          "FirstName": "Ayush",
          "LastName": null,
          "Address": null,
          "City": null,
          "State": null,
          "ZipCode": null,
          "Country": null,
          "MobileNo": "7887673322",
          "Email": "ayushtesting12@gmail.com",
          "UserId": null,
          "IpAddress": null
      },
      "UpiLink": null,
      "OrderPaymentTransactionDetail": null,
      "UserDefinedData": {
          "UserDefined1": "",
          "UserDefined2": null,
          "UserDefined3": null,
          "UserDefined4": null,
          "UserDefined5": null,
          "UserDefined6": null,
          "UserDefined7": null,
          "UserDefined8": null,
          "UserDefined9": null,
          "UserDefined10": null,
          "UserDefined11": null,
          "UserDefined12": null,
          "UserDefined13": null,
          "UserDefined14": null,
          "UserDefined15": null,
          "UserDefined16": null,
          "UserDefined17": null,
          "UserDefined18": null,
          "UserDefined19": null,
          "UserDefined20": null
      },
      "SplitPaymentResponse": null,
      "Id": 93281
  }
   
  
 

Step 2: Payment process url for checkout 🔗

This payment url is used to redirect to actual payment screen.

Developer can redirect either by using javascript or other programming language.

This is a javascript example like window.location="Payment process url"

Step 3: Order Details (API request Parameters) 🔗

      
Authorization: basic authentication with base64encoded
PayGAuthentication –
<MerchantAuthenticationKey>:<MerchantAuthenticationToken>:M:<MID>
      
      

      
         {
            "OrderKeyId": "93281250227M10404UTEST512scx3",
            "MID":"3EMF9915EF35567",
            "PaymentType": ""
        }
 
      
      

      
router.all('/order_detail',function(req, res, next){
   let headerurl = `${config.AuthenticationKey}:${config.AuthenticationToken}:M:${config.MerchantKeyId}`;
   let encode_header_credentail = encode.encode(headerurl, 'base64');

   var form_post=JSON.parse(JSON.stringify(req.body));

   console.log(form_post.OrderID)
   console.log(">>>>>>>>>>>>>>");
   var options = { method: 'POST',
      url: config.paymentURL+'/Detail',
      headers: 
      { 'postman-token': 'd0b751f6-ffce-e5e0-e7a5-56d0129fbe88',
         'cache-control': 'no-cache',
         'content-type': 'application/json',
         authorization: 'Basic '+encode_header_credentail },
      body: 
      { OrderKeyId: '210315M7963U7QXjJakL45',
         MerchantKeyId: '7963',
         PaymentType: '' },
      json: true };

      request(options, function (error, response, body) {
         if (error) throw new Error(error);
         
         res.render('order_detail', { title: 'Order detail333',body: body});
      });
});
      
      

      
         {
            "OrderKeyId": "93281250227M10404UTEST512scx3",
            "MerchantKeyId": 10121,
            "UniqueRequestId": "TEST512scx3",
            "OrderType": "PAYMENT",
            "OrderAmount": 3.00,
            "OrderId": null,
            "OrderStatus": "1",
            "OrderPaymentStatus": 0,
            "OrderPaymentStatusText": "Paid",
            "PaymentStatus": 0,
            "PaymentTransactionId": "767926",
            "PaymentResponseCode": 1,
            "PaymentApprovalCode": null,
            "PaymentReasonCode": null,
            "PaymentTransactionRefNo": null,
            "PaymentResponseText": "Approved",
            "PaymentMethod": "CreditCard",
            "PaymentAccount": "41111 - XXXX - 1111",
            "OrderRefundTransactionId": 0,
            "RefundPaymentResponseCode": 0,
            "RefundPaymentResponseText": null,
            "RefundDateTime": null,
            "CardType": null,
            "CardLevel": null,
            "OrderNotes": "Internal",
            "PaymentDateTime": "2/27/2025 1:57:09 PM",
            "UpdatedDateTime": "2/27/2025 1:52:35 PM",
            "PaymentProcessUrl": null,
            "CustomerData": {
                "CustomerId": "123456",
                "CustomerNotes": "Mens clothing",
                "FirstName": "Ayush",
                "LastName": "Rane",
                "MobileNo": "7887673322",
                "Email": "ayushtesting12@gmail.com",
                "EmailReceipt": false,
                "BillingAddress": "76, Sch. 115",
                "BillingCity": "Indore",
                "BillingState": "MP",
                "BillingCountry": "India",
                "BillingZipCode": "452011",
                "ShippingFirstName": "Ayush",
                "ShippingLastName": "Rane",
                "ShippingAddress": "76, Sch. 115",
                "ShippingCity": "Indore",
                "ShippingState": null,
                "ShippingCountry": "India",
                "ShippingZipCode": "452011",
                "ShippingMobileNo": "9987887733"
            },
            "ProductData": "{'PaymentReason':'OnlineOrder for OrderNo- 1234'}",
            "OrderPaymentCustomerData": null,
            "UpiLink": null,
            "OrderPaymentTransactionDetail": [
                {
                    "OrderKeyId": "93281250227M10404UTEST512scx3",
                    "MerchantKeyId": 10404,
                    "TransactionId": 767926,
                    "ResponseCode": 1,
                    "ResponseText": "Approved",
                    "TransactionAmount": 3.00
                }
            ],
            "UserDefinedData": {
                "UserDefined1": "",
                "UserDefined2": null,
                "UserDefined3": null,
                "UserDefined4": null,
                "UserDefined5": null,
                "UserDefined6": null,
                "UserDefined7": null,
                "UserDefined8": null,
                "UserDefined9": null,
                "UserDefined10": null,
                "UserDefined11": null,
                "UserDefined12": null,
                "UserDefined13": null,
                "UserDefined14": null,
                "UserDefined15": null,
                "UserDefined16": null,
                "UserDefined17": null,
                "UserDefined18": null,
                "UserDefined19": null,
                "UserDefined20": null
            },
            "SplitPaymentResponse": null,
            "Id": 93281
        }
         
      
      

Note: Please check the payment status codes from this URL Payment Response codes Note: Please check the error codes from this URL Error codes