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.

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.