Xendit Integration (Old Documentation)

Here's how to integrate with Xendit Payment Gateway:

1. Open the Qiscus Shop Dashboard.

2. Click on 'Payment Gateway' under the Payment menu group.

3. Click 'Add Payment Gateway'.

4. Enter the following details:

   1. Account Name.

   2. Account Descriptions

   3. Choose the Service Charge Type: (1) percentage or (2) fixed. If you don't want to charge a service fee to the customer, you can leave this section empty.

5. Select 'Payment Gateway Service: Xendit' The detailed information required can be obtained from the Xendit Dashboard under the 'Settings' > 'API Keys'. which includes:

   1. Generate a secret key with the configuration: set "Money In" to "Write" and "Others" to "None.", copy the generated key and paste it into the available field in the Xendit account settings

   2. Public Key

   3. Test Mode -> Enable Test Mode

   4. Payment Channels, including

      1. Virtual account (e.g., BCA Virtual Account, BNI Virtual Account, BSI Virtual Account, BRI Virtual Account, Mandiri Virtual Account, Permata Virtual Account, BNC Virtual Account, BSS Virtual Account, BJB Virtual Account, CIMB Virtual Account).

      2. Merchants (e.g., Alfamart, Indomaret).

      3. E-Wallets (e.g., OVO, Dana, Shopee Pay, LinkAja, AstraPay).

      4. PayLaters (e.g., Kredivo, Akulaku, Atome, Uangme).

      5. Credit Cards.

      6. Qris

      7. Debit (e.g., BRI)

6. Then, click Save.

Setting Up Xendit Webhook for Automatic Order Status Updates

After successfully saving your Xendit account configuration in the Qiscus Shop Dashboard, follow these steps to enable automatic order status updates when a payment is completed: **

1. Log in to your Xendit Dashboard: Go to https://dashboard.xendit.com and sign in to your account.

2. Navigate to the Webhook Settings:

• Click on the Settings menu.

• Go to Webhook.

• Scroll to the Invoice Paid section.

3. Enter the following URL in the "Invoice Paid" field: https://shop.qiscus.com/webhooks/notifications/xendit

4. Enable the following option:

   1. **Also notify my application when an invoice has expired** Enable this option to automatically receive notifications when an invoice has passed its payment expiry date. This notification allows your system to immediately update the order status to expired.

   2. **Also notify my application when a payment has been received after expiry** Enable this option to receive notifications when a payment is made after the invoice expiry. This feature helps your system update the order status more accurately in cases where payment is processed after the expiry date, but the notification is received later.

5. Click Test and Save to apply the changes. Once completed, Xendit will automatically notify your Qiscus Shop system whenever a payment is successfully made.