OWNED Sub Account

Webhook URL update for OWNED Sub Account cannot be facilitated due to the lack of “Developers” permission.

Webhook URL of OWNED sub account would always follow webhook URL of Master Account.

MANAGED Sub Account

via Dashboard

1. Login to your Sub Account Dashboard;
2. Go to menu Settings > Developers > Webhook;
3. Click Webhook;
4. Edit the webhook URL to the desired products 
5. Click “Save and test”

via API

Follow the tutorial on this link:
https://developers.xendit.co/api-reference/#set-webhook-urls

1. The endpoint that will be used is as follows:

   POST https://api.xendit.co/callback_urls/:type

2. Make sure that you have inputted the correct Master Account’s API Key on the right place;
3. Input one of the webhook type on the ":type" endpoint path parameters that is listed below;
   • Money-In
     • Old APIs
       • invoice: Notification when Invoice has been paid or expired;
       • recurring: Xendit notifies your system when Subscription plan has been activated/inactivated, cycle created/succeeded/retrying/failed, or force attempt failed.
       • payment_method_v2: Notification when payment method V2 is expiring and/or has activated or expired;
       • payment_method: Notification when payment method is expiring and/or has expired;
         • Payment Method is a mandatory step to abstract Debit Card / Bank Account for Direct Debit transactions;
       • direct_debit: Notification for any Direct Debit successful payment event;
       • ewallet: New eWallet type to receive charge and other eWallet events across eWallets channels from /ewallets/charges API;
       • qr_code: Xendit notifies your system when QR payment has been made or QR refund has been completed. 
       • fva_status: Notification when Virtual Account in Indonesia has been created or updated successfully;
       • fva_paid: Notification when Virtual Account in Indonesia has been paid successfully;
       • ro_fpc_paid: Notification when Retail Outlet payment code (Alfamart/Indomaret) in Indonesia has been paid successfully;
       • regional_ro_paid: Notification when Over-the-Counter payment code (7 Eleven, Cebuana, ECPay) in Philippines has been paid successfully.
     • New Payment APIs:
       • payment_succeeded: Notification when a payment has been successfully confirmed or received from the partner channel 
       • payment_awaiting_capture: Notification when a payment request with capture_method set to MANUAL has been intialized 
       • payment_pending: Notification when a payment is being processed by the partner channel awaiting for the terminal status of it 
       • payment_failed: Notification when a pending payment has failed 
       • capture_succeeded: Notification when a manual capture via the Payment Capture API has succeeded. 
       • capture_failed: Notification when a manual capture via the Payment Capture API has Failed. 
       • payment_request_completed: Notification when a Direct Debit or E-Wallet payment request has succeeded or failed.
         • Make sure that other payment callbacks for Direct Debit or E-wallet are not set to prevent duplication.
         • Support: Thailand 🇹🇭 and Malaysia 🇲🇾 only

   • Money-Out

     • batch_disbursement: Notification when Batch Disbursement on Indonesian accounts have been executed successfully by Xendit.
     • disbursement: Notification when disbursement on Indonesian account has been executed successfully, either withCOMPLETEDorFAILEDstatus;
     • ph_disbursement: Notification when disbursement on the Philippines account has been executed successfully, either withCOMPLETEDorFAILEDstatus;
     • payout: Notification upon failed and successful payouts.
       • Learn more about Payouts V2 webhooks here.
   • Others
     • report: Notification to send the report to the specified URLs. 
4. Input the Business ID of your MANAGED Sub Account in the header under the parameter "for-user-id";
   
5. Input the desired webhook URL for your sub account on the request body under parameter "url";
6. Click "Send";
7. If the webhook URL is successfully updated, parameter status on API response will return “SUCCESSFUL”.