Update a Payment - legacy


This is a legacy endpoint.

Send a PATCH to update a Payment.


To keep your app secure, requests to update a Payment should only be generated on the server-side.

A POST request to /payments/{payment_ref}/ updates an existing Payment. On success, the API responds with the Payment.

The status property of the Payment determines what data can be updated. If the status is processing, cancelled, or succeeded, then only the following Payment fields can be modified:

  • metadata
  • external_order_id

Forage ignores attempts to update other fields.

In the case of a failed status, this endpoint can be used to set an updated payment_method and then reattempt the charge.