---
title: "Process headless application"
method: POST
path: "/api/checkout/v1/headless-application/process/"
tags: ["api"]
---

# Process headless application

`POST /api/checkout/v1/headless-application/process/`

**Headless checkouts only.** This is a non-standard endpoint for headless integrations where the merchant drives the application flow server-to-server. In a typical hosted checkout this is handled by the checkout app and this endpoint must not be used.

Validates the supplied contract and accepts it for headless processing.

## Request body

- HeadlessApplicationProcessRequest
  - `external_contract_uuid` string, uuid, required — The external contract UUID of the application to process

## Response `200`

- HeadlessApplicationProcessResponse
  - `success` boolean, required — Whether the application was accepted for processing
  - `message` string, required — Status message describing the result
  - `external_contract_uuid` string, uuid, required — The external contract UUID that was processed

## Other responses

- `400`
- `404`

---

[API](https://skmtc.net/heylight/apis/heidipay-checkout-api.md) · [All operations](https://skmtc.net/heylight/apis/heidipay-checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heylight/heidipay-checkout-api/versions/c51570cfc888/schema)