The Charges API lets you create and manage payments. All endpoints are relative to
https://api.example.com/v1.
Get /charges List charges
Query parameters
| Name | Type | Description |
|---|---|---|
| limit | integer | A limit on objects returned, 1–100. Default 10. |
| starting_after | string | A cursor for pagination. |
Response
{
"object": "list",
"data": [{ "id": "ch_1N…", "amount": 1200, "currency": "usd" }],
"has_more": false
}
Post /charges Create a charge
Body parameters
| Name | Type | Description |
|---|---|---|
| amount required | integer | Amount in the smallest currency unit. |
| currency required | string | Three-letter ISO currency code. |
| source | string | A payment source to charge. |
Request
curl https://api.example.com/v1/charges \
-H "Authorization: Bearer sk_live_…" \
-d amount=1200 -d currency=usd
Delete /charges/:id Delete a charge
Path parameters
| Name | Type | Description |
|---|---|---|
| id required | string | The identifier of the charge to delete. |