Retrieves a list of payments taken by the account making the request.
GET
/v2/payments
Retrieves a list of payments taken by the account making the request.
Results are eventually consistent, and new payments or changes to payments might take several seconds to appear.
The maximum results per page is 100.
Indicates the start of the time range to retrieve payments for, in RFC 3339 format.
The range is determined using the created_at
field for each Payment. Inclusive. Default: The current time minus one year.
Indicates the end of the time range to retrieve payments for, in RFC 3339 format. The range is determined using the created_at
field for each Payment.
Default: The current time.
The order in which results are listed by Payment.created_at
:
ASC
- Oldest to newest.DESC
- Newest to oldest (default).A pagination cursor returned by a previous call to this endpoint. Provide this cursor to retrieve the next set of results for the original query.
For more information, see Pagination.
Limit results to the location supplied. By default, results are returned for the default (main) location associated with the seller.
The maximum number of results to be returned in a single page. It is possible to receive fewer results than the specified limit on a given page.
The default value of 100 is also the maximum allowed value. If the provided value is greater than 100, it is ignored and the default value is used instead.
Default: 100
Indicates the start of the time range for which to retrieve offline payments, in RFC 3339 format for timestamps. The range is determined using the offline_payment_details.client_created_at
field for each Payment. If set, payments without a value set in offline_payment_details.client_created_at
will not be returned.
Default: The current time.
Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:
UTC: 2020-01-26T02:25:34Z
Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00
Indicates the end of the time range for which to retrieve offline payments, in RFC 3339 format for timestamps. The range is determined using the offline_payment_details.client_created_at
field for each Payment. If set, payments without a value set in offline_payment_details.client_created_at
will not be returned.
Default: The current time.
Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:
UTC: 2020-01-26T02:25:34Z
Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00
The pagination cursor to be used in a subsequent request. If empty, this is the final response.
For more information, see Pagination.