List refunds
Lists refunds with optional filters for charge and pagination.
Lists refunds with optional filters for charge and pagination.
Authorization
api-key API key for merchant integrations. Send as Authorization: Bearer <your key>.
In: header
Query Parameters
Filter by charge ID
Number of results (max 100)
Pagination offset
Response Body
application/json
curl -X GET "https://example.com/refunds"{
"data": [
{
"id": "re_abc123",
"chargeId": "ch_xyz789",
"amount": "50000",
"currency": "EGP",
"status": "succeeded",
"createdAt": "2024-01-01T00:00:00.000Z"
}
],
"hasMore": false
}Delete a price DELETE
Deletes a price. Only prices that have never been referenced by a line item can be deleted — once a price has been used in any checkout session or payment link, archive it instead. If the price is set as the default price for a product, the default price reference will be cleared.
Create a refund POST
Creates a full or partial refund for a successful charge. Target: provide EXACTLY ONE of `chargeId` or `paymentIntentId`. When `paymentIntentId` is supplied the server resolves it to the unique succeeded charge under that intent; the request is rejected if the intent has zero or multiple succeeded charges. Features: - Full or partial refunds - Ledger reversal (double-entry bookkeeping) - Balance updates (debits available funds) - Updates charge.amountRefunded - Updates paymentIntent.amountRefunded Refunds: - Hit available balance immediately (no hold period) - Create negative balance transactions - Reverse the original charge's ledger entries - Platform keeps fees (business decision)