---
title: "Track incoming payment"
method: POST
path: "/incoming_payments/{id}/track"
tags: ["Incoming Payments"]
---

# Track incoming payment

`POST /incoming_payments/{id}/track`

Track Swift incoming payments with Swift GPI.

## Path parameters

- `id` string, required

## Request body

- IncomingPaymentTrackDetails
  - `status` 'rejected' | 'pending' | 'executed' | 'received', required — Swift GPI tracker status.
  - `status_code` 'G000' | 'G001' | 'G002' | 'G003' | 'G004' — Swift GPI tracker status details, only mandatory when the status is "pending" or "executed". Includes native GPI codes.
  - `rejection_reason_code` string — 4 alphanumerical characters Swift GPI rejection code, only mandatory when the status is “rejected”.

## Response `200`

Successfully processed. No content returned.

## Other responses

- `400` — Validation error.
- `404` — The specified resource was not found.
- `409` — Conflict.

---

[API](https://skmtc.net/numeral/apis/payments.md) · [All operations](https://skmtc.net/numeral/apis/payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/numeral/payments/revisions/220f101cc2ef/schema)