Reverse

POST /reverse

This endpoint allows you to return funds to the cardholder’s account, whether those funds were held as an authorization or fully captured as a transaction. With Reverse, merchants don’t need to worry about whether an authorization was captured — this endpoint intelligently manages both scenarios.

• If the funds were authorized but not captured: Reverse will release the authorization hold, freeing up the funds in the cardholder’s account.
• If the funds were captured: Reverse will initiate a refund, returning the captured amount to the cardholder’s account.

This simplifies cases such as order cancellations or refunds, allowing you to focus on the intent of returning the funds without needing to track the capture status.

Test URL

The reverse request will be made to the following URL:

https://checkout-api.staging.straumur.is/api/v1/modification/reverse

This call will create an reversal request for the intended authorization/transaction.

Request Example

{
  "reference": "9990QQAZ1221",
  "payfacReference": "5215125152151259990QQAZ1"
}

Request Body Fields

Field	Type	Required	Description	Example	Min Length	Max Length
reference	String	Required	Merchant reference to uniquely identify a payment.	9990QQAZ1221	1	100
payfacReference	String	Required	Straumur reference to uniquely identify a payment.	5215125152151259990QQAZ1	1	100

Example - Received Response

info

Status Received means that the system has acknowledged your request and will process it.

After completion, you will receive a final response through a webhook.

{
  "status": "Received",
  "payfacReference": "ASDAKOS125152",
  "responseDateTime": "2024-09-04T09:50:14.343503Z",
  "responseIdentifier": "e3605f81-6b09-4ce1-83ad-5a8d49f3cd44"
}

Error Response

Our error responses are standardised. Please see Errors.

You can also find a detailed overview of our HTTP Status Codes.