--- page_source: https://juspay.io/in/docs/payment-method-integrations/hypercheckout/consumer-finance/snapmint page_title: Snapmint --- # Snapmint Integration The gateway Snapmint can be configured from the dashboard directly like any other gateway or payment method. Please follow the below steps to get the same implemented for your account. ## Gateway Configuration ### Step 1.1. Substep Attaching the detailed steps for the configuration of the Gateway _Step 1:_ Login to your Juspay Dashboard. _Step 2:_ Navigate to **EC Operations** ยป **PG Control Center** and select **Gateways.** ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/payment-method-integrations/Screenshot%202023-10-28%20at%202.46.51%20PM-rQ52G.png) _Step 3:_ Click on **Create Gateway** and select **Snapmint** from the available options. ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/payment-method-integrations/Screenshot%202023-10-28%20at%202.53.39%20PM-pwtbN.png) _Step 4:_ Enter Gateway Credentials either in TEST or LIVE mode as per your requirement. All the fields mentioned here are mandatory apart from Gateway Reference ID. _Step 5:_ Configure Payment method Type as Consumer Finance & payment method as Snapmint. ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/payment-method-integrations/Screenshot%202023-10-28%20at%202.56.43%20PM-x7UTk.png) ### Step 1.1. Enable Cardless EMI option in Juspay Studio * Enable Cardless EMI option on Juspay Studio if not done already. ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/payment-method-integrations/Screenshot%202023-12-01%20at%2011.35.45%20PM.png) *Cardless EMI Enablement* ## **Session Payload Changes** ### Step 1.1. Substep Snapmint requires additional parameters such as the Shipping, billing address and basket details to be passed for credit underwriting. Hence we suggest the merchants to send all the billing, shipping addresses (All lines and details). Attaching the sample payload to make necessary changes. > **Note** > It is **mandatory** to include **Shipping, Billing address and basket details** when processing a transaction. Failure to do so will result in a status of JUSPAY_DECLINED during the transaction attempt. The number passed in Session API will be taken for eligibility. For testing flows, Kindly scroll to the bottom of page and send those number in Session API. If you encounter challenges in Sending the shipping and billing addresses, please reach out to your Point of Contact (POC) at Snapmint for assistance. #### Shell Code Snippet: ```shell curl --location --request POST 'https://sandbox.juspay.in/session' \ --header 'version: 2023-11-01' \ --header 'x-merchantid: jptest' \ --header 'Authorization: Basic R******************************g==' \ --header 'Content-Type: application/json' \ --data-raw '{ "order_id": "Test_1701454471", "amount": "5000.00", "currency": "INR", "customer_id": "customer123", "customer_email": "customer@gmail.com", "customer_phone": "7777788888", "product_id": "prod-141833", "payment_page_client_id": "jptest", "return_url": "http://shop.merchant.com/payments/handleResponse", "description": "Sample description", "billing_address_first_name": "Juspay", "billing_address_last_name": "Technologies", "billing_address_line1": "Girija Building", "billing_address_line2": "Ganapathi Temple Road", "billing_address_line3": "8th Block, Koramangala", "billing_address_city": "Bengaluru", "billing_address_state": "Karnataka", "billing_address_country": "India", "billing_address_postal_code": "560095", "billing_address_phone": "9988775566", "billing_address_country_code_iso": "IND", "shipping_address_first_name": "Juspay", "shipping_address_last_name": "Technologies", "shipping_address_line1": "Girija Building", "shipping_address_line2": "Ganapathi Temple Road", "shipping_address_line3": "8th Block, Koramangala", "shipping_address_city": "Bengaluru", "shipping_address_state": "Karnataka", "shipping_address_postal_code": "560095", "shipping_address_country_code_iso": "IND", "shipping_address_country": "India", "basket": "[{\"id\":\"MK-RMB-32613-YVVT-GUD-B1C1\",\"quantity\":2,\"unitPrice\":7500,\"description\":\"iphone\",\"productURL\":\"https://www.google.com\",\"category\":\"Electronics\",\"sku\":\"123456\",\"sellerType\":\"VENDOR\",\"customParams\":{\"name1\":\"value1\",\"name2\":\"value2\"}}]", "metadata.SNAPMINT:snapmintTotalOrders": "5", "metadata.SNAPMINT:snapmintTotalOrderValue": "10000", "metadata.SNAPMINT:snapmintMaxOrderValue": "6000", "metadata.SNAPMINT:snapmintLast3Addresses": "110040 | 110042 | 110043", "metadata.SNAPMINT:snapmintLastOrderDate": "20230828" }' ``` Explanation of Metadata fields Snapmint details. | Fields | Explanation of Fields | |---|---| | metadata.SNAPMINT:snapmintMaxOrderValue | Maximum order value processed by a merchant with Snapmint. | | metadata.SNAPMINT:snapmintTotalOrderValue | Total order value processed by a merchant with Snapmint. | | metadata.SNAPMINT:snapmintMaxOrderValue | Max of value of all orders placed with merchant | | metadata.SNAPMINT:snapmintLast3Addresses | String with max length 1000.Last 3 unique pincodes where orders were placed from the merchant | | metadata.SNAPMINT:snapmintLastOrderDate | Date(YYYYMMDD). Last order date for the user | ### **Signature Based Integration Payload** #### Signature Payload Request Code Snippet: ```signature payload request { "requestId": "57535f34-d164-4c96-abb2-9de2899aaf0e", "service": "in.juspay.hyperpay", "payload": { "merchantId": "curefit", "customerId": "cth_9LjEgC67FjQsi7YX", "clientId": "cultfit", "merchantKeyId": "8792", "customerEmail": "test@juspay.com", "orderId": "2015639902", "customerMobile": "9110234217", "action": "paymentPage", "signature": "RUmzp/fweOU34+SCTa1pU3T63Geda9hrJ38ZhQ9g4/qbDFrE4DWXExapfpS/Q1gsPCjppMr1TAVoZNmQXVJppdtG1t7UZdlzl27cuF8nQ9NQ0KfNs05fVbDdebhQTZAxCnpG2hxORSeKAiRfcMlsmzRr63t1QL6tfAQe7zUXuGSFIs6Rcd3Sqebx0NzNWp18ohGMPvsS+fC5jx+LF8SKS5vKkofb4FAzbmVsPlp9mVj3XV4J5QMhK2cvMMKOMUMIVqi7NE52e9RNsF8jA7OJqTPCUmHNch8CTDaodhS3ArJY/8a+iq3rerNeEURHscO90MxbROKQjVJ4SeqHLzVrKg==", "amount": "46990", "orderDetails": "{\"order_id\":\"2015639902\",\"merchant_id\":\"curefit\",\"amount\":\"46990\",\"timestamp\":\"1714390530860\",\"customer_id\":\"cth_9LjEgC67FjQsi7YX\",\"currency\":\"INR\",\"customer_email\":\"RIPPIFILTEREDom\",\"customer_phone\":\"RIPPIFILTERED\",\"return_url\":\"https://www.cure.fit/eat/about\",\"shipping_address_first_name\":\"Juspay\",\"shipping_address_last_name\":\"Technologies\",\"shipping_address_line1\":\"Girija building\",\"shipping_address_city\":\"Bengaluru\",\"shipping_address_state\":\"Karnataka\",\"shipping_address_postal_code\":\"560095\",\"shipping_address_phone\":\"RIPPIFILTERED\",\"shipping_address_country_code_iso\":\"+91\",\"shipping_address_country\":\"India\",\"billing_address_first_name\":\"Juspay\",\"billing_address_last_name\":\"Technologies\",\"billing_address_line1\":\"Girija building\",\"billing_address_city\":\"Bengaluru\",\"billing_address_state\":\"Karnataka\",\"billing_address_postal_code\":\"560095\",\"billing_address_country\":\"India\",\"billing_address_phone\":\"560095\",\"billing_address_country_code_iso\":\"+91\",\"product_id\":\"491838009\",\"basket\":\"[{\\\"quantity\\\":1,\\\"description\\\":\\\"Test Product\\\",\\\"id\\\":\\\"4.3091484803292e13\\\",\\\"unitPrice\\\":17999,\\\"productURL\\\":\\\"https://www.google.com\\\"}]\",\"metadata.SNAPMINT:snapmintTotalOrders\":\"5\",\"metadata.SNAPMINT:snapmintTotalOrderValue\":\"20000\",\"metadata.SNAPMINT:snapmintMaxOrderValue\":\"6000\",\"metadata.SNAPMINT:snapmintLast3Addresses\":\"110040 | 110042 | 110043\",\"metadata.SNAPMINT:snapmintLastOrderDate\":\"20240402\",\"metadata.SNAPMINT:webhook_url\":\"https://www.cult.fit/api\",\"udf1\":\"cultfit\",\"udf2\":\"internal\",\"udf3\":\"JUSPAY_RP\",\"udf4\":\"NO-OFFER\",\"udf5\":\"NO_OFFER\",\"udf6\":\"NO_OFFER\",\"udf7\":\"NO_OFFER\",\"udf8\":\"NO_OFFER\",\"udf9\":\"BASIC\",\"udf10\":\"elite\",\"payment_filter\":{\"allowDefaultOptions\":true,\"options\":[{\"paymentMethodType\":\"CASH\",\"enable\":false}],\"emiOptions\":{\"standardEmi\":{\"enable\":true},\"lowCostEmi\":{\"enable\":false},\"noCostEmi\":{\"enable\":false}}},\"metadata.merchant_container_list\":\"[]\"}" } } ``` ## Sample Order Status Payload ### Step 1.1. Substep Attaching the sample order Status. #### JSON Code Snippet: ```json { "customer_email": "customer@gmail.com", "customer_phone": "7777788888", "customer_id": "test1", "status_id": 21, "status": "CHARGED", "id": "ordeh_156edb4b421445978d4b194e2252970a", "merchant_id": "jptest", "amount": 5000, "currency": "INR", "order_id": "JP_1701429443", "date_created": "2023-12-01T11:17:23Z", "return_url": "http://shop.merchant.com/payments/handleResponse", "product_id": "prod-141833", "payment_links": { "iframe": "https://sandbox.juspay.in/orders/ordeh_156edfdffdsdfgd4b194e2252970a/payment-page", "web": "https://sandbox.juspay.in/orders/ordeh_156edb4b42fdgfdgdfgfd194e2252970a/payment-page", "mobile": "https://sandbox.juspay.in/orders/ordeh_156edb4b4dfgfdgfdgdfffd194e2252970a/payment-page" }, "udf1": "", "udf2": "", "udf3": "", "udf4": "", "udf5": "", "udf6": "", "udf7": "", "udf8": "", "udf9": "", "udf10": "", "txn_id": "jptest-JP_1701429443-1", "payment_method_type": "CONSUMER_FINANCE", "auth_type": "", "payment_method": "SNAPMINT", "refunded": false, "amount_refunded": 0, "effective_amount": 5000, "resp_code": null, "resp_message": null, "bank_error_code": "", "bank_error_message": "", "txn_uuid": "moz44g2owchZSRjoWTu", "txn_detail": { "txn_id": "jptest-JP_1701429443-1", "order_id": "JP_1701429443", "status": "CHARGED", "error_code": null, "net_amount": 5000, "surcharge_amount": null, "tax_amount": null, "txn_amount": 5000, "offer_deduction_amount": null, "gateway_id": 263, "currency": "INR", "metadata": { "payment_channel": "\"WEB\"" }, "express_checkout": false, "redirect": true, "txn_uuid": "moz44g2owchZSRjoWTu", "gateway": "SNAPMINT", "error_message": "", "created": "2023-12-01T11:17:32Z", "txn_flow_type": "REDIRECT_DEBIT" }, "payment_gateway_response": { "resp_code": "Success", "rrn": "", "created": "2023-12-01T11:19:30Z", "epg_txn_id": "46905", "resp_message": "CAPTURED", "auth_id_code": "NA", "txn_id": "jptest-JP_1701429443-1", "debit_amount": "1667" }, "gateway_id": 263, "metadata": { "payment_page_sdk_payload": "{\"shippingAddressPostalCode\":\"560095\",\"amount\":\"5000.00\",\"basket\":\"[{\\\"id\\\":\\\"MK-RMB-32613-YVVT-GUD-B1C1\\\",\\\"quantity\\\":2,\\\"unitPrice\\\":7500,\\\"description\\\":\\\"iphone\\\",\\\"productURL\\\":\\\"https://www.google.com\\\",\\\"category\\\":\\\"Electronics\\\",\\\"sku\\\":\\\"123456\\\",\\\"sellerType\\\":\\\"VENDOR\\\",\\\"customParams\\\":{\\\"name1\\\":\\\"value1\\\",\\\"name2\\\":\\\"value2\\\"}}]\",\"shippingAddressState\":\"Karnataka\",\"shippingAddressLastName\":\"Technologies\",\"currency\":\"INR\",\"customerPhone\":\"7777788888\",\"customerEmail\":\"customer@gmail.com\",\"shippingAddressLine1\":\"Girija Building\",\"description\":\"Sample description\",\"shippingAddressFirstName\":\"Juspay\"}", "SNAPMINT:snapmintLastOrderDate": "20230828", "SNAPMINT:snapmintTotalOrders": "5", "merchant_payload": "{\"customerPhone\":\"7777788888\",\"customerEmail\":\"customer@gmail.com\"}", "SNAPMINT:snapmintMaxOrderValue": "6000", "payment_links": { "iframe": "https://sandbox.juspay.in/orders/ordehjklsdfjdskfdsf94e2252970a/payment-page", "web": "https://sandbox.juspay.in/orders/ordeh_156sdfdsfdsfdsfdb1sd94e2252970a/payment-page", "mobile": "https://sandbox.juspay.in/orders/ordeh_156dfsdfdsfdasfdasfadsf978d4b194e2252970a/payment-page" }, "payment_page_client_id": "toothsi", "SNAPMINT:snapmintTotalOrderValue": "10000", "SNAPMINT:snapmintLast3Addresses": "110040 | 110042 | 110043" }, "gateway_reference_id": null, "offers": [], "maximum_eligible_refund_amount": 5000, "basket": [ { "productName": null, "productUrl": null, "category": "Electronics", "quantity": 2, "customParams": { "name2": "value2", "name1": "value1" }, "passenger": null, "id": "MK-RMB-32613-YVVT-GUD-B1C1", "sku": "123456", "productRisk": null, "unitPrice": 7500, "shippingDestinationType": null, "description": "iphone", "productCode": null, "sellerType": "VENDOR" } ] } ``` ## Testing Scenarios (User Flows) | Phone Number | Flow | OTP, PAN and UPI ID | |---|---|---| | 7777788888 | OTP Only required | OTP-1010, Payment gateway select UPI - 7777777777@paytm | | 7878787878 | OTP and Pan Required | OTP-1010, Pan - APFPJ2575J Payment gateway select UPI - 7777777777@paytm | | 7878787879 | OTP, Pan and KYC Required | OTP-1010, Pan - APFPJ2575J Payment gateway select UPI - 7777777777@paytm | | 8888888887 | Credit Reject | | ## Analytics and Monitoring * Merchants can use the Juspay Transactions Analytics Dashboard to check and analyze the volume and success rates of Snapmint transactions. * Merchants can use the **Payment Gateway filter** and select '**SNAPMINT** ' on the Juspay Transactions Analytics Dashboard to check the Success Rates. ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/payment-method-integrations/Screenshot%202023-12-14%20at%2011.25.24%20AM.png) *Snapmint SR * **Flows Supported by Snap:** 1. Transaction initiation - EMI (1st tenure payment). 2. Transaction for PreAuth and Capture - Capture and Void. 3. Transaction Sync. 4. Refund. 5. Refund Sync.