--- page_source: https://juspay.io/in/docs/payment-method-integrations/express-checkout-api/gift-card-integration/qwikcilver-gift-cards page_title: Qwikcilver Gift Cards --- # Qwikcilver **Documentation** Gift cards feature allows merchants to enhance user engagement by integrating gifting experience including corporate gifts, personal gifts and personalised offers from merchants. **Key Features :** 1. Check Gift card balance. 2. Allows the customer to pay the entire order with a single gift card. 3. Allows the customer to pay with multiple gift cards 4. Allows customer to pay with 1 traditional instrument (NB, Cards, Wallets , UPI) and multiple gift cards. ## **1. Gateway Configuration** ### Step 1.1. Gateway Configurations #### **Step 1: Dashboard** Sandbox Dashboard Url - [https://sandbox.portal.juspay.in](https://sandbox.portal.juspay.in) Production Dashboard Url - [https://portal.juspay.in/](https://portal.juspay.in/) Post Login to Dashboard, Click on EC Operations > PG Control Centre. From the Other Gateway • Select Qwikcilver Gateway • Please enter the below credentials obtained from Qwikcilver Team. | Juspay Dashboard Fields | Mandatory / Optional | Remarks | |---|---|---| | Terminal ID | Mandatory | | | Merchant Outlet name | Mandatory | | | User Name | Mandatory | | | Password | Mandatory | | | Forwarding entity Id | Mandatory | | | Forwarding entity password | Mandatory | | | Host tag | Mandatory | Should be configured without the “http://” | | Rest of the fields | NA | | ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/payment-method-integrations/QC%20Gateway%20-%201%20.png) *QC gateway - 1* ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/payment-method-integrations/QC%20Gateway%20-%202%20.png) *QC Gateway - 2* ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/payment-method-integrations/QC%20Gateway%20-%203.png) *QC Gateway - 3* ### Payment Method Configuration Select QWIKCILVER Gift Cards from payment Method Configurations ![Image](/images/noimage.png) ## **2. End-to-end User flow** ### Step 1.1. Only Gift Card User lands on the Juspay Hosted payment page and clicks on the Add Gift card option. Post entering the correct details, user would be able to add the card and make payment. In this case, Juspay will call Direct debit to QC and the whole amount would be in debited from the users card. Attaching Sample Flow ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/payment-method-integrations/image%20(8).png) *Gift Card Flow* ### Step 1.1. Split Payment Flow In case user does not have sufficient balance in the gift card, User can choose to make the remaning amount payment via another Gift card, Debit/Credit Card, UPI or NB. Juspay will initiate transaction call to the other payment method and will simultaneously call PreAuth to QC. Once we get a successful conformation from the other payment method , Juspay will call capture to QC. Else, cases where primary txns fails, juspay will call void to QC. Attaching Sample Flow ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/payment-method-integrations/image%20(9).png) *Split Payment Flow * > **Note** > Juspay has the mechanism to re-try the Qwikcilver transaction if the Capture fails for the first time. > > We have also implemented idempotency for this flow. ## **3. Sample Requests and Responses** In the current Juspay implementation, transaction details such as payment method ,txn_id and other details are present in the root structure of the orderStatus JSON block. However, in the integration with Qwikcilver, which involves split transactions, you will find a **txn_list** as an array block containing the two transactions (UPI + Qwikcilver). It is essential to extract parameters from within the _**txn_list**_ array block. A sample response is attached below for reference. ### **Order Status** ### Step 1.1. Request Order status request #### Shell Code Snippet: ```shell curl --location --request GET 'https://sandbox.juspay.in/orders/50839330937' \ --header 'Authorization: Basic XYZ' \ --header 'version: 2023-10-01' ``` ### Step 1.1. Response Order status Responses. (Kindly use the drop down below) 1. Only Gift Card 2. Gift Card + Cards 3. Gift Card + UPI 4. Two Gift cards + UPI #### Only Gift card Code Snippet: ```only gift card { "customer_email": "test@juspay.net", "customer_phone": "9535693568", "customer_id": "VjUwI2U3MTkwNDZjLWY5YzQtNDYwOC1hZGVlLWVjNGQ3NmI4OTQyMg", "status_id": 21, "status": "CHARGED", "id": "ordeh_d4c1be562d994be8983b3864a86fd31a", "merchant_id": "snapdeal_test", "amount": 717, "currency": "INR", "order_id": "78142502", "date_created": "2023-07-14T08:02:44Z", "return_url": "https://www.snapdeal.com/", "product_id": "", "payment_links": { "iframe": "https://sandbox.juspay.in/orders/ordeh_d4c1be562d994be8983b3864a86fd31a/payment-page", "web": "https://sandbox.juspay.in/orders/ordeh_d4c1be562d994be8983b3864a86fd31a/payment-page", "mobile": "https://sandbox.juspay.in/orders/ordeh_d4c1be562d994be8983b3864a86fd31a/payment-page" }, "udf1": "APP", "udf2": "", "udf3": "311", "udf4": "", "udf5": "", "udf6": "", "udf7": "", "udf8": "", "udf9": "", "udf10": "", "txn_id": "snapdeal_test-78142502-1", "payment_method_type": "CARD", "auth_type": "NO_THREE_DS", "card": { "expiry_year": "2049", "card_reference": "", "saved_to_locker": false, "expiry_month": "12", "name_on_card": "qwick_cilver_card", "card_issuer": "", "last_four_digits": "3053", "using_saved_card": false, "card_fingerprint": "", "card_isin": "199253", "card_type": "CREDIT", "card_brand": "QWIKCILVER", "using_token": false, "tokens": [], "card_issuer_country": "", "juspay_bank_code": "", "extended_card_type": "CREDIT", "payment_account_reference": "" }, "payment_method": "QWIKCILVER", "refunded": false, "amount_refunded": 0, "effective_amount": 717, "resp_code": null, "resp_message": null, "bank_error_code": "", "bank_error_message": "", "txn_uuid": "moz4MNaEoDD4Q1FCvgY", "payment_gateway_response": { "resp_code": "0", "rrn": null, "created": "2023-07-14T08:03:00Z", "epg_txn_id": "13339385", "resp_message": "Transaction successful.", "auth_id_code": null, "txn_id": "snapdeal_test-78142502-1" }, "gateway_id": 47, "offers": [], "maximum_eligible_refund_amount": 717 } ``` #### GC + UPI Code Snippet: ```gc + upi { "customer_email": "kajshsh@gmail.com", "customer_phone": "9582671920", "customer_id": "VjUwIzkzZWQ5MzQ3LTM2ZjItNDQ2OC05MjhlLTJjNWE1NDVmMjI5MA", "status_id": 21, "status": "CHARGED", "id": "ordeh_bd301df673ce4a5db4f8430a46bd7543", "merchant_id": "snapdeal_test", "amount": 1420, "currency": "INR", "order_id": "78027491", "date_created": "2023-07-04T12:09:33Z", "return_url": "https://www.snapdeal.com/", "product_id": "", "payment_links": { "iframe": "https://sandbox.juspay.in/orders/ordeh_bd301df673ce4a5db4f8430a46bd7543/payment-page", "web": "https://sandbox.juspay.in/orders/ordeh_bd301df673ce4a5db4f8430a46bd7543/payment-page", "mobile": "https://sandbox.juspay.in/orders/ordeh_bd301df673ce4a5db4f8430a46bd7543/payment-page" }, "udf1": "APP", "udf2": "", "udf3": "88", "udf4": "", "udf5": "", "udf6": "", "udf7": "", "udf8": "", "udf9": "", "udf10": "", "refunded": false, "amount_refunded": 0, "effective_amount": 1420, "txn_list": [ { "txn_id": "snapdeal_test-78027491-1-1", "payment_method_type": "UPI", "auth_type": "", "payment_method": "UPI", "refunded": true, "amount_refunded": 420, "effective_amount": 420, "refunds": [ { "id": "1270194508_350461_680749", "amount": 420, "unique_request_id": "1270194508_350461_680749", "ref": null, "created": "2023-07-06T19:06:31Z", "status": "MANUAL_REVIEW", "error_message": "Refund got dropped", "sent_to_gateway": true, "initiated_by": "API", "refund_source": "RAZORPAY", "refund_type": "STANDARD", "error_code": "404" } ], "resp_code": null, "resp_message": null, "bank_error_code": "", "bank_error_message": "", "txn_uuid": "moz3Fa1jXpqCwGrWMGn", "txn_detail": { "txn_id": "snapdeal_test-78027491-1-1", "order_id": "78027491", "status": "CHARGED", "error_code": null, "net_amount": 1420, "surcharge_amount": null, "tax_amount": null, "txn_amount": 420, "offer_deduction_amount": null, "gateway_id": 23, "currency": "INR", "metadata": { "payment_channel": "\"ANDROID\"" }, "express_checkout": false, "redirect": true, "txn_uuid": "moz3Fa1jXpqCwGrWMGn", "gateway": "RAZORPAY", "error_message": "", "created": "2023-07-04T12:09:34Z", "txn_flow_type": "COLLECT" }, "payment_gateway_response": { "resp_code": "captured", "rrn": "417957372664", "created": "2023-07-04T12:09:47Z", "epg_txn_id": "pay_M9idmkZprEN4mI", "resp_message": "", "auth_id_code": "", "txn_id": "snapdeal_test-78027491-1-1", "debit_amount": "420.0" }, "gateway_id": 23, "gateway_reference_id": null, "payer_vpa": "success@upi", "upi": { "payer_vpa": "success@upi", "txn_flow_type": "COLLECT" }, "metadata": { "payment_links": { "iframe": "https://sandbox.juspay.in/orders/ordeh_bd301df673ce4a5db4f8430a46bd7543/payment-page", "web": "https://sandbox.juspay.in/orders/ordeh_bd301df673ce4a5db4f8430a46bd7543/payment-page", "mobile": "https://sandbox.juspay.in/orders/ordeh_bd301df673ce4a5db4f8430a46bd7543/payment-page" }, "payment_page_client_id": "defaultclient", "payment_locking": { "offer_details": "{\"merge_with_default_payment_methods\":\"true\",\"offer_applied\":\"false\",\"offer_payment_methods\":\"null\"}" } }, "offers": [], "status": "CHARGED" }, { "txn_id": "snapdeal_test-78027491-1-2", "payment_method_type": "CARD", "auth_type": "NO_THREE_DS", "card": { "expiry_year": "2049", "card_reference": "", "saved_to_locker": false, "expiry_month": "12", "name_on_card": "qwick_cilver_card", "card_issuer": "", "last_four_digits": "3503", "using_saved_card": false, "card_fingerprint": "", "card_isin": "199253", "card_type": "CREDIT", "card_brand": "QWIKCILVER", "using_token": false, "tokens": [], "card_issuer_country": "", "juspay_bank_code": "", "extended_card_type": "CREDIT", "payment_account_reference": "" }, "payment_method": "QWIKCILVER", "refunded": true, "amount_refunded": 420, "effective_amount": 1000, "refunds": [ { "id": null, "amount": 2, "unique_request_id": "qc401", "ref": null, "created": "2023-07-04T13:18:39Z", "status": "FAILURE", "error_message": "Validation Failed.", "sent_to_gateway": true, "initiated_by": "API", "refund_source": "QWIKCILVER", "refund_type": "STANDARD", "pg_declined_at": "2023-07-04T13:23:16Z", "error_code": "10838" }, { "id": null, "amount": 1000, "unique_request_id": "1270194508_350461_680750", "ref": null, "created": "2023-07-06T19:06:47Z", "status": "SUCCESS", "error_message": "", "sent_to_gateway": true, "initiated_by": "API", "refund_source": "QWIKCILVER", "refund_type": "STANDARD", "pg_processed_at": "2023-07-06T19:11:34Z", "error_code": null } ], "resp_code": null, "resp_message": null, "bank_error_code": "", "bank_error_message": "", "txn_uuid": "moz8Uf7eAythqCo6Rx8", "txn_detail": { "txn_id": "snapdeal_test-78027491-1-2", "order_id": "78027491", "status": "CHARGED", "error_code": null, "net_amount": 1420, "surcharge_amount": null, "tax_amount": null, "txn_amount": 1000, "offer_deduction_amount": null, "gateway_id": 47, "currency": "INR", "express_checkout": false, "redirect": false, "txn_uuid": "moz8Uf7eAythqCo6Rx8", "gateway": "QWIKCILVER", "error_message": "", "created": "2023-07-04T12:09:34Z", "txn_flow_type": "CARD_TRANSACTION" }, "payment_gateway_response": { "resp_code": "0", "rrn": null, "created": "2023-07-04T12:09:34Z", "epg_txn_id": "14050682", "resp_message": "Transaction successful.", "auth_id_code": null, "txn_id": "snapdeal_test-78027491-1-2" }, "gateway_id": 47, "gateway_reference_id": null, "metadata": { "payment_links": { "iframe": "https://sandbox.juspay.in/orders/ordeh_bd301df673ce4a5db4f8430a46bd7543/payment-page", "web": "https://sandbox.juspay.in/orders/ordeh_bd301df673ce4a5db4f8430a46bd7543/payment-page", "mobile": "https://sandbox.juspay.in/orders/ordeh_bd301df673ce4a5db4f8430a46bd7543/payment-page" }, "payment_page_client_id": "defaultclient", "payment_locking": { "offer_details": "{\"merge_with_default_payment_methods\":\"true\",\"offer_applied\":\"false\",\"offer_payment_methods\":\"null\"}" } }, "offers": [], "captured_amount": 1000, "refundable_amount": 0, "status": "CHARGED" } ] } ``` #### GC + Card Code Snippet: ```gc + card { "customer_email": "nagendra.p@juspay.in", "customer_phone": "7899438420", "customer_id": "cth_wxbDtsEDKUmz5VFD", "status_id": 21, "status": "CHARGED", "id": "ordeh_1075ef143dc14ad59b9a6f69423c7549", "merchant_id": "imdad_sandbox", "amount": 500, "currency": "INR", "order_id": "QC1645034191", "date_created": "2022-02-16T17:56:31Z", "return_url": "www.google.com", "product_id": "prod-819", "payment_links": { "iframe": "https://sandbox.juspay.in/merchant/ipay/ordeh_1075ef143dc14ad59b9a6f69423c7549", "web": "https://sandbox.juspay.in/merchant/pay/ordeh_1075ef143dc14ad59b9a6f69423c7549", "mobile": "https://sandbox.juspay.in/merchant/pay/ordeh_1075ef143dc14ad59b9a6f69423c7549?mobile=true" }, "udf1": "", "udf2": "", "udf3": "", "udf4": "", "udf5": "", "udf6": "", "udf7": "", "udf8": "", "udf9": "", "udf10": "", "refunded": false, "amount_refunded": 0, "effective_amount": 500, "txn_list": [ { "txn_id": "imdad_sandbox-QC1645034191-1-1", "payment_method_type": "CARD", "auth_type": "THREE_DS", "card": { "expiry_year": "2026", "card_reference": "", "saved_to_locker": false, "expiry_month": "10", "name_on_card": "name", "card_issuer": "Axis Bank", "last_four_digits": "8654", "using_saved_card": false, "card_fingerprint": "25gc1jcomifvhrpmjsut16lkro", "card_isin": "440006", "card_type": "CREDIT", "card_brand": "VISA", "using_token": false, "card_issuer_country": "INDIA", "juspay_bank_code": "JP_AXIS" }, "payment_method": "VISA", "refunded": true, "amount_refunded": 500, "effective_amount": 1, "refunds": [ { "id": "refund_1645034952", "amount": 500, "unique_request_id": "refund_1645034952", "ref": "6450351966986107905168", "created": "2022-02-16T18:09:13Z", "status": "SUCCESS", "error_message": "", "sent_to_gateway": true, "initiated_by": "API", "refund_source": "CYBERSOURCE", "refund_type": "STANDARD", "error_code": "100" } ], "resp_code": null, "resp_message": null, "bank_error_code": "", "bank_error_message": "", "txn_uuid": "eulkieohywvMAydXhfC", "txn_detail": { "txn_id": "imdad_sandbox-QC1645034191-1-1", "order_id": "QC1645034191", "status": "CHARGED", "error_code": null, "net_amount": 500, "surcharge_amount": null, "tax_amount": null, "txn_amount": 1, "offer_deduction_amount": null, "gateway_id": 6, "currency": "INR", "express_checkout": false, "redirect": true, "txn_uuid": "eulkieohywvMAydXhfC", "gateway": "CYBERSOURCE", "error_message": "", "created": "2022-02-16T17:56:41Z" }, "payment_gateway_response": { "resp_code": "100", "rrn": "NA", "created": "2022-02-16T17:57:11Z", "epg_txn_id": "6450342298006086505157", "resp_message": "Successful transaction.", "auth_id_code": "085804", "txn_id": "imdad_sandbox-QC1645034191-1-1" }, "gateway_id": 6, "gateway_reference_id": null, "metadata": { "txns.allow_card_no_3ds": "true" }, "offers": [], "status": "CHARGED" }, { "txn_id": "imdad_sandbox-QC1645034191-1-2", "payment_method_type": "CARD", "auth_type": "NO_THREE_DS", "card": { "expiry_year": "2049", "card_reference": "", "saved_to_locker": false, "expiry_month": "12", "name_on_card": "qwick_cilver_card", "card_issuer": "", "last_four_digits": "4494", "using_saved_card": false, "card_fingerprint": "", "card_isin": "251111", "card_type": "CREDIT", "card_brand": "QWIKCILVER", "using_token": false, "card_issuer_country": "", "juspay_bank_code": "" }, "payment_method": "QWIKCILVER", "refunded": true, "amount_refunded": 500, "effective_amount": 499, "resp_code": null, "resp_message": null, "bank_error_code": "", "bank_error_message": "", "txn_uuid": "eulkbNLzsScwnGAF6CQ", "txn_detail": { "txn_id": "imdad_sandbox-QC1645034191-1-2", "order_id": "QC1645034191", "status": "CHARGED", "error_code": null, "net_amount": 500, "surcharge_amount": null, "tax_amount": null, "txn_amount": 499, "offer_deduction_amount": null, "gateway_id": 47, "currency": "INR", "express_checkout": false, "redirect": true, "txn_uuid": "eulkbNLzsScwnGAF6CQ", "gateway": "QWIKCILVER", "error_message": "", "created": "2022-02-16T17:56:41Z" }, "payment_gateway_response": { "resp_code": "0", "rrn": null, "created": "2022-02-16T17:56:43Z", "epg_txn_id": "14308034", "resp_message": "Transaction successful.", "auth_id_code": null, "txn_id": "imdad_sandbox-QC1645034191-1-2" }, "gateway_id": 47, "gateway_reference_id": null, "metadata": { "txns.allow_card_no_3ds": "true" }, "offers": [], "captured_amount": 499, "refundable_amount": 499, "status": "CHARGED" } ] } ``` #### 2GC + UPI Code Snippet: ```2gc + upi { "customer_email": "test@gmail.com", "customer_phone": "9742144874", "customer_id": "9742144874", "status_id": 21, "status": "CHARGED", "id": "ordeh_33bf3dbcffe24bc8899670101f9f310c", "merchant_id": "picasso", "amount": 1001, "currency": "INR", "order_id": "hyperorder59350", "date_created": "2023-05-02T09:42:06Z", "return_url": "https://sandbox.juspay.in/end", "product_id": "", "payment_links": { "iframe": "https://sandbox.juspay.in/orders/ordeh_33bf3dbcffe24bc8899670101f9f310c/payment-page", "web": "https://sandbox.juspay.in/orders/ordeh_33bf3dbcffe24bc8899670101f9f310c/payment-page", "mobile": "https://sandbox.juspay.in/orders/ordeh_33bf3dbcffe24bc8899670101f9f310c/payment-page" }, "udf1": "", "udf2": "", "udf3": "", "udf4": "", "udf5": "", "udf6": "", "udf7": "", "udf8": "", "udf9": "", "udf10": "", "refunded": false, "amount_refunded": 0, "effective_amount": 1001, "txn_list": [ { "txn_id": "picasso-hyperorder59350-1-1", "payment_method_type": "UPI", "auth_type": "", "payment_method": "UPI", "refunded": true, "amount_refunded": 500, "effective_amount": 1, "refunds": [ { "id": "qc101", "amount": 1, "unique_request_id": "qc101", "ref": "20230517020968656340245367275527523", "created": "2023-05-17T11:10:33Z", "status": "SUCCESS", "error_message": "Refund Successfull", "sent_to_gateway": true, "arn": "350325757760", "initiated_by": "API", "refund_source": "PAYTM_V2", "refund_type": "STANDARD", "pg_processed_at": "2023-05-17T11:10:38Z", "bank_processed_at": "2023-05-17T11:10:38Z", "error_code": "10" } ], "resp_code": null, "resp_message": null, "bank_error_code": "", "bank_error_message": "", "txn_uuid": "mozijU1pZn3gbMxqGtz", "txn_detail": { "txn_id": "picasso-hyperorder59350-1-1", "order_id": "hyperorder59350", "status": "CHARGED", "error_code": null, "net_amount": 1001, "surcharge_amount": null, "tax_amount": null, "txn_amount": 1, "offer_deduction_amount": null, "gateway_id": 19, "currency": "INR", "metadata": { "microapp": "hyperpay", "payment_channel": "ANDROID" }, "express_checkout": false, "redirect": true, "txn_uuid": "mozijU1pZn3gbMxqGtz", "gateway": "PAYTM_V2", "error_message": "", "created": "2023-05-02T09:42:08Z", "txn_flow_type": "COLLECT" }, "payment_gateway_response": { "resp_code": "01", "rrn": "312220768996", "created": "2023-05-02T09:42:10Z", "epg_txn_id": "20230502011070000860175954952427523", "resp_message": "Txn Success", "auth_id_code": "", "txn_id": "picasso-hyperorder59350-1-1" }, "gateway_id": 19, "gateway_reference_id": "prodmode", "payer_vpa": "9620684748@ybl", "upi": { "payer_vpa": "9620684748@ybl", "txn_flow_type": "COLLECT" }, "offers": [], "status": "CHARGED" }, { "txn_id": "picasso-hyperorder59350-1-2", "payment_method_type": "CARD", "auth_type": "NO_THREE_DS", "card": { "expiry_year": "2049", "card_reference": "", "saved_to_locker": false, "expiry_month": "12", "name_on_card": "qwick_cilver_card", "card_issuer": "", "last_four_digits": "", "using_saved_card": false, "card_fingerprint": "", "card_isin": "199253", "card_type": "CREDIT", "card_brand": "QWIKCILVER", "using_token": false, "tokens": [], "card_issuer_country": "", "juspay_bank_code": "", "extended_card_type": "CREDIT", "payment_account_reference": "" }, "payment_method": "QWIKCILVER", "refunded": true, "amount_refunded": 500, "effective_amount": 500, "refunds": [ { "id": null, "amount": 100, "unique_request_id": "qc100", "ref": null, "created": "2023-05-17T10:51:26Z", "status": "SUCCESS", "error_message": "", "sent_to_gateway": true, "initiated_by": "API", "refund_source": "QWIKCILVER", "refund_type": "STANDARD", "pg_processed_at": "2023-05-17T10:51:27Z", "error_code": null } ], "resp_code": null, "resp_message": null, "bank_error_code": "", "bank_error_message": "", "txn_uuid": "moz438uNTR26aYk6QHF", "txn_detail": { "txn_id": "picasso-hyperorder59350-1-2", "order_id": "hyperorder59350", "status": "CHARGED", "error_code": null, "net_amount": 1001, "surcharge_amount": null, "tax_amount": null, "txn_amount": 500, "offer_deduction_amount": null, "gateway_id": 47, "currency": "INR", "express_checkout": false, "redirect": false, "txn_uuid": "moz438uNTR26aYk6QHF", "gateway": "QWIKCILVER", "error_message": "", "created": "2023-05-02T09:42:07Z", "txn_flow_type": "CARD_TRANSACTION" }, "payment_gateway_response": { "resp_code": "0", "rrn": null, "created": "2023-05-02T09:42:08Z", "epg_txn_id": "6365276", "resp_message": "Transaction successful.", "auth_id_code": null, "txn_id": "picasso-hyperorder59350-1-2" }, "gateway_id": 47, "gateway_reference_id": "snapdealquick", "offers": [], "status": "CHARGED" }, { "txn_id": "picasso-hyperorder59350-1-3", "payment_method_type": "CARD", "auth_type": "NO_THREE_DS", "card": { "expiry_year": "2049", "card_reference": "", "saved_to_locker": false, "expiry_month": "12", "name_on_card": "qwick_cilver_card", "card_issuer": "", "last_four_digits": "", "using_saved_card": false, "card_fingerprint": "", "card_isin": "199253", "card_type": "CREDIT", "card_brand": "QWIKCILVER", "using_token": false, "tokens": [], "card_issuer_country": "", "juspay_bank_code": "", "extended_card_type": "CREDIT", "payment_account_reference": "" }, "payment_method": "QWIKCILVER", "refunded": true, "amount_refunded": 500, "effective_amount": 500, "refunds": [ { "id": null, "amount": 500, "unique_request_id": "qc102", "ref": null, "created": "2023-05-17T11:13:48Z", "status": "SUCCESS", "error_message": "", "sent_to_gateway": true, "initiated_by": "API", "refund_source": "QWIKCILVER", "refund_type": "STANDARD", "pg_processed_at": "2023-05-17T11:13:49Z", "error_code": null } ], "resp_code": null, "resp_message": null, "bank_error_code": "", "bank_error_message": "", "txn_uuid": "mozcvfjFW8n3MkwsfK6", "txn_detail": { "txn_id": "picasso-hyperorder59350-1-3", "order_id": "hyperorder59350", "status": "CHARGED", "error_code": null, "net_amount": 1001, "surcharge_amount": null, "tax_amount": null, "txn_amount": 500, "offer_deduction_amount": null, "gateway_id": 47, "currency": "INR", "express_checkout": false, "redirect": false, "txn_uuid": "mozcvfjFW8n3MkwsfK6", "gateway": "QWIKCILVER", "error_message": "", "created": "2023-05-02T09:42:06Z", "txn_flow_type": "CARD_TRANSACTION" }, "payment_gateway_response": { "resp_code": "0", "rrn": null, "created": "2023-05-02T09:42:07Z", "epg_txn_id": "8432791", "resp_message": "Transaction successful.", "auth_id_code": null, "txn_id": "picasso-hyperorder59350-1-3" }, "gateway_id": 47, "gateway_reference_id": "snapdealquick", "offers": [], "status": "CHARGED" } ] } ``` ### **Refund Calls** 1. Refund requests (full/partial) can be initiated by a Juspay’s merchant at Transaction level. 2. Given that Qwikcilver transactions are always split between an existing Gateway and Qwikcilver Gift Cards. 3. For Transaction based refunds A. Merchant would initiate refunds against all transaction Ids, with transaction Id and amount to Juspay B. Merchant will ensure the amount checks and the refund split for both full and partial refunds. C. Juspay’s refund response will remain the same as what merchants currently see for transaction based refunds. No additional handling required. **Request** #### Shell Code Snippet: ```shell curl --location 'https://api.juspay.in/orders/txns//refunds' \ --header 'Accept: application/json' \ --header 'version: 2022-03-16' \ --header 'x-merchantid:' \ --header 'Authorization: Basic Auth' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'unique_request_id=req-1695671557' \ --data-urlencode 'amount=998' ``` **Response** #### Shell Code Snippet: ```shell { "card": { "card_issuer_country": "", "name_on_card": "qwick_cilver_card", "last_four_digits": "", "card_reference": "", "tokens": [], "card_issuer": "", "card_brand": "QWIKCILVER", "card_fingerprint": "", "extended_card_type": "CREDIT", "card_type": "CREDIT", "card_isin": "199253", "using_saved_card": false, "expiry_year": "2049", "using_token": false, "saved_to_locker": false, "expiry_month": "12" }, "order_id": "hyperorder77468", "udf3": "", "status": "CHARGED", "amount": 1, "auth_type": "NO_THREE_DS", "refunded": true, "udf8": "", "udf5": "", "payment_method": "QWIKCILVER", "gateway_id": 47, "refunds": [ { "status": "SUCCESS", "amount": 1.01, "sent_to_gateway": true, "unique_request_id": "qc0002", "error_code": null, "created": "2023-05-17T10:14:27Z", "pg_processed_at": "2023-05-17T10:14:28Z", "initiated_by": "API", "refund_source": "QWIKCILVER", "error_message": "", "id": null, "refund_type": "STANDARD", "ref": null } ], "udf2": "", "payment_method_type": "CARD", "txn_uuid": "moz5nv5Gzy3bZpxbpUn", "udf4": "", "customer_id": "9742144874", "udf10": "", "bank_pg": null, "payment_links": { "iframe": "https://sandbox.juspay.in/merchant/ipay/ordeh_9732dd9343004a41aef993893b196fbf", "web": "https://sandbox.juspay.in/merchant/pay/ordeh_9732dd9343004a41aef993893b196fbf", "mobile": "https://sandbox.juspay.in/merchant/pay/ordeh_9732dd9343004a41aef993893b196fbf?mobile=true" }, "effective_amount": 1.01, "udf1": "", "payment_gateway_response": { "auth_id_code": null, "created": "2023-04-26T11:10:55Z", "rrn": null, "epg_txn_id": null, "txn_id": "picasso-hyperorder77468-1", "resp_message": "Transaction successful.", "resp_code": "0" }, "product_id": "", "txn_detail": { "order_id": "hyperorder77468", "status": "CHARGED", "net_amount": 1, "error_code": "", "gateway_id": 47, "surcharge_amount": 0.01, "txn_uuid": "moz5nv5Gzy3bZpxbpUn", "gateway": "QWIKCILVER", "created": "2023-04-26T11:10:54Z", "tax_amount": 0, "txn_amount": 1.01, "error_message": "", "currency": "INR", "redirect": true, "metadata": { "microapp": "hyperpay", "payment_channel": "ANDROID" }, "express_checkout": false, "txn_id": "picasso-hyperorder77468-1", "txn_flow_type": "CARD_TRANSACTION" }, "amount_refunded": 1.01, "customer_email": "test@gmail.com", "currency": "INR", "customer_phone": "0000000000000", "bank_error_message": "", "id": "ordeh_9732dd9343004a41aef993893b196fbf", "txn_id": "picasso-hyperorder77468-1", "merchant_id": "picasso", "maximum_eligible_refund_amount": 0, "udf7": "", "date_created": "2023-04-26T11:10:54Z", "bank_error_code": "", "offers": [], "udf9": "", "gateway_reference_id": "test1223", "return_url": "https://sandbox.juspay.in/end", "status_id": 21, "udf6": "" } ``` ## 4. Testing Scenarios For the final step towards completing your Qwikcilver Integration, Kindly perform the below mentioned test cases | Test Scenario | Test Scenario Description | |---|---| | Transction with 1 Gift Card | Kindly perform Successful , Failure Transactions | | Transctions with 1 Gift Card + Card | Kindly test for all the scenarios of Each payment methods giving Success, Pending and Failure cases. | | Transactions with 1 Gift Card + UPI | Kindly test for all the scenarios of Each payment methods giving Success, Pending and Failure cases. | | Transactions with 1 Gift Card + NB | Kindly test for all the scenarios of Each payment methods giving Success, Pending and Failure cases. | | Transactions with 1 Gift Card + Saved Payment method | Kindly test for all the scenarios of Each payment methods giving Success, Pending and Failure cases. | | Add Multiple Gift cards (If use case exists) | Kindly perform Successful , Failure Transactions | **Note** : These test cases as part of Basic test cases, We request merchants to do extensive testing for all available payments methods available for your MID. ## 5. Limitations 1. Juspay is not supporting Offers on traditional instruments if Gift card is added 2. Refund is to be done at a txn level and not at an order level. If two txns are done for an order and full refund has to be executed, refund API (attached above) to be hit twice with TxnID for each. ## 6. FAQ’s ## FAQs: ### How do I Reconcile the orders of Qwikcilver ? In the Recon Report provided by Qwikcilver, Please find the steps : For Forward Transactions : Kindly relay on “NOTES“ field. You would get “{ValType~GCRDM|ReferenceNumber~MID-**JPOrderID** -1-2}“. OrderID would be Juspay OrderID that you would search on Dashboard For Refund Transactions: Kindly relay on the “**Invoice Number”** field. This would provide the Juspay OrderID. ### How do i check the SR of Qwikcilver Transactions ? Kindly login to your Juspay Dashboard. On your left you would see EC Analytics as a option. Under that dropdown, Click on Transactions Analytics. On that page, Click in “Show Filters“. In that from “Select Payment gateway” enter “QWIKCILVER”. Here you would get analytics for QWIKCILVER SR’s. ![Image](https://dth95m2xtyv8v.cloudfront.net/tesseract/assets/payment-method-integrations/Screenshot%202023-12-16%20at%206.01.00%20PM.png) *Analytics *