Get a charge

The Get 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) that was returned from the create a charge request. a 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 the Get a charge endpoint:

curl --request GET \
     --url https://scl-sandbox.dev.clover.com/v1/charges/6CK2MJSF87X2M \
     --header 'Accept: application/json'

Path parameter

The following table describes the path parameter to use with the Get a charge endpoint:

Query parameter

The following table describes the query parameter to use when using the Get a charge endpoint:

Response example

The following is a sample response when running Get 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 Get a charge endpoint: