Digital Payments - Approval URL change

🚧

Expected Release Date:

  • Sandbox: July 15, 2025
  • Production: July 22, 2025

Summary

Gr4vy will no longer return the approval_url for transactions and payment methods that no longer require approval.

Background

Currently, any transaction (or payment method) that requires some form of approval will return an approval_url, as well as a status of buyer_approval_pending.
The approval URL is of no use after the transaction or payment method has been approved, yet until now the approval URL was still returned even after the approval had happened. Some PSPs handle replays of this URL gracefully, but not all do. Similarly, as the Gr4vy platform evolves, we have identified reasons for the approval URL to no longer be returned from our API.

Changes

With this change, the approval_url for transactions and payment methods will now only be returned if approval is still required. Once approval is no longer required, the approval_url will be set to null.
In short, this means that the approval_url will only be returned for a regular redirect transaction in a buyer_approval_pending state, push payment transactions in a processing state, and a payment_method in a buyer_approval_pending state.
Once the approval has completed, or the resource has been marked as declined or failed, the approval URL will be set to null.