---
title: "Sync payin status"
method: PUT
path: "/payins/{id}"
tags: ["Payins"]
---

# Sync payin status

`PUT /payins/{id}`

Forces a status refresh by querying the payment provider. Useful for polling.

## Path parameters

- `id` integer, required

## Response `200`

Updated payin

- Payin
  - `id` integer
  - `self` string
  - `reference` string, nullable — Provider's payment reference ID.
  - `type` string — Payment method type (e.g. `CARD`, `BANKWIRE`, `WALLET`).
  - `subtype` string, nullable
  - `status` 'CREATED' | 'AUTHORIZED' | 'CONFIRMED' | 'DENIED' | 'REFUNDED' | 'CANCELLED'
  - `provider` object — Raw provider response data.
  - `tag` string, nullable
  - `direct_link` string, uri, nullable — Payment page URL. Only present when status is `CREATED` or `AUTHORIZED`.
  - `created_at` string, date-time, nullable
  - `confirmed_at` string, date-time, nullable
  - `denied_at` string, date-time, nullable
  - `connections` Connections — Hypermedia links to related resources.

---

[API](https://skmtc.dev/truust-io/apis/truust-api.md) · [All operations](https://skmtc.dev/truust-io/apis/truust-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/truust-io/truust-api/revisions/cc81e28726b9/schema)
