Skip to main content

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.

Live environment

On live, use the same path on https://greidslugatt.straumur.is. Headers, request and response are identical. See Live environment.

Request Example​

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

Request Body Fields​

FieldTypeRequiredDescriptionExampleMin LengthMax Length
referenceStringRequiredMerchant reference to uniquely identify a payment.9990QQAZ1221-200
payfacReferenceStringRequiredStraumur reference to uniquely identify a payment.5215125152151259990QQAZ1-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.

The payfacReference in this response identifies the reversal itself, not the original authorization. The outcome arrives as a Refund event — there is no separate event type for a reversal, carrying the same value as payfacReference and the authorization's reference as originalPayfacReference. See Reference fields.

{
  "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.