--- page_title: Tata Neu Wallet product: EC Headless platform: Android page_source: https://juspay.io/in/docs/ec-headless/android/additional-features/tata-neu-wallet llms_txt: https://juspay.io/in/docs/llms.txt product_llms_txt: https://juspay.io/in/docs/ec-headless/llms.txt --- # 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:** #### Sample Response: getPaymentMethods Code Snippet: ```sample response: getpaymentmethods curl --location --request POST 'https://api.juspay.in/session' \ --header 'x-merchantid: yourMerchantId' \ --header 'Authorization: Basic base64encodedkey==' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount":"10.00", "order_id":"yourUniqueOrderId", "customer_id":"dummyCustId", "customer_phone":"9876543210", "customer_email":"dummyemail@gmail.com", "payment_page_client_id":"", "action":"paymentPage" }' ``` ## **Process SDK Call for TataNeu Wallet: Eligibility Request** **Sample Eligibility Request and Responses:** #### Sample Request: Eligibility Code Snippet: ```sample request: eligibility curl --location --request POST 'https://api.juspay.in/session' \ --header 'x-merchantid: yourMerchantId' \ --header 'Authorization: Basic base64encodedkey==' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount":"10.00", "order_id":"yourUniqueOrderId", "customer_id":"dummyCustId", "customer_phone":"9876543210", "customer_email":"dummyemail@gmail.com", "payment_page_client_id":"", "action":"paymentPage" }' ``` ## **TataNeu Wallet Linking** ### **1. Create Wallet** Call create wallet API to create a wallet for a customer as shown below: #### Sample Request: Create Wallet Code Snippet: ```sample request: create wallet curl --location --request POST 'https://api.juspay.in/session' \ --header 'x-merchantid: yourMerchantId' \ --header 'Authorization: Basic base64encodedkey==' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount":"10.00", "order_id":"yourUniqueOrderId", "customer_id":"dummyCustId", "customer_phone":"9876543210", "customer_email":"dummyemail@gmail.com", "payment_page_client_id":"", "action":"paymentPage" }' ``` ### **2. Link Wallet** Call link wallet API to complete the authentication and linking process of the wallet with the customer account as shown below: #### Sample Request: Link Wallet Code Snippet: ```sample request: link wallet curl --location --request POST 'https://api.juspay.in/session' \ --header 'x-merchantid: yourMerchantId' \ --header 'Authorization: Basic base64encodedkey==' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount":"10.00", "order_id":"yourUniqueOrderId", "customer_id":"dummyCustId", "customer_phone":"9876543210", "customer_email":"dummyemail@gmail.com", "payment_page_client_id":"", "action":"paymentPage" }' ``` ## **Creating a Transaction** ### **1. Create Order** Call create order API to create an order as shown in the snippet below: #### Sample Request CURL Code Snippet: ```sample request curl curl --location --request POST 'https://api.juspay.in/session' \ --header 'x-merchantid: yourMerchantId' \ --header 'Authorization: Basic base64encodedkey==' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount":"10.00", "order_id":"yourUniqueOrderId", "customer_id":"dummyCustId", "customer_phone":"9876543210", "customer_email":"dummyemail@gmail.com", "payment_page_client_id":"", "action":"paymentPage" }' ``` ### **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: #### Sample Request Code Snippet: ```sample request curl --location --request POST 'https://api.juspay.in/session' \ --header 'x-merchantid: yourMerchantId' \ --header 'Authorization: Basic base64encodedkey==' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount":"10.00", "order_id":"yourUniqueOrderId", "customer_id":"dummyCustId", "customer_phone":"9876543210", "customer_email":"dummyemail@gmail.com", "payment_page_client_id":"", "action":"paymentPage" }' ``` ### **3. OTP Authentication** If transaction response says auth_type = OTP, then OTP needs to be taken in UI and passed in below API: #### Sample Request Code Snippet: ```sample request curl --location --request POST 'https://api.juspay.in/session' \ --header 'x-merchantid: yourMerchantId' \ --header 'Authorization: Basic base64encodedkey==' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount":"10.00", "order_id":"yourUniqueOrderId", "customer_id":"dummyCustId", "customer_phone":"9876543210", "customer_email":"dummyemail@gmail.com", "payment_page_client_id":"", "action":"paymentPage" }' ``` Params `resend_otp_allowed` & `sumbit_otp_allowed` indicates whether more OTP resends and OTP submissions are permitted. ### **4. Submit OTP Request** #### Sample Request Code Snippet: ```sample request curl --location --request POST 'https://api.juspay.in/session' \ --header 'x-merchantid: yourMerchantId' \ --header 'Authorization: Basic base64encodedkey==' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount":"10.00", "order_id":"yourUniqueOrderId", "customer_id":"dummyCustId", "customer_phone":"9876543210", "customer_email":"dummyemail@gmail.com", "payment_page_client_id":"", "action":"paymentPage" }' ``` Refer to [this document](https://docs.juspay.in/ec-headless/android/payloads/displaying-payment-options) for more process SDK calls. ## **Post Transaction API Calls** ### **Refund Call** **Sample Request CURL and Response:** #### Sample Request CURL - Refund Code Snippet: ```sample request curl - refund curl --location --request POST 'https://api.juspay.in/session' \ --header 'x-merchantid: yourMerchantId' \ --header 'Authorization: Basic base64encodedkey==' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount":"10.00", "order_id":"yourUniqueOrderId", "customer_id":"dummyCustId", "customer_phone":"9876543210", "customer_email":"dummyemail@gmail.com", "payment_page_client_id":"", "action":"paymentPage" }' ``` #### Sample Response - Refund Code Snippet: ```sample response - refund { "order_id": "jus_1688464018", "udf3": "", "status": "CHARGED", "amount": 2001, "auth_type": "", "wallet": { "txn_flow_type": "DIRECT_DEBIT" }, "refunded": false, "udf8": "", "udf5": "", "payment_method": "TATANEU", "gateway_id": 274, "refunds": [ { "status": "PENDING", "amount": 1000.56, "sent_to_gateway": false, "unique_request_id": "refund_1688464261", "error_code": null, "created": "2023-07-04T09:51:01Z", "initiated_by": "API", "refund_source": "TATANEU", "error_message": "", "id": null, "refund_type": "STANDARD", "ref": null } ], "udf2": "", "payment_method_type": "WALLET", "txn_uuid": "moziMcc9jqDkXu6PjxW", "udf4": "", "customer_id": "cth_dN9M8u81i16LcLdz", "udf10": "", "bank_pg": null, "payment_links": { "iframe": "https://sandbox.juspay.in/merchant/ipay/ordeh_31968b016bce4cafae0b91f95f71b728", "web": "https://sandbox.juspay.in/merchant/pay/ordeh_31968b016bce4cafae0b91f95f71b728", "mobile": "https://sandbox.juspay.in/merchant/pay/ordeh_31968b016bce4cafae0b91f95f71b728?mobile=true" }, "effective_amount": 2001, "udf1": "", "payment_gateway_response": { "auth_id_code": null, "created": "2023-07-04T09:47:07Z", "rrn": null, "epg_txn_id": "tngcrdm64I0J85E40000", "txn_id": "integrations_juspay-jus_1688464018-1", "resp_message": "Transaction successful", "resp_code": "Success" }, "product_id": "", "txn_detail": { "order_id": "jus_1688464018", "status": "CHARGED", "net_amount": 2001, "error_code": "", "gateway_id": 274, "surcharge_amount": null, "txn_uuid": "moziMcc9jqDkXu6PjxW", "gateway": "TATANEU", "created": "2023-07-04T09:47:06Z", "tax_amount": null, "txn_amount": 2001, "error_message": "", "currency": "INR", "redirect": true, "express_checkout": false, "txn_id": "integrations_juspay-jus_1688464018-1", "txn_flow_type": "DIRECT_DEBIT" }, "amount_refunded": 1000.56, "customer_email": "sivashankari@juspay.in", "currency": "INR", "customer_phone": "8111111185", "metadata": { "TATANEU:gateway_reference_id": "tataneu_uat", "payment_links": { "iframe": "https://sandbox.juspay.in/orders/ordeh_31968b016bce4cafae0b91f95f71b728/payment-page", "web": "https://sandbox.juspay.in/orders/ordeh_31968b016bce4cafae0b91f95f71b728/payment-page", "mobile": "https://sandbox.juspay.in/orders/ordeh_31968b016bce4cafae0b91f95f71b728/payment-page" }, "payment_page_client_id": "defaultclient" }, "bank_error_message": "", "id": "ordeh_31968b016bce4cafae0b91f95f71b728", "txn_id": "integrations_juspay-jus_1688464018-1", "merchant_id": "integrations_juspay", "maximum_eligible_refund_amount": 1000.44, "udf7": "", "date_created": "2023-07-04T09:46:58Z", "bank_error_code": "", "offers": [], "udf9": "", "gateway_reference_id": "tataneu_uat", "return_url": "https://www.google.co.in", "status_id": 21, "rewards_breakup": null, "udf6": "" } ``` ### **Order Status Call** **Sample Request CURL and Response:** #### Sample Request CURL - Order Status Code Snippet: ```sample request curl - order status curl --location --request POST 'https://api.juspay.in/session' \ --header 'x-merchantid: yourMerchantId' \ --header 'Authorization: Basic base64encodedkey==' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount":"10.00", "order_id":"yourUniqueOrderId", "customer_id":"dummyCustId", "customer_phone":"9876543210", "customer_email":"dummyemail@gmail.com", "payment_page_client_id":"", "action":"paymentPage" }' ``` #### Sample Response - Order Status Code Snippet: ```sample response - order status { "customer_email": "sivashankari@juspay.in", "customer_phone": "8111111185", "customer_id": "cth_5vMQiEMW89xYBFuc", "status_id": 21, "status": "CHARGED", "id": "ordeh_1ba599cb46d24bf3a8067f63a3a41aff", "merchant_id": "integrations_juspay", "amount": 2, "currency": "INR", "order_id": "jus_1688130187", "date_created": "2023-06-30T13:03:07Z", "return_url": "", "product_id": "", "payment_links": { "iframe": "https://sandbox.juspay.in/orders/ordeh_1ba599cb46d24bf3a8067f63a3a41aff/payment-page", "web": "https://sandbox.juspay.in/orders/ordeh_1ba599cb46d24bf3a8067f63a3a41aff/payment-page", "mobile": "https://sandbox.juspay.in/orders/ordeh_1ba599cb46d24bf3a8067f63a3a41aff/payment-page" }, "udf1": "", "udf2": "", "udf3": "", "udf4": "", "udf5": "", "udf6": "", "udf7": "", "udf8": "", "udf9": "", "udf10": "", "txn_id": "integrations_juspay-jus_1688130187-1", "payment_method_type": "WALLET", "auth_type": "", "payment_method": "TATANEU", "refunded": false, "amount_refunded": 0, "effective_amount": 2, "resp_code": null, "resp_message": null, "bank_error_code": "", "bank_error_message": "", "txn_uuid": "moz4fFQynSMiZK6kkAR", "txn_detail": { "txn_id": "integrations_juspay-jus_1688130187-1", "order_id": "jus_1688130187", "status": "CHARGED", "error_code": null, "net_amount": 2, "surcharge_amount": null, "tax_amount": null, "txn_amount": 2, "offer_deduction_amount": null, "gateway_id": 274, "currency": "INR", "express_checkout": false, "redirect": true, "txn_uuid": "moz4fFQynSMiZK6kkAR", "gateway": "TATANEU", "error_message": "", "created": "2023-06-30T13:03:22Z", "txn_flow_type": "DIRECT_DEBIT" }, "payment_gateway_response": { "resp_code": "Success", "rrn": null, "created": "2023-06-30T13:03:26Z", "epg_txn_id": "tngcrdm64GOPLIH80000", "resp_message": "Transaction successful", "auth_id_code": null, "txn_id": "integrations_juspay-jus_1688130187-1", "gateway_response": { "data": { "redeemStatus": "Success", "responseMessage": "Transaction successful", "responseCode": 0, "merchantOrderId": "integrations_juspay-jus_1688130187-1", "merchantTxnId": "integrations_juspay-jus_1688130187-1", "redeemOrderId": "tngcrdm64GOPLIH80000" }, "errorMessage": null, "path": "/api/v1/redeem/redeemTngc", "timestamp": "2023-06-30T13:03Z" } }, "gateway_id": 274, "gateway_reference_id": "tataneu_uat", "offers": [], "wallet": { "txn_flow_type": "DIRECT_DEBIT" }, "maximum_eligible_refund_amount": 2 } ``` ## **Annexure** ### **Webhooks** Visit [Webhooks](https://docs.juspay.in/resources/docs/common-resources/webhooks) section to understand configuring and handling webhooks. --- ## See Also - [NFC Card Reader](https://juspay.io/in/docs/ec-headless/android/additional-features/nfc-card-reader) - [LazyPay ](https://juspay.io/in/docs/ec-headless/android/additional-features/lazypay)