Checkout Status Request

GET /embeddedcheckout/status/{checkoutReference}

This call will return the current status of the embedded checkout session for the given checkoutReference.

Test URL

The status request on staging would be made to the following URL:

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

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"
}

Expired Response

{
  "status": "Expired",
  "payfacReference": null,
  "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 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. One session can produce several declined events — see One checkout, several Authorization events.