Search PaymentGateways

Search and list PaymentGateway records with filtering, sorting, and pagination.

GET /api/billing/paymentgateways

Search PaymentGateways

cURL

curl --request GET \
  --url https://spaces.nexudus.com/api/billing/paymentgateways \
  --header 'Authorization: Basic <encoded-value>'

200

{
  "Records": [
    {}
  ],
  "CurrentPage": 123,
  "CurrentPageSize": 123,
  "CurrentOrderField": "<string>",
  "CurrentSortDirection": 123,
  "FirstItem": 123,
  "LastItem": 123,
  "TotalItems": 123,
  "TotalPages": 123,
  "HasNextPage": true,
  "HasPreviousPage": true
}

A PaymentGateway represents a connection to one of the supported payment gateways used to process card payments.

Each gateway can be associated to one or more locations (Business entity) via the DefaultPaymentGatewayId property on the business. A gateway is configured with a specific PaymentGatewayType (e.g. stripe, braintree, adyen) and the corresponding credentials (AccessToken, ConfigurationXml).

An optional TransactionFee can be set to track per-transaction costs, and a FinancialAccountId and TaxRateId can be linked for accounting purposes.

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 PaymentGateway-List role.

Enums

ePaymentGatewayType — PaymentGatewayType values

Value	Name
0	None
1	test
2	authorize_net
3	beanstream
4	braintree
6	first_data_e4
7	jetpay_v2
8	merchant_e_solutions
9	netbilling
10	payment_express
12	sage
13	stripe
14	trans_first
15	usa_epay
17	blue_pay
18	cyber_source
19	elavon
20	first_data_e4_v27
21	litle
22	mercury
23	nmi
24	payflow_pro
25	quantum
26	secure_net
27	trust_commerce
28	worldpay
29	wirecard
30	paymill
31	merchant_warrior
32	nab_transact
33	secure_pay_au
34	eway
35	migs
36	pin
37	ogone
38	realex
39	moneris
40	psi_gate
41	epay
42	hdfc
43	net_pay
44	redsys
45	iridium
46	barclays_epdq_extra_plus
49	paypal
50	payex
51	openpay
52	hps
53	checkout
54	checkout_v2
55	worldpay_us
56	conekta
57	orbital
59	barclaycard_smartpay
60	trans_first_transaction_express
63	forte
65	citrus_pay
66	payu_latam
67	global_collect
68	cayan
69	clearhaus
70	sage_pay
71	safe_charge
72	mercado_pago
73	payeezy
200	acapture
201	adyen
203	banco_sabadell
208	blue_snap
209	borgun
210	bpoint
212	bridge_pay
213	card_connect
214	card_stream
215	cardprocess
217	cecabank
218	cenpos
224	creditcall
225	credorax
226	ct_payment
227	culqi
229	data_cash
230	diamond_mind
231	dibs
232	digitzs
234	element
237	eway_rapid
238	ezic
239	fat_zebra
242	first_giving
243	first_pay
244	flo2cash
245	flo2cash_simple
247	global
249	global_iris
250	global_transport
253	iats_payments
255	iveri
256	ixopay
257	jabstry
258	jetpay
260	kushki
261	latitude19
263	maxipago
266	merchant_partners
272	mundipagg
274	ncr_secure_pay
280	optimal_payments
282	pay_conex
283	pay_junction_v2
288	paymentez
291	paystation
294	pro_pay
296	qbms
298	quickpay
299	quickpay_v10
300	qvalent
303	s5
309	securion_pay
312	tns
317	vanco
318	visanet_peru
319	wepay
320	stripe_payment_intents
321	stripeACH
323	quickbooks
324	monei
401	HostedPaymentPage1
402	HostedPaymentPage2
403	HostedPaymentPage3

Query Parameters

Pagination & Sorting

page · integer · default: "1"

The page number to retrieve.

size · integer · default: "25"

The number of records per page.

orderBy · string

The property name to sort results by (e.g. Name, CreatedOn).

dir · integer

Sort direction. 0 for ascending, 1 for descending.

Filters

PaymentGateway_Business · integer

Filter by iD of the business linked to this record.

PaymentGateway_Name · string

Filter by display name for this payment gateway configuration.

PaymentGateway_PaymentGatewayType · integer

Filter by the payment provider to use (e.g. stripe, braintree, adyen). Determines which credentials are required.

PaymentGateway_Attempt3dSecure · boolean

Filter by whether attempt3d secure is enabled.

