Checkout Status Request

GET /hostedcheckout/status/{checkoutReference}

This call will return the current status of the hosted checkout session for the given checkout reference.

Test URL

The status request will be made to the following URL:

https://checkout-api.staging.straumur.is/api/v1/hostedcheckout/status/{checkoutReference}

An example Url for checkoutReference: faf984ad76db7b2dea3f7bab:

• https://checkout-api.staging.straumur.is/api/v1/hostedcheckout/status/faf984ad76db7b2dea3f7bab

Live environment

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

New Response

{
  "status": "New",
  "payfacReference": null,
  "responseDateTime": "2024-09-04T10:35:18.343503Z",
  "responseIdentifier": "e4ce3367-4d2b-4398-ad4e-06bcee650104"
}

Completed Response

{
  "status": "Completed",
  "payfacReference": "ASDAKOS125152",
  "responseDateTime": "2024-09-04T10:35:18.343503Z",
  "responseIdentifier": "e4ce3367-4d2b-4398-ad4e-06bcee650104"
}

Status Codes

Status	Explanation
New	The session is available for consumption.
Completed	The session is completed. Payment has been successfully made.
Expired	The session has expired. No payment has been made.

Declined attempts

There is no distinct status for a declined payment attempt. A decline leaves the session New — the shopper can try again with a different card until they succeed (Completed) or the session times out (Expired). To detect and react to a decline, use the Authorization webhook event (success: "false") rather than polling this endpoint.