---
title: "Request payment after a service order is fulfilled"
method: POST
path: "/service-orders/{serviceOrderId}/request-payment"
tags: ["service-orders"]
---

# Request payment after a service order is fulfilled

`POST /service-orders/{serviceOrderId}/request-payment`

## Path parameters

- `serviceOrderId` string, uuid, required

## Headers

- `Content-Type` string, required
- `X-Extend-Access-Token` string, required
- `Accept` string, required

## Request body

- object
  - `expenses` union[]
    - union
      - object
        - `cost` object, required — Cost for single item. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
          - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
          - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
          - `formattedAmount` string
        - `quantity` number
        - `description` string, required
        - `status` 'created' | 'approved' | 'void', required — expense status
        - `createdBy` string
        - `totalCost` number — Total cost for all items. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
        - `metaData` object, required
          - `productName` string, required
        - `goodwillMetaData` object
          - `type` 'lol_service_overage' | 'customer_gesture', required
          - `description` string, required
          - `amount` object, required
            - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
            - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
            - `formattedAmount` string
        - `incurredBy` 'extend' | 'servicer' | 'manufacturer'
        - `type` 'replacement' | 'refurbished_replacement', required
      - object
        - `cost` object, required — Cost for single item. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
          - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
          - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
          - `formattedAmount` string
        - `quantity` number
        - `description` string, required
        - `status` 'created' | 'approved' | 'void', required
        - `createdBy` string
        - `goodwillMetaData` object
          - `type` 'lol_service_overage' | 'customer_gesture', required
          - `description` string, required
          - `amount` object, required
            - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
            - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
            - `formattedAmount` string
        - `totalCost` number — Total cost for all items. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
        - `incurredBy` 'extend' | 'servicer' | 'manufacturer'
        - `metaData` object, required
          - `partNumber` string, required
        - `type` 'parts', required
      - object
        - `cost` object, required — Cost for single item. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
          - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
          - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
          - `formattedAmount` string
        - `quantity` number
        - `description` string, required
        - `status` 'created' | 'approved' | 'void', required
        - `incurredBy` 'extend' | 'servicer' | 'manufacturer'
        - `createdBy` string
        - `goodwillMetaData` object
          - `type` 'lol_service_overage' | 'customer_gesture', required
          - `description` string, required
          - `amount` object, required
            - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
            - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
            - `formattedAmount` string
        - `totalCost` number — Total cost for all items. Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
        - `type` 'store_credit' | 'labor' | 'shipping' | 'taxes' | 'diagnosis_fee' | 'battery', required
  - `incurredBy` 'extend' | 'servicer' | 'manufacturer'

## Response `200`

Returns service order id

- object
  - `serviceOrderId` string, required

## Other responses

- `403` — Forbidden
- `404` — The specified resource was not found
- `409` — Conflict
- `500` — Internal server error

---

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