v1

latestOpenAPI 3.0.12026-07-242871595.3 MB
CHARGES

Get charges

Displays a list of existing charges. First displays the newest charge in the list. See Get charges tutorials for more information.

get/v1/charges

Query parameters

gtstring date-time

Displays results when the created field is greater than the current value.

gtestring date-time

Displays results when the created field is greater than or equal to the current value.

ltstring date-time

Displays results when the created field is less than the current value.

ltestring date-time

Displays results when the created field is less than or equal to the current value.

customerstring

Displays charges associated with the provided customer ID.

ending_beforestring

Cursor used in pagination. The ending_before object ID sets your place in the list. For example, if you receive 100 objects in a list starting with obj_bar, add ending_before=obj_bar in your subsequent request to retrieve the previous page of the list.

expandstring[]

Additional information provided as an expanded response, for example, a related object nested within the parent. See Use expandable fields.

limitinteger

Number of objects returned by the request, ranging between 1 and 100. Default: 10

threeds_validation_resultstring

EMV® 3-D Secure (3DS) authentication result. 3-D Secure is a protocol that provides an additional security layer for online credit and debit card-not-present (CNP) transactions.

is_threedsboolean

Indicates whether the transaction is 3-D Secure authenticated.

starting_afterstring

Cursor used in pagination. The starting_after object ID sets your place in the list. For example, if you receive 100 objects in a list starting with obj_foo, add starting_after=obj_foo in your subsequent request to retrieve the next page of the list.

Headers

User-Agentstring required

Identifies the application, operating system, vendor, and/or version of the requesting user agent. Format: <AppName>/<Version> <Comment>

Response

Successful response. Charges displayed.

has_moreboolean required

Indicates whether the list of charges are spread to further pages.

object'list' required

Object type. Example: List

urlstring required

URL of the list of charges.