Adjust

POST /adjust

This endpoint allows merchants to adjust the amount of an existing authorization. It’s commonly used in scenarios where an initial authorization was created but additional charges need to be included, such as when a cardholder adds items or services after the initial order.

info

You can only use this endpoint if your authorization hasn't been captured. If it has been, look into the Refund action.

Example Scenario: Hotel

Imagine a hotel scenario where a guest checks in and an initial authorization of 500 EUR is placed on their card to cover the room rate and incidentals. Later, the guest decides to enjoy a meal at the hotel’s bar. The bar tab comes to 75 EUR, and rather than creating a new authorization, the hotel decides to adjust the existing authorization to include this extra charge.

Test URL

The adjustment request will be made to the following URL:

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

This call will create an adjustment request for the intended authorization.

Request Example

{
  "reference": "9990QQAZ1221",
  "payfacReference": "5215125152151259990QQAZ1",
  "amount": 1000,
  "currency": "ISK"
}

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
amount	Integer	Required	The adjusted amount to be charged in minor units.	127300	-	-
currency	String	Required	The three-character ISO currency code.	ISK	3	3

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.