JavaScript is disabled. Some features may not work. You can also read the static version: View text version

TataNeu Wallet Integration

Pre-requisites

1. Configuring TataNeu Gateway on Juspay Dashboard

Merchant needs to get the credentials for payment gateway from Tata NeuWallet and configure it as a PG on Juspay dashboard under the section ‘PG CONTROL CENTER’.

2. Adding Amazon SDK Dependency

Merchant needs to ensure the following for adding Amazon SDK dependency:

Merchant’s SDK package needs to be moved to 2.95 or higher
DOTP micro-app need to be added, if not present

EC Request and Response

Sample getPaymentMethods response for TataNeu Wallet:

              
                {
            "juspayBankCode": "JP_TATAPAY",
            "paymentMethodType": "WALLET",
            "walletDirectDebitSupport": true,
            "supportedFeatures": [
                {
                    "supportedReferenceIds": [
                        "testmode"
                    ],
                    "featureName": "direct_otp",
                    "supportedByDefault": false
                },
                {
                    "supportedReferenceIds": [
                        "testmode"
                    ],
                    "featureName": "wallet_direct_debit",
                    "supportedByDefault": false
                },
                {
                    "supportedReferenceIds": [
                        "testmode"
                    ],
                    "featureName": "link_and_pay",
                    "supportedByDefault": false
                },
                {
                    "supportedReferenceIds": [
                        "testmode"
                    ],
                    "featureName": "eligibility",
                    "supportedByDefault": false
                }
            ],
            "paymentMethod": "TATANEU",
            "nickName": "Tata Neu Wallet",
            "supportedReferenceIds": [
                "testmode"
            ],
            "description": "NeuWallet",
            "supportedByDefault": false,
            "paymentMethodSubType": "WALLET"
        }

Process SDK Call for TataNeu Wallet: Eligibility Request

Sample Eligibility Request and Responses:

              
                {
    "requestId": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9",
    "service": "in.juspay.ec",
    "payload": {
        "action": "eligibility",
        "amount": "1.00",
        "data": {
            "wallets": [
                {
                    "mobile": "1111111111",
                    "gatewayReferenceId": "tataneu_test",
                    "email": "test@mail.com",
                    "customerId": "cth_pKL9ayw75febC1Dd",
                 }
            ],
            "cards": []
        },
        "device_params": null,
        "clientAuthToken": "tkn_0e37edc631d647fdb606ab48ccfc4213",
        "showLoader": true
    }
}

TataNeu Wallet Linking

1. Create Wallet

Call create wallet API to create a wallet for a customer as shown below:

              
                {
    "requestId": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9",
    "service": "in.juspay.ec",
    "payload": {
               "walletName": "TATANEU",
               "requestId": "ba7a5e37-4fdf-4de6-80bb-c428149deaea",
               "mobileNumber": "111111111",
               "gatewayReferenceId": "tataneu_test",
               "clientAuthToken": "tkn_ba1314a42fa747e98bc4cbaffe9a4552",
               "action": "createWallet"
               }
}

2. Link Wallet

Call link wallet API to complete the authentication and linking process of the wallet with the customer account as shown below:

              
                {
    "requestId": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9",
    "service": "in.juspay.ec",
    "payload": {
               "walletName": "TATANEU",
               "walletId": "wlm_oaSmLFatgvNcxiGb",
               "requestId": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9",
               "otp": "1111",
               "clientAuthToken": "tkn_ba1314a42fa747e98bc4cbaffe9a4552",
               "action": "linkWallet"
               }
}

Creating a Transaction

1. Create Order

Call create order API to create an order as shown in the snippet below:

              
                curl --location 'https://sandbox.juspay.in/orders' \\
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic RTk4O*********5RDkwQjg1QUI3Og==' \
--data-urlencode 'order_id=MOTOINR1695191749' \
--data-urlencode 'amount=1' \
--data-urlencode 'currency=INR' \
--data-urlencode 'customer_id=cth_oKFk2gKvJUuwQ8Dq' \
--data-urlencode 'customer_email=nagendra.p@juspay.in' \
--data-urlencode 'customer_phone=7892369201' \
--data-urlencode 'product_id=product_187' \
--data-urlencode 'return_url=https://e3b6c0d9b8c8c44fc1ab2b6ee8ff1183.m.pipedream.net' \
--data-urlencode 'description=Sample_Description_1000'

