Charges

Charge a saved card with a one-off amount. If the charge succeeds Ching issues a receipt or tax invoice through the connected business identity automatically.

Use cases: Run a one-time payment, bill a custom amount after a setup session, or retry a failed subscription renewal from your own logic.

POST/v1/charges

Create and confirm a charge in a single request. In test mode the charge always succeeds; in live mode Ching routes the attempt to Grow.

Successful charges trigger a charge.succeeded webhook and, when the project is wired to Glance, automatically issue a tax invoice receipt.

Body Parameters

Name	Type		Description
`customer`	string	required	The customer id being charged.
`payment_method`	string	required	The active payment method id to charge. Must belong to the customer.
`amount`	number	required	Amount in the smallest currency unit (e.g. agorot for ILS). Must be a positive integer.
`currency`	string		ISO 4217 currency code. Defaults to "ils".
`description`	string		Description stored on the charge and shown on the receipt.
`installments`	object		Installment plan for Israeli credit-card networks. Send { count: N } to split the charge over N monthly installments.
`count`	number		Number of installments. Defaults to 1.
`metadata`	object		Set of key-value pairs you can attach to the object for your own use. Returned as-is on retrieval.

Request

curl -X POST "https://api.ching.co.il/v1/charges" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "customer": "example_customer",
  "payment_method": "example_payment_method",
  "amount": 0,
  "currency": "example_currency",
  "description": "example_description",
  "installments": {},
  "metadata": {}
}'

Response

{
  "success": true,
  "data": {
    "id": "ch_9mTPfRSDmEOU",
    "object": "charge",
    "customer": "cus_V8ltq1pK_MWH",
    "payment_method": "pm_WMc9X22NT1af",
    "amount": 9900,
    "currency": "ils",
    "status": "succeeded",
    "description": "Pro plan - April",
    "installments": {
      "count": 1
    },
    "captured": true,
    "refunded_amount": 0,
    "failure_code": null,
    "failure_message": null,
    "document": "doc_R0i70cuPK_yO",
    "metadata": {},
    "livemode": false,
    "created": "2026-04-19T09:15:22.000Z"
  }
}

GET/v1/charges

List the 100 most recent charges, newest first.

Request

curl -X GET "https://api.ching.co.il/v1/charges" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "success": true,
  "data": [
    {
      "id": "ch_9mTPfRSDmEOU",
      "object": "charge",
      "customer": "cus_V8ltq1pK_MWH",
      "payment_method": "pm_WMc9X22NT1af",
      "amount": 9900,
      "currency": "ils",
      "status": "succeeded",
      "description": "Pro plan - April",
      "installments": {
        "count": 1
      },
      "captured": true,
      "refunded_amount": 0,
      "failure_code": null,
      "failure_message": null,
      "document": "doc_R0i70cuPK_yO",
      "metadata": {},
      "livemode": false,
      "created": "2026-04-19T09:15:22.000Z",
      "customer_name": "Tal Levi"
    }
  ]
}

GET/v1/charges/:id

Retrieve a charge by its id.

Path Parameters

Name	Type		Description
`id`	string	required	The charge id (e.g. ch_9mTPfRSDmEOU).

Request

curl -X GET "https://api.ching.co.il/v1/charges/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "success": true,
  "data": {
    "id": "ch_9mTPfRSDmEOU",
    "object": "charge",
    "customer": "cus_V8ltq1pK_MWH",
    "payment_method": "pm_WMc9X22NT1af",
    "amount": 9900,
    "currency": "ils",
    "status": "succeeded",
    "description": "Pro plan - April",
    "installments": {
      "count": 1
    },
    "captured": true,
    "refunded_amount": 0,
    "failure_code": null,
    "failure_message": null,
    "document": "doc_R0i70cuPK_yO",
    "metadata": {},
    "livemode": false,
    "created": "2026-04-19T09:15:22.000Z"
  }
}