Error
A valid request URL is required to generate request examples{
"data": [
{
"payment_context": {
"version": 1,
"channel": "<string>",
"flow": "<string>",
"wallet": "unknown",
"wallet_evidence": "unknown",
"initiated_by": "<string>",
"card_brand": "<string>",
"card_funding": "<string>",
"card_entry_method": "<string>",
"observed_at": "2023-11-07T05:31:56Z",
"checkout_session_id": "<string>",
"payment_link_id": "<string>",
"invoice_id": "<string>",
"subscription_id": "<string>",
"card_country": "<string>"
},
"payment_lifecycle": {
"attempted_at": "2023-11-07T05:31:56Z",
"dispatched_at": "2023-11-07T05:31:56Z",
"authorized_at": "2023-11-07T05:31:56Z",
"captured_at": "2023-11-07T05:31:56Z",
"voided_at": "2023-11-07T05:31:56Z",
"finalized_at": "2023-11-07T05:31:56Z"
},
"id": "<string>",
"object": "charge",
"intent_id": "<string>",
"payment_method": "<string>",
"amount": 123,
"amount_refunded": 123,
"currency": "<string>",
"status": "pending",
"authorization_code": "<string>",
"settlement_batch_id": "<string>",
"settled_at": 123,
"decline_code": "<string>",
"decline_type": "<string>",
"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>"
}
}Charges
List charges
GET
/
charges
Error
A valid request URL is required to generate request examples{
"data": [
{
"payment_context": {
"version": 1,
"channel": "<string>",
"flow": "<string>",
"wallet": "unknown",
"wallet_evidence": "unknown",
"initiated_by": "<string>",
"card_brand": "<string>",
"card_funding": "<string>",
"card_entry_method": "<string>",
"observed_at": "2023-11-07T05:31:56Z",
"checkout_session_id": "<string>",
"payment_link_id": "<string>",
"invoice_id": "<string>",
"subscription_id": "<string>",
"card_country": "<string>"
},
"payment_lifecycle": {
"attempted_at": "2023-11-07T05:31:56Z",
"dispatched_at": "2023-11-07T05:31:56Z",
"authorized_at": "2023-11-07T05:31:56Z",
"captured_at": "2023-11-07T05:31:56Z",
"voided_at": "2023-11-07T05:31:56Z",
"finalized_at": "2023-11-07T05:31:56Z"
},
"id": "<string>",
"object": "charge",
"intent_id": "<string>",
"payment_method": "<string>",
"amount": 123,
"amount_refunded": 123,
"currency": "<string>",
"status": "pending",
"authorization_code": "<string>",
"settlement_batch_id": "<string>",
"settled_at": 123,
"decline_code": "<string>",
"decline_type": "<string>",
"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 charge id (typically the previous response's next_cursor). Returns results strictly after it, newest first. Cannot be combined with offset.
Response
A list of charges, newest first.

