CoworkerPaymentMethods
Search CoworkerPaymentMethods
Search and list CoworkerPaymentMethod records with filtering, sorting, and pagination.
GET
Search CoworkerPaymentMethods
A CoworkerPaymentMethod is a tokenised payment method stored against a customer and a location, used when charging invoices issued to that customer by that location.
Currently supported providers are Stripe (card and ACH/BACS) and GoCardless (direct debit mandates). The
RegularPaymentProvider field identifies the provider; valid values for this entity are Stripe (2), StripeACH (11), StripeBACS (13), and GoCardless (12).
- For Stripe methods,
MethodIdholds the Stripe payment method ID andCustomerIdholds the Stripe customer ID. - For GoCardless mandates,
MandateIdholds the GoCardless mandate ID andCustomerIdholds the GoCardless customer ID. CardNumberstores a masked card number for display purposes only.
Authentication
This endpoint requires OAuth2 authentication. Include a valid bearer token in the
Authorization header.
The authenticated user must be a full unrestricted administrator or have the CoworkerPaymentMethod-List role.Enums
eRegularPaymentProvider
eRegularPaymentProvider
Query Parameters
Pagination & Sorting
integer
default:"1"
The page number to retrieve.
integer
default:"25"
The number of records per page.
string
The property name to sort results by (e.g.
Name, CreatedOn).integer
Sort direction.
0 for ascending, 1 for descending.Filters
integer
Filter by customer this payment method belongs to.
integer
Filter by location that issued or will charge invoices using this payment method.
string
Filter by location name.
string
Filter by currency code of the location.
integer
Filter by payment provider for this method. For this entity, valid values are Stripe (2), StripeACH (11), StripeBACS (13), and GoCardless (12)..
string
Filter by provider payment method ID (e.g. Stripe payment method ID).
string
Filter by provider customer ID (e.g. Stripe or GoCardless customer ID).
string
Filter by goCardless mandate ID. Only populated for GoCardless payment methods..
string
Filter by masked card number for display purposes only.
string
Filter by optional notes about this payment method.
Range Filters
string
Filter records created on or after this date. Format:
YYYY-MM-DDTHH:mm.string
Filter records created on or before this date. Format:
YYYY-MM-DDTHH:mm.string
Filter records updated on or after this date. Format:
YYYY-MM-DDTHH:mm.string
Filter records updated on or before this date. Format:
YYYY-MM-DDTHH:mm.Code Examples
Simple listing
Filtering by CreatedOn
Range filters
Response
200
CoworkerPaymentMethod[]
The list of CoworkerPaymentMethod records matching the query. See the Get one CoworkerPaymentMethod endpoint for the full list of properties returned for each record.
integer
Current page number.
integer
Number of records per page.
string
The field used for sorting.
integer
The sort direction (
0 = ascending, 1 = descending).integer
Index of the first item on the current page.
integer
Index of the last item on the current page.
integer
Total number of matching records across all pages.
integer
Total number of pages.
boolean
Whether there is a next page of results.
boolean
Whether there is a previous page of results.
Example Response
Search CoworkerPaymentMethods