Skip to main content

Final status redirect

This document describes redirects after final statuses. Guardarian can return customers to a URL provided by the partner in several cases.

Separate URLs for:

  1. Finished transaction
  2. Cancelled transaction
  3. Failed transaction

How it works​

When creating a transaction through the API, the partner can pass three links for different transaction results:

Finished

Only for finished transactions.

Cancelled

If the customer cancelled the transaction.

Failed

For failed transactions, expired transactions, or refunded transactions.

{
  "redirects": {
    "successful": "https://guardarian.com/successful",
    "cancelled": "https://guardarian.com/cancelled",
    "failed": "https://guardarian.com/failed"
  }
}

All fields are optional. Partners can provide any combination of them, all at once, or none of them.

Three seconds after the transaction reaches a final status, the customer is redirected to the corresponding page.

Dedicated transaction pages​

Once a partner has dedicated pages for each transaction using the Guardarian transaction ID, $$ symbols can be added and replaced with the transaction ID. Example usage:

{
  "redirects": {
    "successful": "https://payments.guardarian.com/checkout?tid=$$",
    "cancelled": "https://payments.guardarian.com/checkout?tid=$$",
    "failed": "https://payments.guardarian.com/checkout?tid=$$"
  }
}