PaymentGateway_AccessToken · string

Filter by aPI access token or secret key for authenticating with the payment provider.

PaymentGateway_ConfigurationXml · string

Filter by provider-specific configuration in XML format (e.g. merchant ID, additional keys).

PaymentGateway_XmlResponse · string

Filter by last XML response returned by the payment provider.

PaymentGateway_TransactionFee · number

Filter by fee charged per transaction processed through this gateway.

PaymentGateway_FinancialAccount · integer

Filter by iD of the financial account linked to this record.

PaymentGateway_TaxRate · integer

Filter by iD of the tax rate linked to this record.

Range Filters

from_PaymentGateway_TransactionFee · number

Filter by fee charged per transaction processed through this gateway greater than or equal to this value.

to_PaymentGateway_TransactionFee · number

Filter by fee charged per transaction processed through this gateway less than or equal to this value.

from_PaymentGateway_CreatedOn · string

Filter records created on or after this date. Format: YYYY-MM-DDTHH:mm.

to_PaymentGateway_CreatedOn · string

Filter records created on or before this date. Format: YYYY-MM-DDTHH:mm.

from_PaymentGateway_UpdatedOn · string

Filter records updated on or after this date. Format: YYYY-MM-DDTHH:mm.

to_PaymentGateway_UpdatedOn · string

Filter records updated on or before this date. Format: YYYY-MM-DDTHH:mm.

Code Examples

Simple listing

cURL

curl -X GET \
  "https://spaces.nexudus.com/api/billing/paymentgateways?page=1&size=15&orderBy=Name&dir=0" \
  -H "Authorization: Bearer YOUR_TOKEN"

Filtering by Name

cURL

curl -X GET \
  "https://spaces.nexudus.com/api/billing/paymentgateways?PaymentGateway_Name=example-value&orderBy=Name&dir=0" \
  -H "Authorization: Bearer YOUR_TOKEN"

Range filters

cURL

curl -X GET \
  "https://spaces.nexudus.com/api/billing/paymentgateways?from_PaymentGateway_UpdatedOn=2025-01-01T00:00&to_PaymentGateway_UpdatedOn=2025-12-31T23:59&orderBy=UpdatedOn&dir=0" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

200

Records · PaymentGateway[]

The list of PaymentGateway records matching the query. See the Get one PaymentGateway endpoint for the full list of properties returned for each record.

Partial records — The listing endpoint returns a summary representation of each PaymentGateway. The following fields are not populated in the Records[] response: ConfigurationXml, TransactionFee.

To get all fields, fetch the full record using the Get one PaymentGateway endpoint.

Important for updates: When updating a record via PUT, always retrieve the full record with a GET request first, apply your changes to that complete data, and then send the updated record. Do not use data from a listing response as the base for a PUT request, as missing fields may be unintentionally cleared.

CurrentPage · integer

Current page number.

CurrentPageSize · integer

Number of records per page.

CurrentOrderField · string

The field used for sorting.

CurrentSortDirection · integer

The sort direction (0 = ascending, 1 = descending).

FirstItem · integer

Index of the first item on the current page.

LastItem · integer

Index of the last item on the current page.

TotalItems · integer

Total number of matching records across all pages.

TotalPages · integer

Total number of pages.

HasNextPage · boolean

Whether there is a next page of results.

HasPreviousPage · boolean

Whether there is a previous page of results.

Example Response

{
  "Records": [
    {
      "BusinessId": 0,
      "Name": "",
      "PaymentGatewayType": 0,
      "Attempt3dSecure": false,
      "AccessToken": null,
      "XmlResponse": null,
      "FinancialAccountId": null,
      "TaxRateId": null,
      "Id": 87654321,
      "UpdatedOn": "2025-01-15T10:30:00Z",
      "CreatedOn": "2025-01-10T08:00:00Z",
      "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "UpdatedBy": "[e-mail]",
      "IsNew": false,
      "SystemId": null,
      "ToStringText": "PaymentGateway Example",
      "LocalizationDetails": null,
      "CustomFields": null
    }
  ],
  "CurrentPageSize": 15,
  "CurrentPage": 1,
  "CurrentOrderField": "Name",
  "CurrentSortDirection": 1,
  "FirstItem": 1,
  "HasNextPage": false,
  "HasPreviousPage": false,
  "LastItem": 1,
  "PageNumber": 1,
  "PageSize": 15,
  "TotalItems": 1,
  "TotalPages": 1
}