--- page_source: https://juspay.io/in/docs/payment-method-integrations/express-checkout-sdk/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. Check Gift Card Balance Merchants would need to call check balance for the particular gift card and based on the check with the order amount can have 2 flows as explained below. ### Step 1.1. Only Gift Card User lands on your 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. Merchants needs to call the necessary payload for the Transactions. Attaching Sample Flow from Juspay Hosted Payment Page. ![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. Merchants will call the action with primary payment method with additional details block (that will contain the gift card details). 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. Attaching sample flow from Juspay Hosted Payment Page. ![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** ### **Check Gift Card Balance Payload** ### Step 1.1a Gift Card Balance SDK Request and Response Kindly use the drop down to check the SDK request and response for check balance call #### Check Balance Request Code Snippet: ```check balance request { "requestId": "8410b0e0-31fe-41e6-be18-35fff100c9fb", "service": "in.juspay.hyperapi", "payload": { "action": "giftCardValidate", "orderId": "QC150", "merchantKeyId": "", "merchantId": "", "gatewayReferenceId": "", "gatewayId": "id", "customerId": "9742144874", "clientAuthToken":"", "cardType": "QWIKCILVER", "cardToken": "", "cardSecurityCode": "" } } ``` #### Check Balance Response Code Snippet: ```check balance response { "payload": { "service": "in.juspay.hyperapi", "requestId": "8410b0e0-31fe-41e6-be18-35fff100c9fb", "payload": { "action": "giftCardValidate", "isEligible": true, "cardToken": "", "balance": 998.88 }, "errorMessage": "", "errorCode": "", "error": false }, "event": "process_result" } ``` ### **Transaction Payloads** ### Step 1.1. Substep Please find the payloads for the SDK flows. Kindly use the below drop down for the payloads. 1. Only Gift Cards 2. Split Transactions 1. In case of Split Transaction, You would need to call action with the Primary Payment methods such as upiTxn, nbTxn , cardTxn along with **additionalPaymentDetails** block. 2. Attaching Sample of UPI + Gift cards Payload. 3. Adding the Sample **additionalPaymentDetails** block as well. (In case you want to add 2 cards) #### Gift Card Txns Request Code Snippet: ```gift card txns request { "requestId": "dc802a49-694c-4911-b806-450ae5bc2dcb", "service": "in.juspay.hyperapi", "payload": { "action": "giftCardPayment", "orderId": "QCTEST01", "paymentMethod": "QWIKCILVER", "merchantKeyId": "", "cardToken": "", "cardSecurityCode": "", "redirectAfterPayment": true, "endUrls": ["https://sandbox.juspay.in/end"], "paymentMethodType": "CARD", "merchantId": "", "format": "json" } } ``` #### Gift Card Txns Response Code Snippet: ```gift card txns response { "error": false, "errorCode": "", "errorMessage": "", "payload": { "action": "giftCardTxn", "orderId": "52062892675", "status": "CHARGED" }, "requestId": "27f5e71e-0685-4579-86b1-f7f132798e5e", "service": "in.juspay.hyperapi" } ``` #### Gift card + UPI Txns Request Code Snippet: ```gift card + upi txns request { "requestId": "73b8b2c7-0311-4127-b63a-db3a7ae33e5a", "service": "in.juspay.hyperapi", "payload": { "action": "upiTxn", "orderId": "QC81", "custVpa": "9620684748@ybl", "upiSdkPresent": false, "endUrls": [ "https://sandbox.juspay.in/end" ], "additionalPaymentDetails": [ { "payment_method_type": "CARD", "payment_method": "QWIKCILVER", "card_token": "", "card_security_code": "" } ], "displayNote": "UPI Collect" } } ``` #### Gift card + UPI Txns Response Code Snippet: ```gift card + upi txns response { "error": false, "errorCode": "", "errorMessage": "", "payload": { "action": "upiTxn", "merchantId": "JPTEST", "orderId": "52062320993", "status": "CHARGED", "statusId": 21, "txnList": [ { "paymentMethod": "UPI", "paymentMethodType": "UPI", "txnAmount": 168, "txnId": "JPTEST-52062320993-1-1", "txnStatus": "CHARGED", "txnUuid": "mozx2mG5N7yqPnBvDRt" }, { "paymentMethod": "QWIKCILVER", "paymentMethodType": "CARD", "txnAmount": 201, "txnId": "JPTEST-52062320993-1-2", "txnStatus": "CHARGED", "txnUuid": "mozgZLmutAi3zsmNctq" } ] }, "requestId": "b9050437-5707-4ca2-8cd0-c8a6609f7b8c", "service": "in.juspay.hyperapi" } ``` #### Only Additional Payment Details Block Code Snippet: ```only additional payment details block "additionalPaymentDetails": [{ "payment_method_type": "CARD", "payment_method": "QWIKCILVER", "card_token": "", "card_security_code": "" } ], ``` ### **Order Status Handling Changes** 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. ### 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 *