Parameters
Clients must make sure to add these required metrics while invoking JuspayBrowserFragmet. These metrics are crucial for the transaction to complete and have seamless analytics. Find below the set of parameters which can be passed to us:
| Variable | Description | Required | Default |
|---|---|---|---|
| merchantId | Identifies the merchant. Eg. 'merchant' | Yes | |
| clientId | ClientID created in Merchant Portal. Eg. 'merchant_android' | Yes | |
| transactionId | Indicates the transactionId | Yes | |
| orderId | OrderID is the alternative to transactionId. | No | |
| payment_status | Indicates the final status of transaction. Detailed in Chapt 7. | Yes | |
| customerId | Unique identifier of the customer | No | |
| displayNote | Short note about transaction | No | |
| remarks | Remarks about transaction. This will automatically be filled up in the bank page. | No | |
| amount | Amount of the transaction | No | |
| customerEmail | Customer's email address | No | |
| customerPhoneNumber | Customer's phone number | No | |
| progressDialogEnabled | If passed as false, juspay’s custom progress dialogs would not be shown while a page is loaded. Pass true to let juspay handle the dialogs. | No | true |
| showJuspayAutoHelp | If true, we show a help screen automatically on the first use of the library. Set argument to false if you dont want to show the help | No | true |
| clearCookies | If true, we will clear webView cookies whenever Juspay Webview is initialized. Set argument to false if you dont want to clear cookies | No | true |
| card_brand | This argument contains enums like MasterCard, Visa, Maestro, etc | Yes | |
| card_type | Indicates type of card used i.e. debit or credit | Yes |
Custom Parameters
| Variable | Description | Required |
|---|---|---|
| udf_:var1 | Custom Field | No |
| udf_:var2 | Custom Field | No |
| udf_:var3 | Custom Field | No |
| udf_:var4 | Custom Field | No |
| udf_:var5 | Custom Field | No |
// Bundle of parameters to pass to Juspay
Bundle args = new Bundle();
args.putString("url", "https://www.merchant-website.com");
args.putString("merchantId", your_merchant_id); // eg: "juspay_recharge"
args.putString("transactionId", unique_transaction_id); // eg "123aba321"
args.putString("clientId", your_client_id); // eg: "juspay_recharge_android"
args.putString("customerId", unique_customer_id); // eg: "cust_1221232"
args.putString("displayNote", "Custom note to display during transaction"); // eg: "Recharging 9829880095 with Rs. 10"
args.putString("remarks", "Custom remark to auto-fill on bank page"); // eg: "Transaction at Juspay Recharge"
args.putString("amount", transaction_amount); // eg: "10"
args.putString("customerEmail", customer_email); // eg: "[email protected]"
args.putString("customerPhoneNumber", customer_phone_number); // eg: "9829880095"
args.putSerializable("card_brand", CardBrand.VISA);
args.putSerializable("card_type", CardType.CREDIT_CARD);
// Custom parameters. Here we send 3 custom key-values related to a recharge transaction.
args.putString("udf_operator", recharge_operator);
args.putString("udf_circle", recharge_circle);
args.putString("udf_type", recharge_type);
browserFragment.setArguments(args);
Custom Headers
If required, custom HTTP headers can be set before the browser is intiallized. These will be honored only if it is a GET request.
//Setting Custom Headers
Map<String, String> customHeaders = new HashMap<String, String>();
customHeaders.put("Accept-Encoding", "gzip, deflate, sdch");
customHeaders.put("Accept-Language", "en-US,en;q=0.8");
customParameters.put("customHeaders", (Serializable) customHeaders);
browserParams.setCustomParameters(customParameters);