---
title: "Send SMS OTP"
method: POST
path: "/api/checkout/v1/otp/send/"
tags: ["api"]
---

# Send SMS OTP

`POST /api/checkout/v1/otp/send/`

**Headless checkouts only.** This is a non-standard endpoint for headless integrations where the merchant drives phone verification server-to-server. In a typical hosted checkout the customer completes phone verification themselves and this endpoint must not be used.

Triggers an SMS one-time password to the customer's phone number on record for the given contract.

## Request body

- OtpSendRequest
  - `external_contract_uuid` string, uuid, required — The external contract UUID of the application to send the OTP for

## Response `200`

- OtpSendResponse
  - `success` boolean, required — Whether the OTP was sent
  - `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`
- `429`

---

[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)