Capture a charge

United States
Canada

The Capture a charge endpoint retrieves details of an existing charge, previously created using the Create a charge endpoint. To return a charge, use the charge identifier (chargeId) from the create a charge request. ChargeId is also returned when a charge is first created or if it is refunded.

Request example

The following is a sample request when issuing a Capture a charge endpoint:

curl --request POST \
     --url https://scl-sandbox.dev.clover.com/v1/charges/chargeId/capture \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer ab86a5e8-48f3-b3bd-8c45-d415e9867833' \
     --header 'Content-Type: application/json'

Path parameters

The following table describes the path parameter to use when capturing a charge:

ObjectTypeVariableDescription
chargeIdstringPathRequired. Universally unique identifier (UUID) of the charge to be fetched.

Body parameters

The following table describes the body parameters to use when capturing a charge:

ObjectTypeVariableDescription
amountint64BodyCharge amount in the smallest monetary unit of the merchant's currency. If you do not specify an amount, the total of the original charge is captured.
receipt_emailstringBodyEmail address that receives the charge receipt.
level2objectBodyLevel 2 data for the purchase card transactions (US only). See Level 2 data.

Response example

The following is a sample response when running Capture a charge endpoint:

{
  "id": "6CK2MJSF87X2M",
  "amount": 10,
  "currency": "usd",
  "created": 1656626930000,
  "captured": false,
  "customer": "NAYQEY34V6H24",
  "ref_num": "218100500005",
  "auth_code": "OK0974",
  "order": "97C57CARRRFMM",
  "outcome": {
    "network_status": "approved_by_network",
    "type": "authorized"
  },
  "paid": true,
  "status": "succeeded",
  "source": {
    "id": "clv_1TSTSB95isdhZ94NizpP3w5b",
    "brand": "VISA",
    "first6": "400556",
    "last4": "2123"
  }
}

Responses

The following table describes the possible responses when running the Capture a charge endpoint:

MessageDescriptionVariableDescription
200stringReturns the charge object with any captured value set to true.
400 Bad RequeststringchargeReturns when a card-related error occurs. Indicates the unique ID of the failed charge.
400 Bad RequeststringcodeReturns additional information about the error that you can use to provide user-friendly handling of the issue.
400 Bad Requeststringdecline_codeReturns when a card issuer declined the transaction. Includes the reason for the decline if specified by the card issuer.
400 Bad Requeststringdoc_urlReturns a link for more information about the reported error code.
400 Bad RequeststringmessageProvides detailed information about the error code. For card-related errors, use this information to inform users.
400 Bad RequeststringparamIf the error is related to a specific parameter, this value lists the parameter. You can inform users of a particular issue in the entered card information.
400 Bad RequeststringtypeReturned error type:
- api_connection_error
- api_error
- authentication_error
- card_error
- idempotency_error
- invalid_request_error
- rate_limit_error