Charges

Retrieve charges created from charge intents. A charge is the settled record of a successful payment.

ENDPOINTS

GET/v1/charges/{id}GET/v1/charges/{id}/trace

export FRAME_API_KEY='sk_sandbox_...'

The Charge object

Attributes

idstring

Unique identifier for the charge

objectstring

Object type identifier. Always charge.

amountinteger

Amount charged in cents

currencystring

Three-letter ISO currency code

statusstring

Charge status. One of pending, succeeded, or failed.

livemodeboolean

true if live mode, false if test mode

createdinteger

Unix timestamp of creation

charge_intent_idnullable string

ID of the charge intent that created this charge

THE CHARGE OBJECT

{
  "id": "b72fce52-eb12-5704-91a4-e3da890fb648",
  "object": "charge",
  "amount": 2000,
  "currency": "usd",
  "status": "succeeded",
  "livemode": false,
  "created": 1721010605,
  "charge_intent_id": "a70cd72f-e74a-40f2-96a2-3f60714aac4a"
}

Get charge

Retrieve a charge by ID

Path parameters

idstringrequired

Charge ID

Returns

Successful response

GET/v1/charges/{id}

curl --request GET \
  --url https://api.framepayments.com/v1/charges/a70cd72f-e74a-40f2-96a2-3f60714aac4a \
  --header 'Authorization: Bearer API_KEY'

RESPONSE

{
  "id": "00000000-0000-4000-8000-000000000001",
  "currency": "usd",
  "failure_code": null,
  "failure_message": null,
  "failure_category": null,
  "description": null,
  "status": "succeeded",
  "acquirer_reference_number": null,
  "authorization_code": null,
  "object": "charge",
  "payment_method_details": {
    "id": "00000000-0000-4000-8000-000000000002",
    "customer_id": null,
    "account_id": null,
    "billing": {
      "id": "00000000-0000-4000-8000-000000000003",
      "city": "Tyronebury",
      "country": "US",
      "state": "CA",
      "postal_code": "70896",
      "line_1": "46131 Yundt Gateway",
      "line_2": "Suite 224",
      "livemode": false,
      "type": "billing"
    },
    "type": "card",
    "object": "payment_method",
    "created": 1745107200,
    "updated": 1745107200,
    "livemode": false,
    "status": "active",
    "card": {
      "brand": "visa",
      "exp_month": "04",
      "exp_year": "30",
      "issuer": null,
      "currency": null,
      "segment": null,
      "type": null,
      "last_four": "4242"
    }
  },
  "customer": "00000000-0000-4000-8000-000000000004",
  "account": null,
  "account_id": null,
  "payment_method": "00000000-0000-4000-8000-000000000002",
  "amount": 1000,
  "amount_captured": 0,
  "amount_refunded": 0,
  "created": 1745107200,
  "updated": 1745107200,
  "livemode": false,
  "captured": true,
  "disputed": false,
  "charge_intent": "00000000-0000-4000-8000-000000000005",
  "refunded": false,
  "net_amount": 926
}

Get charge trace

Retrieve a charge with ledger/trace information

Path parameters

idstringrequired

Charge ID

Returns

Charge with trace data

GET/v1/charges/{id}/trace

curl --request GET \
  --url https://api.framepayments.com/v1/charges/a70cd72f-e74a-40f2-96a2-3f60714aac4a/trace \
  --header 'Authorization: Bearer API_KEY'

RESPONSE

{
  "id": "00000000-0000-4000-8000-000000000001",
  "currency": "usd",
  "failure_code": null,
  "failure_message": null,
  "failure_category": null,
  "description": null,
  "status": "succeeded",
  "acquirer_reference_number": null,
  "authorization_code": null,
  "object": "charge",
  "payment_method_details": {
    "id": "00000000-0000-4000-8000-000000000002",
    "customer_id": null,
    "account_id": null,
    "billing": {
      "id": "00000000-0000-4000-8000-000000000003",
      "city": "Kandacebury",
      "country": "US",
      "state": "CA",
      "postal_code": "15820-5335",
      "line_1": "129 Kathleen Plain",
      "line_2": "Apt. 588",
      "livemode": false,
      "type": "billing"
    },
    "type": "card",
    "object": "payment_method",
    "created": 1745107200,
    "updated": 1745107200,
    "livemode": false,
    "status": "active",
    "card": {
      "brand": "visa",
      "exp_month": "05",
      "exp_year": "30",
      "issuer": null,
      "currency": null,
      "segment": null,
      "type": null,
      "last_four": "4242"
    }
  },
  "customer": "00000000-0000-4000-8000-000000000004",
  "account": null,
  "account_id": null,
  "payment_method": "00000000-0000-4000-8000-000000000002",
  "amount": 1000,
  "amount_captured": 0,
  "amount_refunded": 0,
  "created": 1745107200,
  "updated": 1745107200,
  "livemode": false,
  "captured": true,
  "disputed": false,
  "charge_intent": "00000000-0000-4000-8000-000000000005",
  "refunded": false,
  "net_amount": 926,
  "ledger": {
    "journals": []
  }
}