---
title: "FE-return payment confirmation poll (BYO rent, pay-first)"
method: POST
path: "/numbers/esims/{id}/confirm-payment"
tags: ["Esims"]
---

# FE-return payment confirmation poll (BYO rent, pay-first)

`POST /numbers/esims/{id}/confirm-payment`

Checks for proof of payment for this eSIM's current rent and confirms it if found. If no proof is available yet, returns 200 with the eSIM unchanged rather than an error. Always returns the current eSIM state.

## Path parameters

- `id` string, uuid, required

## Response `200`

Current eSIM state (payment confirmed if proof was found, unchanged otherwise)

- object
  - `data` PublicEsim, required
    - `id` string, uuid, required
    - `status` 'in_stock' | 'owned' | 'installing' | 'installed' | 'install_failed' | 'retired', required
    - `source` 'stocked' | 'byo', required
    - `carrierName` string, nullable, required
    - `countryCode` string, nullable, required
    - `iccid` string, nullable, required
    - `subscriptionId` integer, nullable, required
    - `deviceId` string, uuid, nullable, required
    - `deviceUuid` string, nullable, required
    - `msisdn` string, nullable, required
    - `name` string, nullable, required
    - `createdBy` string, nullable, required
    - `networkStatus` 'degraded' | 'null', nullable, required
    - `rentStatus` 'not_applicable' | 'exempt' | 'inactive' | 'awaiting_payment' | 'active' | 'cancel_pending' | 'refund_pending' | 'retiring' | 'billing_error'
    - `checkoutUrl` string, nullable
    - `currentPeriodEnd` string, date-time, nullable
    - `cancellationScheduled` boolean
    - `exempt` boolean
    - `createdAt` string, date-time, nullable, required
    - `updatedAt` string, date-time, nullable, required

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable — esims are disabled for this deployment (see `reason`)

## Changes

- **2026-08-13** `02da4f9ce3fd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/numbers/esims/:id/confirm-payment/post.md)

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) · [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/droidrun/droidrun-cloud/revisions/a1453ac769d4/schema)