---
title: "Capture a charge"
method: POST
path: "/charges/{chargeId}/capture"
---

# Capture a charge

`POST /charges/{chargeId}/capture`

Sandbox (Testing): https://global-api.sand.au.edge.zip.co/merchant/charges/{chargeId}/capture

Once a Charge has been Authorized it must then be Captured for disbursement to the merchant. This is done by simply referring to the Authorized "charge_id" in the endpoint url and passing the amount to be captured.

## Headers

- `Authorization` string, required
- `Idempotency-Key` string, required
- `Zip-Version` string, required

## Request body

- object
  - `amount` integer, required — Order shipping address object.
  - `reference` string — Unique transaction reference.
  - `is_partial_capture` boolean — Specifies whether the capture request is partial or not. If true and the capture amount is less than the authorized amount then the outstanding balance will remain authorised for capture at a later stage. If false and the capture amount is less than the authorized amount then the outstanding balance will be released back to the customer and the charges will be finalised, future captures will not be allowed. Default value is false if attribute is not specified in the request..

## Response `200`

200

- object
  - `amount` integer
  - `captured_amount` integer
  - `created_date` string
  - `currency` string
  - `id` string
  - `product` string
  - `receipt_number` integer
  - `refunded_amount` integer
  - `state` string
  - `customer` object
    - `first_name` string
    - `last_name` string
    - `email` string

---

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