2. Initiate a Transaction

A process SDK call is to be made with a process payload based on the payment method selected by the user as shown in the snippet below:

              
                {
    "requestId": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9",
    "service": "in.juspay.ec",
    "payload": {
        "action": "walletTxn",
        "orderId": "MOTOINR1695191749",
        "walletMobileNumber": "1111111111",
        "paymentMethod": "TATANEU",
        "directWalletToken": "tkn_nvtQf8DP1A2oGoZu",
        "endUrls": [
            "https:\\/\\/shop\\.merchant\\.com\\/payments\\/handleResponse.*"
        ],
        "clientAuthToken": "tkn_0e37edc631d647fdb606ab48ccfc4213",
        "showLoader": true
    }
}

3. OTP Authentication

If transaction response says auth_type = OTP, then OTP needs to be taken in UI and passed in below API:

              
                {
    "service": "in.juspay.ec",
    "requestId": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9",
    "payload":{
                "order_id": "10a718902be85fdb3109",
                "status": "PENDING_VBV",
                "payment": {
                    "authentication": {
                        "url": "https://api.juspay.in/v2/pay/start/merchant/mozuJAuxgVf8AQQqDoP?cardIssuerBankName%3DTATANEU%26cardType%3D%26paymentMethod%TATANEU%26paymentMethodType%3DWALLET&otpWaitPage=true",
                        "params": {
                            "submit_otp_allowed": true,
                            "auth_type": "OTP",
                            "resend_otp_allowed": true,
                            "challenge_id": "19103811176",
                            "id": "mozuJAuxgVf8AQQqDoP"
                        },
                        "method": "GET"
                    }
                },
                "txn_uuid": "mozuJAuxgVf8AQQqDoP",
                "merchant_return_url": "https://www.merchant.com/member/active-orders/?flow=checkout&entrycontextid=15&native=1",
                "offer_details": {
                    "offers": [{
                        "status": "INITIATED",
                        "offer_id": "4ff8b192-2ed6-4cc3-96fc-8241daf55ef4"
                    }]
                },
                "txn_id": "10a718902be85fdb3109"
            },
    "errorMessage": "",
    "errorCode": "",
    "error": false
}

Params resend_otp_allowed & sumbit_otp_allowed indicates whether more OTP resends and OTP submissions are permitted.

4. Submit OTP Request

              
                {
    "requestId": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9",
    "service": "in.juspay.ec",
    "payload": { 
             "action" :: "processOTP",
             "clientAuthToken" :: Maybe String,
   ��         "challengeId" :: "19103811176",
             "otp" :: "111111",
             "autoCapture" :: "true",
             "id" :: "mozuJAuxgVf8AQQqDoP"
  }
}

Refer to this document for more process SDK calls.

Post Transaction API Calls

Refund Call

Sample Request CURL and Response:

              
                curl --location 'https://sandbox.juspay.in/orders/jus_1688464018/refunds' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'version: 2022-07-27' \
--header 'Authorization: Basic QzUzRkVCNjU5OTM0MTdEQjZDQjI4Nzk0OTU5MTE0Og==' \
--data-urlencode 'unique_request_id=refund_1688464278' \
--data-urlencode 'amount=1000.566'

Order Status Call

Sample Request CURL and Response:

              
                curl --location 'https://sandbox.juspay.in/orders/?options.add_full_gateway_response=true' \
--header 'version: 2022-03-07' \
--header 'Authorization: Basic QjNENDlGOUIwMzk0NUY4Qjk1MUMzQ0RFODdBNDA5Og=='

Annexure

Webhooks

Visit Webhooks section to understand configuring and handling webhooks.