> For the complete Lynkow documentation index in agent-friendly format, see [llms.txt](/llms.txt).

# Refresh a storefront payment

**Publié le** : 2026-08-19
**Catégorie** : Commerce

## `POST /payments/:id/refresh`

**Refresh a storefront payment**

Reconciles one tenant-scoped booking deposit from the absolute payment state and
returns only its payment and booking statuses. The route requires a storefront
publishable key and the live `payments` feature; optional customer authentication is
resolved before the controller. The caller must be the booking's authenticated customer
or present the signed, unexpired payment capability minted with checkout in the
`X-Lynkow-Payment-Capability` header. Missing, malformed, foreign, and unauthorized ids
all return the same forbidden response, and a bare payment id never authorizes this read.

> **Note:** This endpoint requires the e-commerce feature to be enabled on your site.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | Yes | Unique identifier |


### Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |
| `401` | Missing or invalid storefront publishable key |
| `402` | The site subscription does not currently permit this operation |
| `403` | The storefront key origin is not allowed |
| `404` | Not found |
| `422` | Validation error |


---