API Reference

Overview

We have added support for automatically redirecting to a custom callback URL after a successful payment. This feature allows merchants to define a specific URL the customer is to be redirected to once a payment is successfully completed.

How it Works

After a successful payment, the payment gateway will attempt to redirect to the provided callback URL with additional parameters appended to it.

  • id: Unique identifier for the transaction.
  • type: Type of the transaction.
  • status: Payment status (set to "success" upon successful payment).
  • payment_method: The payment method used (in this case, "bank_transfer").

If the callback URL is valid, the gateway will redirect to the provided URL with the additional parameters. If the URL is invalid or not provided, the user will be redirected to our default payment details page.

How to Use

To use callback URLs, make sure to pass your URL in a callback_url parameter to the payment link provided.

Example

Given the following URL structure:

https://centiiv.com/pay?id=123456&type=invoice&callback_url=https://merchantwebsite.com/payment-status

After a successful payment, the customer would be redirected to the following URL:

https://merchantwebsite.com/payment-status?id=123&type=purchase&status=success&payment_method=bank_transfer

Behavior

  1. If callback_url is valid: The user will be redirected to the provided URL with the transaction parameters appended.
  2. If callback_url is invalid: The user will be redirected to the default /details page.
  3. If no callback_url is provided: The user will be redirected to the default /details page.