Search & list payments

get

https://api.staging.payrails.io/payment/payments

Fetch a list of payments.

Query Params

includeInstrument

boolean

Defaults to false

Boolean indicating if the payment instrument should be included in the response.

includeProviderAccountDisplayName

boolean

Defaults to false

Boolean indicating if the provider account display name should be included in the response.

includePaymentToken

boolean

Defaults to false

Boolean indicating if the instrument payment token should be included in the response.

includeHolderReference

boolean

Defaults to false

Boolean indicating if the holder reference should be included in the response.

filter[paymentId]

string

Filter for a list of payments by payment ID.

filter[providerId]

string

Filter for a list of payments by provider ID.

filter[providerConfigId]

string

Filter for a list of payments by provider config ID.

filter[providerReference]

string

Filter for a list of payments by provider reference.

filter[holderId]

string

Filter for a list of payments by holder ID.

filter[holderReference]

string

Filter for a list of payments by holder reference.

filter[transactionReference]

string

Filter for a list of payments by transaction reference.

filter[merchantReference]

string

Filter for a list of payments by merchant reference.

filter[processingType]

string

Filter for a list of payments by payment processing type.

filter[captureMode]

string

Filter for a list of payments by capture mode. Capture mode defines if money is captured instantly, with delay or manually.

filter[status]

string

Filter for a list of payments by latest payment status.

filter[anyReference]

string

Filter for a list of payments by any reference.

filter[tokenType]

string

enum

Filter for a list of payments by instrument token type.

Allowed:

filter[instrumentId]

string

Filter for a list of payments by instrument ID.

filter[instrumentBin]

string

Filter for a list of payments by instrument BIN.

filter[instrumentSuffix]

string

Filter for a list of payments by instrument suffix.

filter[instrumentNetwork]

string

Filter for a list of payments by card network.

filter[instrumentLocalNetwork]

string

Filter for a list of payments by card network.

filter[instrumentIssuer]

string

Filter for a list of payments by instrument issuer.

filter[instrumentIssuerCountry]

string

Filter for a list of payments by instrument issuer country.

filter[instrumentFutureUsage]

string

Filter for a list of payments by instrument future usage.

filter[authorizationFailureResult]

string

Filter for a list of payments by the authorization failure result.

filter[workspaceId]

string

Filter by Workspace ID.

filter[paymentMethodType]

string

Filter for a list of payments by payment method.

filter[customerEmail]

string

Filter for a list of payments by customer email.

filter[createdAt]

string

Filter by createdAt field using interval notation.

1973-02-03T04:32:11.596Z - exact date value

(1973-02-03T04:32:11.596Z - after the date excluding it

[1973-02-03T04:32:11.596Z - after the date including it

1973-02-03T04:32:11.596Z) - before the date excluding it

1973-02-03T04:32:11.596Z] - before the date including it

(1973-02-03T04:32:11.596Z,1973-04-03T03:20:11.436Z) - between two dates excluding both

(1973-02-03T04:32:11.596Z,1973-04-03T03:20:11.436Z] - between two dates excluding on the left

[1973-02-03T04:32:11.596Z,1973-04-03T03:20:11.436Z) - between two dates excluding on the right

[1973-02-03T04:32:11.596Z,1973-04-03T03:20:11.436Z] - between two dates including both.

page[cursor]

string

Search collection items from that cursor.

page[after]

string

Search collection items after that cursor.

page[before]

string

Search collection items before that cursor.

page[size]

int32

Length of the collection to search.

Responses

200Success.

400Bad Request.

401Unauthorized.

403Insufficient Scope.

429Too Many Requests.