This guide provides an overview of how partners can integrate with the BNPL (Buy Now, Pay Later) system to receive real-time notifications about key events in the BNPL process. Notifications are delivered via redirection URLs and webhooks, ensuring that partner systems are informed whenever relevant actions occur.

Introduction

The BNPL system allows seamless communication with partner platforms by:

  1. Redirecting users back to the partner website with event information via a redirection_url.
  2. Sending asynchronous notifications to the partner’s webhook_url in JSON format with the same event details.

Partners must implement both the redirection and webhook endpoints to fully integrate with the BNPL system.

Event Types

The BNPL system supports the following event types:

Event Type Description Notification Type
client_under_review After the user submits business information. Redirection & Webhook
purchase_placed After the user completes the purchase request information and chose the tenures Redirection & Webhook
purchase_approved When the purchase is approved. Webhook Only
purchase_declined When the purchase is declined. Webhook Only

Redirection URL

The redirection URL is used to redirect users back to the partner’s website after specific events (client_under_review and purchase_placed). The URL will include query parameters with event details.

How It Works

  1. Once an event occurs, the BNPL system generates a redirection_url with query parameters.
  2. Users are redirected to the specified URL.
  3. Partners extract the query parameters to update their system or display relevant information to the user.

Query Parameters

The redirection URL includes the following query parameters: