--- page_title: Get Accounts product: UPI TPAP SDK platform: Android page_source: https://juspay.io/in/docs/upi-tpap-sdk/android/headless-process-payloads/get-accounts llms_txt: https://juspay.io/in/docs/llms.txt product_llms_txt: https://juspay.io/in/docs/upi-tpap-sdk/llms.txt --- ## Get Accounts The merchant can call this API to allow a customer to fetch Account ### Process Parameters ## Request Payload - **RequestId**: - Description: Unique uuid-v4 string - Value: Example: abcd-12345-abcd-12345 - Tags: String, Mandatory - **Service**: - Description: Value: in.juspay.hyperapi - Tags: String, Mandatory - **Payload**: - Description: Parameters required to call Hyper SDK API - Value: - **Action**: - Description: Operation to be performed in the SDK. - Value: upiGetAccounts - Tags: String, Mandatory - **BankCodes**: - Description: Array of Bank IIN numbers to be searched for accounts - Tags: Array of String, Mandatory - **AadhaarConsent**: - Description: Aadhaar Consent should be either True or False - Value: True/False - Tags: String, Optional - **AccountType**: - Description: To be passed when linking credit and credit line. - Value: CREDIT/ UPICREDIT - Tags: String, Optional - **UdfParameters**: - Description: Stringified JSON for udf parameters - Tags: JSON string, optional - Tags: JSON, Mandatory ## Response Payload - **RequestId**: - Description: Unique uuid-v4 string - Value: Example: abcd-12345-abcd-12345 - Tags: String - **Service**: - Description: Value: in.juspay.hyperapi - Tags: String - **Payload**: - Description: Response Parameters - Value: - **Action**: - Description: Operation to be performed in the SDK. - Value: upiGetAccounts - Tags: String, Mandatory - **Status**: - Description: If upiGetAccounts was success or failed - Value: SUCCESS / FAILURE - Tags: String, Mandatory - **Accounts**: - Description: Contains details about customer's accounts - Value: - **BankCode**: - Description: IIN Code for the bank - Tags: String, Mandatory - **BankName**: - Description: Name of bank - Tags: String, Mandatory - **MaskedAccountNumber**: - Description: Account Number with last few digits visible - Tags: String, Mandatory - **OtpLength**: - Description: Length of OTP - Tags: String, Mandatory - **AtmPinLength**: - Description: Length of atm pin - Tags: String, Mandatory - **MpinLength**: - Description: Length of mpin - Tags: String, Mandatory - **MpinSet**: - Description: Is mpin set - Value: true / false - Tags: String, Mandatory - **ReferenceId**: - Tags: String, Mandatory - **AccountNumber**: - Tags: String, Optional - **Type**: - Description: Type of account - Tags: String, Optional - **BranchName**: - Description: Name of branch in which account is registered - Tags: String, Optional - **BankAccountUniqueId**: - Description: Unique Identifier for bank account across banks - Tags: String, Optional - **Ifsc**: - Description: Account IFSC - Tags: String, Optional - **IsAadhaarNumberAvailable**: - Description: Aadhar Number's availability - Value: true/false - Tags: String, Mandatory - **AadhaarEnabled**: - Description: Aadhar is enabled or not - Value: true/false - Tags: String, Mandatory - **IsPrimary**: - Description: Is this account the primary account - Value: true / false - Tags: String, Optional - **Name**: - Description: Name of account holder - Tags: String, Optional - Tags: JSON, Mandatory - **VpaSuggestions**: - Description: Suggestions of available VPAs - Tags: Array of String, Optional - **OtherInfo**: - Description: As passed in request - Tags: String, Optional - **UdfParameters**: - Description: Stringified JSON for udf parameters - Tags: JSON string, Optional - Tags: JSON - **Error**: - Description: Possible values :- true/false - Tags: Boolean - **ErrorMessage**: - Description: Error Message - Tags: String - **ErrorCode**: - Description: Error Code - Tags: String - **Event**: - Description: Value: process_result - Tags: String #### Code Snippets: - #### Java Code Snippet: ```java { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetAccounts", "bankCodes": ["code"], "aadhaarConsent":"true" } } ``` #### Kotlin Code Snippet: ```kotlin { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetAccounts", "bankCodes": ["code"], "aadhaarConsent":"true" } } ``` ## Sample Code Snippets: ### Request snippets: #### Request Code Snippet: ```request // block:start:checkPermissionReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiCheckPermission" } } // block:end:checkPermissionReqH // block:start:checkPermissionRespH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiCheckPermission", "status": "DENIED" / "GRANTED", "permissions": [ "0": { "status": "GRANTED", "label": "android.permission.SEND_SMS" } "1": { "status": "GRANTED", "label": "android.permission.READ_PHONE_STATE" } "2": { "status": "GRANTED", "label": "android.permission.RECEIVE_SMS" } ] }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:checkPermissionRespH // block:start:getPermissionReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetPermission" } } // block:end:getPermissionReqH // block:start:getPermissionRespH { "errorMessage": "", "requestId": "", "service": "in.juspay.inappupi", "payload": { "permissions": [ { "label": "android.permission.SEND_SMS", "status": "GRANTED / DENIED" }, { "label": "android.permission.READ_PHONE_STATE", "status": "GRANTED / DENIED"" }, { "label": "android.permission.RECEIVE_SMS", "status": "GRANTED / DENIED"" }, { "label": "android.permission.READ_SMS", "status": "GRANTED / DENIED"" } ], "status": "SUCCESS / FAILURE", "action": "upiGetPermission" }, "errorCode": "", "event": "process_result", "error": false } // block:end:getPermissionRespH // block:start:sessionTokenReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetSessionToken", "merchantKeyId": "", "signature": "", "signaturePayload": "" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "abcde12345", "timestamp": "1668389349848" } // block:end:sessionTokenReqH // block:start:sessionTokenRespH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetSessionToken", "status": "LINKED", "isDeviceBound": "true", "isDeviceActivated": "true", "vpaAccounts": [{ "account": { "bankCode": "11111", "bankName": "ABCD", "maskedAccountNumber": "XXXX203891", "mpinLength": "6", "mpinSet": "true", "referenceId": "A0760cb548bb4dda9d32e3030863dd5", "bankAccountUniqueId": "ABCD123", "isPrimary": "true", "isInitialTopUpDone": "true", //In case of UPI lite "otpLength": "6", "atmPinLength": "6", "type": "SAVINGS", "branchName": "ABC", "ifsc": "AABC1000000", "name": "Venkat", "supportedFeatures": { "recurrenceMandate": true, "upiCredit": false, "aadhaar": true, "fir": true, "emi": false, "liteOffline": false, "base": true, "bioAuth": true, "nfs": false, "global": false, "ccBill": true, "clDynamicKeys": false, "voucherManagementSystem": false, "credit": false, "mandate": true, "lite": false }, }, "vpa": "abc@xyz" }], "prefix": "XYZ", "customerMobileNumber": "XXXXXX7777", "deviceFingerPrint": "d925f3dbcfac" }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:sessionTokenRespH // block:start:getSimDetailsReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetSimDetails", } } // block:end:getSimDetailsReqH // block:start:getSimDetailsRespH { "requestId": "", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetSimDetails", "status": "SUCCESS/FAILURE", "simDetails": [ { "id": "< id >", "provider": "< provider >", "simSerialNo": "< simSerialNo >" }, { "id": "< id >", "provider": "< provider >", "simSerialNo": "< simSerialNo >" } ] }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:getSimDetailsRespH // block:start:bindActivateDeviceReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiBindActivateDevice", "simId": "", "customerMobileNumber": "9876543210", "isBindAndActivateRequest": true, "merchantKeyId": "", "signature": "", "signaturePayload": "" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "1234567", "timestamp": "234562345" } // block:end:bindActivateDeviceReqH // block:start:bindActivateDeviceRespH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiBindActivateDevice", "status": "SUCCESS", "isDeviceBound": "true", "isDeviceActivated": "true", "vpaAccounts": [{ "account": { "bankCode": "11111", "bankName": "ABCD", "maskedAccountNumber": "XXXX203891", "mpinLength": "6", "mpinSet": "true", "referenceId": "A0760cb548bb4dda9d32e3030863dd5", "isPrimary": "true", "otpLength": "6", "atmPinLength": "6" }, "vpa": "abc@xyz", }], "prefix": "XYZ" }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:bindActivateDeviceRespH // block:start:getAccountsReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetAccounts", "bankCodes": ["code"], "aadhaarConsent":"true" } } // block:end:getAccountsReqH // block:start:getAccountsRespH { "requestId": "", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetAccounts", "status": "SUCCESS" / "FAILURE", "accounts": [ < list of accounts > ], "vpaSuggestions": [] }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:getAccountsRespH // block:start:getBankListReq { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetBankList" } } // block:end:getBankListReq // block:start:getBankListResp { "service": "in.juspay.hyperapi", "requestId": "f62cf173-0da9-4d78-ba9e-4ad0f61dff40", "payload": { "status": "SUCCESS", "bankList": [ { "upiEnabled": "true", "name": "Mybank", "iin": "500002", "id": "A9a54e051d6341fa9754a931ed15208", "supported": { "recurrenceMandate": true, "mandate": true, "lite": true, "global": false, "fir": true, "credit": true, "base": true }, }, { "upiEnabled": "true", "name": "YesBank", "iin": "612346", "id": "Ad250241cc00425fa58df480230f0c0", "supported": { "recurrenceMandate": true, "mandate": true, "lite": true, "global": false, "fir": true, "credit": true, "base": true }, }, { "upiEnabled": "true", "name": "Mybank-Yes", "iin": "500007", "id": "Ad250241cc00425fa58df480230f0c0", "supported": { "recurrenceMandate": true, "mandate": true, "lite": true, "global": false, "fir": true, "credit": true, "base": true }, }, ... ], "action": "upiGetBankList" }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:getBankListResp // block:start:vpaAvailableReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiVpaAvailability", "customerVpa": "something@handle" } } // block:end:vpaAvailableReqH // block:start:vpaAvailableRespH { "requestId": "", "service": "in.juspay.hyperapi", "payload": { "action": "upiVpaAvailability", "status": "SUCCESS" / "FAILURE", "available": "true" / "false", "vpaSuggestions": [] }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:vpaAvailableRespH // block:start:linkAccountsReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiLinkAccounts", "customerVpa": "something@handle", "accountReferenceIds": ["acc1", "acc2"] } } // block:end:linkAccountsReqH // block:start:linkAccountsRespH { "requestId": "", "service": "in.juspay.hyperapi", "payload": { "action": "upiLinkAccounts", "status": "SUCCESS" / "FAILURE", "customerMobileNumber": "XXXX7890", "vpaAccounts": [{ "account": { "bankCode": "11111", "bankName": "ABCD", "maskedAccountNumber": "XXXX203891", "mpinLength": "6", "mpinSet": "true", "referenceId": "A0760cb548bb4dda9d32e3030863dd5", "isPrimary": "true", "otpLength": "6", "atmPinLength": "6" }, "vpa": "abc@xyz" }], "gatewayResponseCode": "", "gatewayResponseMessage": "", "defaultAccountReferenceId":"A0760cb548bb4dda9d32e3030863dd5" }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:linkAccountsRespH // block:start:setMpinDebitReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiSetMpin", "customerVpa": "something@handle", "upiRequestId": "", "accountReferenceId": "", "card": "123456", "expiry": "MMYY", "getCardDetailsInCL":"true" } } // block:end:setMpinDebitReqH // block:start:setMpinAadhaarReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiSetMpin", "customerVpa": "something@handle", "upiRequestId": "", "accountReferenceId": "", "aadhaarNo":"111122", "aadhaarConsent":"true", "getCardDetailsInCL":"true" } } // block:end:setMpinAadhaarReqH ``` ### Response snippets: #### Response: ```plaintext // block:start:checkPermissionReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiCheckPermission" } } // block:end:checkPermissionReqH // block:start:checkPermissionRespH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiCheckPermission", "status": "DENIED" / "GRANTED", "permissions": [ "0": { "status": "GRANTED", "label": "android.permission.SEND_SMS" } "1": { "status": "GRANTED", "label": "android.permission.READ_PHONE_STATE" } "2": { "status": "GRANTED", "label": "android.permission.RECEIVE_SMS" } ] }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:checkPermissionRespH // block:start:getPermissionReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetPermission" } } // block:end:getPermissionReqH // block:start:getPermissionRespH { "errorMessage": "", "requestId": "", "service": "in.juspay.inappupi", "payload": { "permissions": [ { "label": "android.permission.SEND_SMS", "status": "GRANTED / DENIED" }, { "label": "android.permission.READ_PHONE_STATE", "status": "GRANTED / DENIED"" }, { "label": "android.permission.RECEIVE_SMS", "status": "GRANTED / DENIED"" }, { "label": "android.permission.READ_SMS", "status": "GRANTED / DENIED"" } ], "status": "SUCCESS / FAILURE", "action": "upiGetPermission" }, "errorCode": "", "event": "process_result", "error": false } // block:end:getPermissionRespH // block:start:sessionTokenReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetSessionToken", "merchantKeyId": "", "signature": "", "signaturePayload": "" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "abcde12345", "timestamp": "1668389349848" } // block:end:sessionTokenReqH // block:start:sessionTokenRespH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetSessionToken", "status": "LINKED", "isDeviceBound": "true", "isDeviceActivated": "true", "vpaAccounts": [{ "account": { "bankCode": "11111", "bankName": "ABCD", "maskedAccountNumber": "XXXX203891", "mpinLength": "6", "mpinSet": "true", "referenceId": "A0760cb548bb4dda9d32e3030863dd5", "bankAccountUniqueId": "ABCD123", "isPrimary": "true", "isInitialTopUpDone": "true", //In case of UPI lite "otpLength": "6", "atmPinLength": "6", "type": "SAVINGS", "branchName": "ABC", "ifsc": "AABC1000000", "name": "Venkat", "supportedFeatures": { "recurrenceMandate": true, "upiCredit": false, "aadhaar": true, "fir": true, "emi": false, "liteOffline": false, "base": true, "bioAuth": true, "nfs": false, "global": false, "ccBill": true, "clDynamicKeys": false, "voucherManagementSystem": false, "credit": false, "mandate": true, "lite": false }, }, "vpa": "abc@xyz" }], "prefix": "XYZ", "customerMobileNumber": "XXXXXX7777", "deviceFingerPrint": "d925f3dbcfac" }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:sessionTokenRespH // block:start:getSimDetailsReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetSimDetails", } } // block:end:getSimDetailsReqH // block:start:getSimDetailsRespH { "requestId": "", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetSimDetails", "status": "SUCCESS/FAILURE", "simDetails": [ { "id": "< id >", "provider": "< provider >", "simSerialNo": "< simSerialNo >" }, { "id": "< id >", "provider": "< provider >", "simSerialNo": "< simSerialNo >" } ] }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:getSimDetailsRespH // block:start:bindActivateDeviceReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiBindActivateDevice", "simId": "", "customerMobileNumber": "9876543210", "isBindAndActivateRequest": true, "merchantKeyId": "", "signature": "", "signaturePayload": "" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "1234567", "timestamp": "234562345" } // block:end:bindActivateDeviceReqH // block:start:bindActivateDeviceRespH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiBindActivateDevice", "status": "SUCCESS", "isDeviceBound": "true", "isDeviceActivated": "true", "vpaAccounts": [{ "account": { "bankCode": "11111", "bankName": "ABCD", "maskedAccountNumber": "XXXX203891", "mpinLength": "6", "mpinSet": "true", "referenceId": "A0760cb548bb4dda9d32e3030863dd5", "isPrimary": "true", "otpLength": "6", "atmPinLength": "6" }, "vpa": "abc@xyz", }], "prefix": "XYZ" }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:bindActivateDeviceRespH // block:start:getAccountsReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetAccounts", "bankCodes": ["code"], "aadhaarConsent":"true" } } // block:end:getAccountsReqH // block:start:getAccountsRespH { "requestId": "", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetAccounts", "status": "SUCCESS" / "FAILURE", "accounts": [ < list of accounts > ], "vpaSuggestions": [] }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:getAccountsRespH // block:start:getBankListReq { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetBankList" } } // block:end:getBankListReq // block:start:getBankListResp { "service": "in.juspay.hyperapi", "requestId": "f62cf173-0da9-4d78-ba9e-4ad0f61dff40", "payload": { "status": "SUCCESS", "bankList": [ { "upiEnabled": "true", "name": "Mybank", "iin": "500002", "id": "A9a54e051d6341fa9754a931ed15208", "supported": { "recurrenceMandate": true, "mandate": true, "lite": true, "global": false, "fir": true, "credit": true, "base": true }, }, { "upiEnabled": "true", "name": "YesBank", "iin": "612346", "id": "Ad250241cc00425fa58df480230f0c0", "supported": { "recurrenceMandate": true, "mandate": true, "lite": true, "global": false, "fir": true, "credit": true, "base": true }, }, { "upiEnabled": "true", "name": "Mybank-Yes", "iin": "500007", "id": "Ad250241cc00425fa58df480230f0c0", "supported": { "recurrenceMandate": true, "mandate": true, "lite": true, "global": false, "fir": true, "credit": true, "base": true }, }, ... ], "action": "upiGetBankList" }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:getBankListResp // block:start:vpaAvailableReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiVpaAvailability", "customerVpa": "something@handle" } } // block:end:vpaAvailableReqH // block:start:vpaAvailableRespH { "requestId": "", "service": "in.juspay.hyperapi", "payload": { "action": "upiVpaAvailability", "status": "SUCCESS" / "FAILURE", "available": "true" / "false", "vpaSuggestions": [] }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:vpaAvailableRespH // block:start:linkAccountsReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiLinkAccounts", "customerVpa": "something@handle", "accountReferenceIds": ["acc1", "acc2"] } } // block:end:linkAccountsReqH // block:start:linkAccountsRespH { "requestId": "", "service": "in.juspay.hyperapi", "payload": { "action": "upiLinkAccounts", "status": "SUCCESS" / "FAILURE", "customerMobileNumber": "XXXX7890", "vpaAccounts": [{ "account": { "bankCode": "11111", "bankName": "ABCD", "maskedAccountNumber": "XXXX203891", "mpinLength": "6", "mpinSet": "true", "referenceId": "A0760cb548bb4dda9d32e3030863dd5", "isPrimary": "true", "otpLength": "6", "atmPinLength": "6" }, "vpa": "abc@xyz" }], "gatewayResponseCode": "", "gatewayResponseMessage": "", "defaultAccountReferenceId":"A0760cb548bb4dda9d32e3030863dd5" }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:linkAccountsRespH // block:start:setMpinDebitReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiSetMpin", "customerVpa": "something@handle", "upiRequestId": "", "accountReferenceId": "", "card": "123456", "expiry": "MMYY", "getCardDetailsInCL":"true" } } // block:end:setMpinDebitReqH // block:start:setMpinAadhaarReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiSetMpin", "customerVpa": "something@handle", "upiRequestId": "", "accountReferenceId": "", "aadhaarNo":"111122", "aadhaarConsent":"true", "getCardDetailsInCL":"true" } } // block:end:setMpinAadhaarReqH ``` --- ## Complete Code Reference The following code files are referenced in the steps above: ### InappHeadless.txt ``` // block:start:checkPermissionReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiCheckPermission" } } // block:end:checkPermissionReqH // block:start:checkPermissionRespH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiCheckPermission", "status": "DENIED" / "GRANTED", "permissions": [ "0": { "status": "GRANTED", "label": "android.permission.SEND_SMS" } "1": { "status": "GRANTED", "label": "android.permission.READ_PHONE_STATE" } "2": { "status": "GRANTED", "label": "android.permission.RECEIVE_SMS" } ] }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:checkPermissionRespH // block:start:getPermissionReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetPermission" } } // block:end:getPermissionReqH // block:start:getPermissionRespH { "errorMessage": "", "requestId": "", "service": "in.juspay.inappupi", "payload": { "permissions": [ { "label": "android.permission.SEND_SMS", "status": "GRANTED / DENIED" }, { "label": "android.permission.READ_PHONE_STATE", "status": "GRANTED / DENIED"" }, { "label": "android.permission.RECEIVE_SMS", "status": "GRANTED / DENIED"" }, { "label": "android.permission.READ_SMS", "status": "GRANTED / DENIED"" } ], "status": "SUCCESS / FAILURE", "action": "upiGetPermission" }, "errorCode": "", "event": "process_result", "error": false } // block:end:getPermissionRespH // block:start:sessionTokenReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetSessionToken", "merchantKeyId": "", "signature": "", "signaturePayload": "" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "abcde12345", "timestamp": "1668389349848" } // block:end:sessionTokenReqH // block:start:sessionTokenRespH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetSessionToken", "status": "LINKED", "isDeviceBound": "true", "isDeviceActivated": "true", "vpaAccounts": [{ "account": { "bankCode": "11111", "bankName": "ABCD", "maskedAccountNumber": "XXXX203891", "mpinLength": "6", "mpinSet": "true", "referenceId": "A0760cb548bb4dda9d32e3030863dd5", "bankAccountUniqueId": "ABCD123", "isPrimary": "true", "isInitialTopUpDone": "true", //In case of UPI lite "otpLength": "6", "atmPinLength": "6", "type": "SAVINGS", "branchName": "ABC", "ifsc": "AABC1000000", "name": "Venkat", "supportedFeatures": { "recurrenceMandate": true, "upiCredit": false, "aadhaar": true, "fir": true, "emi": false, "liteOffline": false, "base": true, "bioAuth": true, "nfs": false, "global": false, "ccBill": true, "clDynamicKeys": false, "voucherManagementSystem": false, "credit": false, "mandate": true, "lite": false }, }, "vpa": "abc@xyz" }], "prefix": "XYZ", "customerMobileNumber": "XXXXXX7777", "deviceFingerPrint": "d925f3dbcfac" }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:sessionTokenRespH // block:start:getSimDetailsReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetSimDetails", } } // block:end:getSimDetailsReqH // block:start:getSimDetailsRespH { "requestId": "", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetSimDetails", "status": "SUCCESS/FAILURE", "simDetails": [ { "id": "< id >", "provider": "< provider >", "simSerialNo": "< simSerialNo >" }, { "id": "< id >", "provider": "< provider >", "simSerialNo": "< simSerialNo >" } ] }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:getSimDetailsRespH // block:start:bindActivateDeviceReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiBindActivateDevice", "simId": "", "customerMobileNumber": "9876543210", "isBindAndActivateRequest": true, "merchantKeyId": "", "signature": "", "signaturePayload": "" } } "signaturePayload": { "merchant_id": "stock", "customer_id": "1234567", "timestamp": "234562345" } // block:end:bindActivateDeviceReqH // block:start:bindActivateDeviceRespH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiBindActivateDevice", "status": "SUCCESS", "isDeviceBound": "true", "isDeviceActivated": "true", "vpaAccounts": [{ "account": { "bankCode": "11111", "bankName": "ABCD", "maskedAccountNumber": "XXXX203891", "mpinLength": "6", "mpinSet": "true", "referenceId": "A0760cb548bb4dda9d32e3030863dd5", "isPrimary": "true", "otpLength": "6", "atmPinLength": "6" }, "vpa": "abc@xyz", }], "prefix": "XYZ" }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:bindActivateDeviceRespH // block:start:getAccountsReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetAccounts", "bankCodes": ["code"], "aadhaarConsent":"true" } } // block:end:getAccountsReqH // block:start:getAccountsRespH { "requestId": "", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetAccounts", "status": "SUCCESS" / "FAILURE", "accounts": [ < list of accounts > ], "vpaSuggestions": [] }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:getAccountsRespH // block:start:getBankListReq { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiGetBankList" } } // block:end:getBankListReq // block:start:getBankListResp { "service": "in.juspay.hyperapi", "requestId": "f62cf173-0da9-4d78-ba9e-4ad0f61dff40", "payload": { "status": "SUCCESS", "bankList": [ { "upiEnabled": "true", "name": "Mybank", "iin": "500002", "id": "A9a54e051d6341fa9754a931ed15208", "supported": { "recurrenceMandate": true, "mandate": true, "lite": true, "global": false, "fir": true, "credit": true, "base": true }, }, { "upiEnabled": "true", "name": "YesBank", "iin": "612346", "id": "Ad250241cc00425fa58df480230f0c0", "supported": { "recurrenceMandate": true, "mandate": true, "lite": true, "global": false, "fir": true, "credit": true, "base": true }, }, { "upiEnabled": "true", "name": "Mybank-Yes", "iin": "500007", "id": "Ad250241cc00425fa58df480230f0c0", "supported": { "recurrenceMandate": true, "mandate": true, "lite": true, "global": false, "fir": true, "credit": true, "base": true }, }, ... ], "action": "upiGetBankList" }, "event": "process_result", "errorMessage": "", "errorCode": "", "error": false } // block:end:getBankListResp // block:start:vpaAvailableReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiVpaAvailability", "customerVpa": "something@handle" } } // block:end:vpaAvailableReqH // block:start:vpaAvailableRespH { "requestId": "", "service": "in.juspay.hyperapi", "payload": { "action": "upiVpaAvailability", "status": "SUCCESS" / "FAILURE", "available": "true" / "false", "vpaSuggestions": [] }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:vpaAvailableRespH // block:start:linkAccountsReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiLinkAccounts", "customerVpa": "something@handle", "accountReferenceIds": ["acc1", "acc2"] } } // block:end:linkAccountsReqH // block:start:linkAccountsRespH { "requestId": "", "service": "in.juspay.hyperapi", "payload": { "action": "upiLinkAccounts", "status": "SUCCESS" / "FAILURE", "customerMobileNumber": "XXXX7890", "vpaAccounts": [{ "account": { "bankCode": "11111", "bankName": "ABCD", "maskedAccountNumber": "XXXX203891", "mpinLength": "6", "mpinSet": "true", "referenceId": "A0760cb548bb4dda9d32e3030863dd5", "isPrimary": "true", "otpLength": "6", "atmPinLength": "6" }, "vpa": "abc@xyz" }], "gatewayResponseCode": "", "gatewayResponseMessage": "", "defaultAccountReferenceId":"A0760cb548bb4dda9d32e3030863dd5" }, "error": false, "errorMessage": "", "errorCode": "", "event": "process_result" } // block:end:linkAccountsRespH // block:start:setMpinDebitReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiSetMpin", "customerVpa": "something@handle", "upiRequestId": "", "accountReferenceId": "", "card": "123456", "expiry": "MMYY", "getCardDetailsInCL":"true" } } // block:end:setMpinDebitReqH // block:start:setMpinAadhaarReqH { "requestId": "f7443c1d-9acb-4b3d-9ae5-0e3c33dfcf5b", "service": "in.juspay.hyperapi", "payload": { "action": "upiSetMpin", "customerVpa": "something@handle", "upiRequestId": "", "accountReferenceId": "", "aadhaarNo":"111122", "aadhaarConsent":"true", "getCardDetailsInCL":"true" } } // block:end:setMpinAadhaarReqH ``` --- ## See Also - [UPI Get Bank List](https://juspay.io/in/docs/upi-tpap-sdk/android/headless-process-payloads/upi-get-bank-list) - [Is Vpa Available](https://juspay.io/in/docs/upi-tpap-sdk/android/headless-process-payloads/is-vpa-available)