Change Notification

When there is a change or update in a payment or transaction from the Payment Service Provider (PSP), the Integrator must inform Frisbii+Transform of this update. The platform employs a webhook mechanism to handle such notifications as part of its third-party integration strategy.

📘

It is crucial for the Integrator to first process the payment notification from the PSP thoroughly before notifying Frisbii Transform. This ensures that the data sent to Frisbii Transform is accurate and reflects the latest state of the transaction.

The principal scheme of the notification flow is illustrated below.

Notification Flow

• Payment Notification from PSP: Once the PSP sends a notification about payment, the Integrator processes this notification by updating the stored data associated with the payment (Preauth, Payment, Refund).
• Sending Webhook to Frisbii Transform: After processing the notification, the Integrator sends a corresponding webhook to Frisbii Transform. This webhook includes:
  • Transaction Type: Specifies whether the transaction is a Preauth, Payment, or Refund.
  • Frisbii Transform Identifier: The unique identifier for the transaction, as stored by the Integrator.

Frisbii Transform's Role

• Fetching Transaction Data: Frisbii Transform uses the information from the webhook to fetch the updated transaction data from its endpoint.
• Comparison of Transaction State: This fetched data allows Frisbii Transform to compare the transaction state stored on its side, ensuring all records are up-to-date.

📘

Frisbii Transform relies on the Integrator to aggregate webhooks from the PSP. In scenarios where multiple changes occur simultaneously, the Integrator is expected to notify the platform only of the most recent change, ensuring that Frisbii Transform receives timely and accurate updates.

Webhook Types for Frisbii Transform

The following table provides a comprehensive overview of the webhook types used in Frisbii Transform. Each type corresponds to a specific event that triggers the webhook.

Example 1: Payment Notification Webhook

{
  "TransactionId": "tx123456",
  "Type": 2  // Corresponds to Payment
}

Example 2: Agreement Update Webhook

{
  "AgreementId": "tx123456",
  "Type": 4  // Corresponds to Agreement
}