--- title: E-Wallet Integration & Testing slug: en/e-wallet-integration-and-testing description: Information about integration and testing on the E-Wallet payment method with the NICEPAY system image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/bMKDZKVpOxSw9eYkw_2QD_microsoftteams-image.png icon: {"faIcon":"fa-solid fa-book"} docTags: createdAt: 2022-09-16T09:04:36.000Z --- NICEPAY E-Wallet system supports by E-Wallet system from several Partners, such as OVO, DANA, LinkAja, ShopeePay, and AstraPay. # Integration Steps and API Used *** 1. Perform API Order Registration integration. - SNAP: [Registration - API E-Wallet (Direct Debit) SNAP](docId\:U__7u4PnTx3_eSWeZ-94m). - Redirect: [E-Wallet - API Checkout](docId\:I-bxb4nSYySDFBi6zilZq). 2. Perform API Payment Charge integration. - Redirect: [Payment - API Checkout](docId\:o-4MmsbwXtZIb0ydniohw). 3. Receive NICEPAY callback and push notification. 4. Perform API Check Status integration. - SNAP: [Check Status Transaction - API E-Wallet (Direct Debit) SNAP](docId\:za7aN0HE8C3-2OiXvdlNa). - Redirect: [Status Inquiry - API Checkout](docId\:RhH7PmISd6IHN99yWVJHm). 5. Optional: perform API Cancel integration to cancel the transaction. - SNAP: [Refund Transaction - API E-Wallet (Direct Debit) SNAP](docId\:Y-cGH6ylEK9h3FgMdXuqZ). - Redirect : [Cancel - API Checkout](docId\:CmiiEW1Oy21QP7qDEcUl-). # Credential for E-Wallet Testing *** | **E-Wallet Name** | **Description** | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | DANA | Phone: 081227619520
Pin: 159753 | | ShopeePay | [APK Shopee](https://drive.google.com/file/d/1gGE2-7OpBWXoz_KF7Kl0IThWtnAaQjCe/view) \| [APK ShopeePay](https://drive.google.com/file/d/13cYsNzcmoJwe4fiLjnrmhAT0Uc94w81K/view)
Username: nicepaytest01
Password: NicepayTest01
ShopeePay PIN: 142536 | :::hint{type="info"} Merchants must whitelist the IP address of the device used for testing through the ShopeePay or Shopee application. Please contact the NICEPAY Integration Team for further information. ::: # E-Wallet Testing Guide *** | **E-Wallet Name** | **Test Step** | **Cancel Rule** | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | OVO | 1. Use real account and real phone number. 2. Payment confirmation through OVO application. 3. Collect information and proceed transaction and transaction success. 4. Expiry time (Default) = 55 seconds. | - Amount according to the bill on the same day => Void. - Amount according to the bill on the different day => Block. - Half from the payment amount => Block. | | DANA | 1. Use real account or dummy account. 2. Access account. 3. Input OTP. 4. Collect information and payment confirmation. 5. Transaction success. 6. Expiry time (Default) = 24 hour. | - Amount according to the bill \< 24 hour => Void. - Amount according to the bill > 24 hour => Online Refund. - Request > 30 days => Block. - Half from the payment amount => Online Refund. - Half from the payment amount if timeout => Manual Refund. - Can’t request on 00.00 – 01.00 (midnight). | | LinkAja | 1. Use real account. 2. Access account. 3. Input OTP. 4. Collect information. 5. Payment confirmation and transaction success. 6. Expiry time (Default) = 5 minutes. | - Amount according to the bill \< 30 days => Void. - Amount according to the bill > 30 days => Manual Refund. - Half from the payment amount => Manual Refund. - Checkout LinkAja transaction on web => 5 minutes. | | ShopeePay | 1. Use real account or dummy account. 2. Payment confirmation on Shopee application. 3. Input PIN. 4. Transaction success. 5. Expiry time (Default) = 5 minutes. | - Amount according to the bill on the same day / before 24.00 => Void. - Amount according to the bill on the different day but transaction under 365 days => Refund. - Amount according to the bill > 365 days => Manual Refund. - Half from the payment amount => Block Request. - Can’t request on 23.55 – 06.00. | | AstraPay | 1. Register phone number and connect to NICEPAY. 2. Use phone number connected to NICEPAY. 3. Access account. 4. Collect information and payment confirmation. 5. Transaction success. 6. Expiry time (Default) = 15 minutes. | Can’t get refund. | # Failed Transaction Possible Reason *** - Transaction got expiry time. - Network on Issuer side is not supported. - Reject by related Issuer/Mitra side. - User's phone number not registered on E-Wallet application. # Integration Checklist & Test Case *** - [ ] Implement Inquiry status after receiving the callback. - [ ] Implement Inquiry status after receiving the notification inside `dbProcessUrl`. - [ ] Review payment log. - [ ] Review firewall setting (eg. Cloudflare to setting `dbprocessUrl`). - [ ] Check `merchantToken` implementation. - [ ] Execute test scenarios in Development Environment. - [ ] Execute test scenarios in Production Environment. [Get Sample Scenario](https://docs.google.com/spreadsheets/d/e/2PACX-1vQIaIMCM0vZ3L1cA-JkW3YxyIpjsB966fg1wTeT8qpFDowEvulIEWOoY6I4uJPL3A/pub?output=xlsx) - [ ] Review Error Handling (Timeout, Failed, Negative Case). # Best Practice *** - When notification is received on your `dbProcessUrl`, NICEPAY strongly recommend Merchant to verify the notification by using the Inquiry API. - `cardData` information is mandatory to input. - On OVO, incoming notifications are through the push notification system on the cell phone application. - On ShopeePay, payment proceeds by jump-in method to the Shopee mobile application. - On LinkAja and DANA, incoming notification to the Partner page. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Visit the [E-Wallet Payment Flow](docId\:cMD9EfdSW7mpTWs1Elyfc) page to find out the system process during payment with the E-Wallet. ::: :::VerticalSplitItem Visit the [E-Wallet Feature](docId:3FbRKfzemKKV8jfYS65_9) page to find out the transaction features on the E-Wallet. ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Visit the [E-Wallet Glossary](docId:2i4DxwsBhM8TMMUeNJrNX) page to find out the particular term used on the E-Wallet. ::: :::VerticalSplitItem Visit the [E-Wallet FAQ](docId\:CUUbdeJXO-qJHIEa0TPhN) page if you want to find out frequently asked questions related to E-Wallet. ::: ::::