---
title: "List custom payment gateways"
method: GET
path: "/api/sites/multiscreen/{site_name}/ecommerce/payment-gateways"
tags: ["Payment Gateways"]
---

# List custom payment gateways

`GET /api/sites/multiscreen/{site_name}/ecommerce/payment-gateways`

## Request

- Base URL: `https://api.duda.co`
- URL: `https://api.duda.co/api/sites/multiscreen/{site_name}/ecommerce/payment-gateways`
- Auth: HTTP basic

Returns the custom payment gateways configured for the site.

## Path parameters

- `site_name` string, required

## Response `200`

OK

- CustomPaymentGatewaysOutputDto
  - `offset` integer: Amount of results that will be skipped.
  - `limit` integer: Amount of results that will be retrieved.
  - `total_responses` integer: Total of results
  - `results` CustomPaymentGatewayOutputDto[]
    - `id` string: System identifier of the custom payment gateway
    - `live_payment_methods_url` string, uri: The payment methods API endpoint that will be called to retrieve the available payment methods for the cart in LIVE mode
    - `test_payment_methods_url` string, uri: The payment methods API endpoint that will be called to retrieve the available payment methods for the cart in TEST mode. This URL can be the same as live_payment_methods_url
    - `name` string, nullable: Display name visible to merchants in the dashboard of the payment gateway
    - `description` string, nullable: Description visible to merchants in the dashboard of the payment gateway
    - `image` string, nullable: Image URL representing the payment gateway visible in the merchant dashboard
    - `icons` string[], nullable: List of icons URLs representing the available payment methods for the payment gateway
    - `management_url` string, nullable: URL defined by the payment gateway to redirect merchants on their platform

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Content
- `429`: Too many requests. The rate limit was exceeded.

---

[API](https://skmtc.dev/duda/apis/duda-partner-api.md) - [All operations](https://skmtc.dev/duda/apis/duda-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duda/apis/duda-partner-api/revisions/52be4d41cb12?raw)