---
title: "Notify Fulfillment"
method: POST
path: "/payments/{payment_id}/fulfillments"
---

# Notify Fulfillment

`POST /payments/{payment_id}/fulfillments`

Notify fulfillment status and shipping details for a payment order.

## Request body

- object
  - `status` 'PARTIAL' | 'COMPLETED' | 'REPLACEMENT' | 'CANCELED', required — The status of the order fulfillment.
  - `fulfillments` object[], required — Fulfillments array
    - `id` string, required — The unique identifier of the fulfillment (MAX 255; MIN 3)
    - `type` 'CUSTOM' | 'MILITARY' | 'ELECTRONIC' | 'EXPRESS' | 'STANDARD' | 'SCHEDULED' | 'ECONOMY' | 'PRIORITY' | 'SAME_DAY' | 'NEXT_DAY' | 'THIRD_DAY' | 'STORE_PICK_UP' | 'LOCKER_PICK_UP' | 'OTHER', required — The type of the fulfillment
    - `status` 'PARTIAL' | 'COMPLETED' | 'REPLACEMENT' | 'CANCELED', required — The status of the fulfillment.
    - `description` string — The description of the fulfillment. (MAX 255; MIN 3)
    - `carriers` object[] — Carriers array
      - `id` string, required — The unique identifier of the carrier (MAX 255; MIN 3)
      - `tracking_id` string[], required — Tracking identifiers from the carrier (MAX 255; MIN 3 per item)
      - `tracking_url` string[], required — Tracking URLs from the carrier (MAX 999; MIN 1 per item)
      - `shipped_at` string, date — Shipping date (YYYY-MM-DD)
      - `delivered_at` string, date — Delivery date (YYYY-MM-DD)
  - `carriers` unknown

## Response `202`

Accepted

- object

## Other responses

- `400` — 400

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/revisions/05b629819b49/schema)