Error
A valid request URL is required to generate request examples{
"data": [
{
"id": "<string>",
"object": "refund",
"livemode": true,
"charge_id": "<string>",
"payment_intent_id": "<string>",
"terminal_id": "<string>",
"amount": 123,
"currency": "<string>",
"status": "pending",
"reason": "requested_by_customer",
"settlement_batch_id": "<string>",
"settled_at": 123,
"failure_message": "<string>",
"created_at": 123,
"updated_at": 123
}
],
"has_more": true,
"next_cursor": "<string>"
}{
"error": {
"code": "INVALID_REQUEST",
"message": "invalid currency"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "card_error",
"decline_code": "<string>",
"decline_type": "authorization",
"retryable": true,
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "card_error",
"decline_code": "<string>",
"decline_type": "authorization",
"retryable": true,
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "card_error",
"decline_code": "<string>",
"decline_type": "authorization",
"retryable": true,
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "card_error",
"decline_code": "<string>",
"decline_type": "authorization",
"retryable": true,
"doc_url": "<string>"
}
}Refunds
List refunds
GET
/
refunds
Error
A valid request URL is required to generate request examples{
"data": [
{
"id": "<string>",
"object": "refund",
"livemode": true,
"charge_id": "<string>",
"payment_intent_id": "<string>",
"terminal_id": "<string>",
"amount": 123,
"currency": "<string>",
"status": "pending",
"reason": "requested_by_customer",
"settlement_batch_id": "<string>",
"settled_at": 123,
"failure_message": "<string>",
"created_at": 123,
"updated_at": 123
}
],
"has_more": true,
"next_cursor": "<string>"
}{
"error": {
"code": "INVALID_REQUEST",
"message": "invalid currency"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "card_error",
"decline_code": "<string>",
"decline_type": "authorization",
"retryable": true,
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "card_error",
"decline_code": "<string>",
"decline_type": "authorization",
"retryable": true,
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "card_error",
"decline_code": "<string>",
"decline_type": "authorization",
"retryable": true,
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "card_error",
"decline_code": "<string>",
"decline_type": "authorization",
"retryable": true,
"doc_url": "<string>"
}
}Authorizations
A merchant secret key (sk_…) sent as Authorization: Bearer <key>.
Headers
Merchant ID when an authorized Platform acts for a connected Merchant. Omit when authenticating directly as that Merchant.
Pattern:
^mer_[0-9A-Za-z]{14}$Query Parameters
Page size (default 20, max 100).
Required range:
1 <= x <= 100Number of records to skip.
Required range:
x >= 0Cursor: a refund id (typically the previous response's next_cursor). Returns results strictly after it, newest first. Cannot be combined with offset.
Response
A list of refunds, newest first.

