List Payment Methods
Returns a paginated list of payment methods that have been configured in the system for the authenticated merchant.
IDs of both "Physical" payment terminals that can be used to process Card Present transactions and IDs of "Virtual" terminals (hosted payment forms / iframes) that can be used to process Card Not Present transactions will be returned.
Filtering and Sorting
You can filter and sort the results using query parameters:
Available Filter/Sort Fields:
id
- Payment method IDpaymentMethodType
- Type of payment method (Physical, Virtual)currency
- Currency (USD, CAD)description
- Payment method descriptionownerId
- The Merchant ID that owns this Payment Method ID
Filter Operators:
Operator | Meaning |
---|---|
== |
Equals |
!= |
Not equals |
> |
Greater than |
< |
Less than |
>= |
Greater than or equal to |
<= |
Less than or equal to |
@= |
Contains |
_= |
Starts with |
_-= |
Ends with |
!@= |
Does not Contains |
!_= |
Does not Starts with |
!_-= |
Does not Ends with |
@=* |
Case-insensitive string Contains |
_=* |
Case-insensitive string Starts with |
_-=* |
Case-insensitive string Ends with |
==* |
Case-insensitive string Equals |
!=* |
Case-insensitive string Not equals |
!@=* |
Case-insensitive string does not Contains |
!_=* |
Case-insensitive string does not Starts with |
Examples:
- Filter by type:
?filters=paymentMethodType==Physical
- Multiple filters:
?filters=paymentMethodType==Physical,currency==USD
- Sort results:
?sorts=paymentMethodType,description
- Combined:
?filters=currency==USD&sorts=description
Query parameters
-
filters
string Filter criteria in the format: field==value,field!=value Multiple filters can be separated by commas. Available fields: id, paymentMethodType, currency, description, ownerId
-
sorts
string Sort criteria as comma-separated field names. Available fields: id, paymentMethodType, currency, description, ownerId
-
page
integer Page number to retrieve (starts at 1). For example, if you have 100 records with 10 per page, page 2 gives you records 11 to 20.
Minimum value is
1
. Default value is1
. -
pageSize
integer Number of records per page. For example, if you have 100 records with 10 per page, page 2 gives you records 11 to 20.
Minimum value is
1
, maximum value is100
. Default value is10
.
curl \
--request GET 'https://api.omni.integratedcommerce.io/v1/payment-methods' \
--header "x-api-key: $API_KEY"
{
"page": 1,
"items": [
{
"id": "pmt_trm_01JRZPTMTBN41PC3VPQNZ5T3HF",
"type": "Physical",
"currency": "USD",
"description": "Main Store Terminal"
}
],
"pageSize": 10,
"totalCount": 1,
"totalPages": 1,
"hasNextPage": false,
"hasPreviousPage": false
}
{
"page": 1,
"items": [
{
"id": "pmt_trm_01JRZPTMTBN41PC3VPQNZ5T3HF",
"type": "Physical",
"currency": "USD",
"description": "Main Store Terminal"
},
{
"id": "pmt_trm_01JRZQW7FXMG62D8HJTPK3Y5VB",
"type": "Physical",
"currency": "USD",
"description": "Secondary Store Terminal"
},
{
"id": "pmt_vrt_01JRZPTWS99Z7RB57Q1CVWSWDS",
"type": "Virtual",
"currency": "USD",
"description": "Online Checkout Iframe"
}
],
"pageSize": 10,
"totalCount": 3,
"totalPages": 1,
"hasNextPage": false,
"hasPreviousPage": false
}
{
"code": 1000,
"status": "Rejected",
"message": "Invalid or missing API key",
"traceId": "1-6838be96-74c62f8e2804352739e63476",
"timestamp": "2025-05-29T20:07:50.4723483Z",
"errorDetails": []
}