List supported gateways

GET /v1/gateways_options.<format> HTTPS/1.1
Host: core.spreedly.com

Example response has been truncated for brevity

HTTPS/1.1 200 OK
{
  "gateways": [
    {
      "gateway_type": "acapture",
      "name": "Acapture",
      "auth_modes": [
        {
          "auth_mode_type": "default",
          "name": "Default",
          "credentials": [
            {
              "name": "entity_id",
              "label": "Entity Id",
              "safe": true
            },
            {
              "name": "access_token",
              "label": "Access Token",
              "safe": false
            }
          ]
        }
      ],
      "characteristics": [
        "purchase",
        "authorize",
        "capture",
        "credit",
        "void",
        "verify"
      ],
      "payment_methods": [
        "credit_card"
      ],
      "gateway_settings": [

      ],
      "gateway_specific_fields": [
        "disable_3d_secure"
      ],
      "supported_countries": [
        "AD",
        "AI",
        "AT",
        "BE",
        "BG",
        "CA",
        "HR",
        "CY",
        "CZ",
        "DK",
        "EE",
        "FI",
        "FR",
        "DE",
        "GR",
        "HK",
        "HU",
        "IS",
        "IT",
        "LV",
        "LI",
        "LT",
        "LU",
        "MT",
        "MC",
        "NL",
        "PL",
        "PT",
        "SM",
        "SK",
        "SI",
        "ES",
        "SE",
        "CH",
        "TR",
        "GB",
        "US"
      ],
      "supported_cardtypes": [
        "visa",
        "master",
        "american_express",
        "diners_club",
        "discover",
        "jcb",
        "maestro",
        "dankort"
      ],
      "regions": [
        "asia_pacific",
        "europe",
        "north_america"
      ],
      "homepage": "https://www.acapture.com",
      "display_api_url": "https://oppwa.com/v1/payments",
      "company_name": "Acapture"
    },
    {
      "gateway_type": "adyen",
      "name": "Adyen",
      "auth_modes": [
        {
          "auth_mode_type": "default",
          "name": "Default",
          "credentials": [
            {
              "name": "merchant_account",
              "label": "Merchant Account",
              "safe": true
            },
            {
              "name": "username",
              "label": "Username",
              "safe": true
            },
            {
              "name": "password",
              "label": "Password",
              "safe": false
            }
          ]
        }
      ],
      "characteristics": [
        "purchase",
        "authorize",
        "capture",
        "credit",
        "general_credit",
        "void",
        "adjust",
        "verify",
        "3dsecure_purchase",
        "3dsecure_authorize",
        "3dsecure_2_mpi_purchase",
        "3dsecure_2_mpi_authorize",
        "store",
        "remove",
        "network_tokenization",
        "populate_mit_fields",
        "transaction_retry",
        "3dsecure_2_purchase",
        "3dsecure_2_authorize",
        "stored_credentials",
        "card_scheme_ntid",
        "moto_exemption",
        "low_value_exemption"
      ],
      "payment_methods": [
        "credit_card",
        "apple_pay",
        "google_pay",
        "third_party_token",
        "bank_account"
      ],
      "gateway_settings": [
        {
          "name": "subdomain",
          "label": "Subdomain"
        }
      ],
      "gateway_specific_fields": [
        "shopper_reference",
        "shopper_statement",
        "fraud_offset",
        "selected_brand",
        "delivery_date",
        "merchant_order_reference",
        "shopper_interaction",
        "installments",
        "recurring_processing_model",
        "brand_override",
        "custom_routing_flag",
        "user_agent",
        "accept_header",
        "risk_data",
        "shopper_ip",
        "threed_dynamic",
        "idempotency_key",
        "device_fingerprint",
        "adjust_authorisation_data",
        "authorisation_type",
        "requested_test_acquirer_response_code",
        "update_shopper_statement",
        "industry_usage",
        "capture_delay_hours",
        "splits",
        "tokenize_only",
        "recurring_contract_type",
        "recurring_detail_reference",
        "sub_merchant_id",
        "sub_merchant_name",
        "sub_merchant_street",
        "sub_merchant_city",
        "sub_merchant_state",
        "sub_merchant_postal_code",
        "sub_merchant_country",
        "sub_merchant_tax_id",
        "sub_merchant_mcc",
        "sub_merchant_data",
        "cancel_or_refund",
        "network_transaction_id",
        "external_platform",
        "merchant_application",
        "verify_amount",
        "level_2_data",
        "level_3_data",
        "additional_data_airline",
        "additional_data_lodging",
        "store",
        "date_of_birth",
        "nationality",
        "fund_source",
        "address_override",
        "mcc",
        "metadata"
      ],
      "supported_countries": [
        "AT",
        "AU",
        "BE",
        "BG",
        "BR",
        "CH",
        "CY",
        "CZ",
        "DE",
        "DK",
        "EE",
        "ES",
        "FI",
        "FR",
        "GB",
        "GI",
        "GR",
        "HK",
        "HU",
        "IE",
        "IS",
        "IT",
        "LI",
        "LT",
        "LU",
        "LV",
        "MC",
        "MT",
        "MX",
        "NL",
        "NO",
        "PL",
        "PT",
        "RO",
        "SE",
        "SG",
        "SK",
        "SI",
        "US"
      ],
      "supported_cardtypes": [
        "visa",
        "master",
        "american_express",
        "diners_club",
        "jcb",
        "dankort",
        "maestro",
        "discover",
        "elo",
        "naranja",
        "cabal",
        "unionpay"
      ],
      "regions": [
        "asia_pacific",
        "europe",
        "latin_america",
        "north_america"
      ],
      "homepage": "https://www.adyen.com/",
      "display_api_url": "https://pal-live.adyen.com/pal/servlet/",
      "company_name": "Adyen"
    }
  ]
}
<gateways>
  <gateway>
    <gateway_type>acapture</gateway_type>
    <name>Acapture</name>
    <auth_modes>
      <auth_mode>
        <auth_mode_type>default</auth_mode_type>
        <name>Default</name>
        <credentials>
          <credential>
            <name>entity_id</name>
            <label>Entity Id</label>
            <safe type="boolean">true</safe>
          </credential>
          <credential>
            <name>access_token</name>
            <label>Access Token</label>
            <safe type="boolean">false</safe>
          </credential>
        </credentials>
      </auth_mode>
    </auth_modes>
    <gateway_settings>
    </gateway_settings>
    <characteristics>
      <supports_purchase type="boolean">true</supports_purchase>
      <supports_authorize type="boolean">true</supports_authorize>
      <supports_capture type="boolean">true</supports_capture>
      <supports_credit type="boolean">true</supports_credit>
      <supports_general_credit type="boolean">false</supports_general_credit>
      <supports_void type="boolean">true</supports_void>
      <supports_adjust type="boolean">false</supports_adjust>
      <supports_verify type="boolean">true</supports_verify>
      <supports_reference_purchase type="boolean">false</supports_reference_purchase>
      <supports_purchase_via_preauthorization type="boolean">false</supports_purchase_via_preauthorization>
      <supports_offsite_purchase type="boolean">false</supports_offsite_purchase>
      <supports_offsite_authorize type="boolean">false</supports_offsite_authorize>
      <supports_offsite_synchronous_purchase type="boolean">false</supports_offsite_synchronous_purchase>
      <supports_offsite_synchronous_authorize type="boolean">false</supports_offsite_synchronous_authorize>
      <supports_3dsecure_purchase type="boolean">false</supports_3dsecure_purchase>
      <supports_3dsecure_authorize type="boolean">false</supports_3dsecure_authorize>
      <supports_3dsecure_2_mpi_purchase type="boolean">false</supports_3dsecure_2_mpi_purchase>
      <supports_3dsecure_2_mpi_authorize type="boolean">false</supports_3dsecure_2_mpi_authorize>
      <supports_store type="boolean">false</supports_store>
      <supports_remove type="boolean">false</supports_remove>
      <supports_fraud_review type="boolean">false</supports_fraud_review>
      <supports_network_tokenization type="boolean">false</supports_network_tokenization>
      <supports_populate_mit_fields type="boolean">false</supports_populate_mit_fields>
      <supports_inquire_by_gateway_transaction_id type="boolean">false</supports_inquire_by_gateway_transaction_id>
      <supports_inquire_by_order_id type="boolean">false</supports_inquire_by_order_id>
      <supports_transaction_retry type="boolean">false</supports_transaction_retry>
      <supports_stored_stored_credentials type="boolean">false</supports_stored_stored_credentials>
    </characteristics>
    <payment_methods>
      <payment_method>credit_card</payment_method>
    </payment_methods>
    <gateway_specific_fields>
      <gateway_specific_field>disable_3d_secure</gateway_specific_field>
    </gateway_specific_fields>
    <supported_countries>AD, AI, AT, BE, BG, CA, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HK, HU, IS, IT, LV, LI, LT, LU, MT, MC, NL, PL, PT, SM, SK, SI, ES, SE, CH, TR, GB, US</supported_countries>
    <supported_cardtypes>visa, master, american_express, diners_club, discover, jcb, maestro, dankort</supported_cardtypes>
    <regions>asia_pacific, europe, north_america</regions>
    <homepage>https://www.acapture.com</homepage>
    <display_api_url>https://oppwa.com/v1/payments</display_api_url>
    <company_name>Acapture</company_name>
  </gateway>
  <gateway>
    <gateway_type>adyen</gateway_type>
    <name>Adyen</name>
    <auth_modes>
      <auth_mode>
        <auth_mode_type>default</auth_mode_type>
        <name>Default</name>
        <credentials>
          <credential>
            <name>merchant_account</name>
            <label>Merchant Account</label>
            <safe type="boolean">true</safe>
          </credential>
          <credential>
            <name>username</name>
            <label>Username</label>
            <safe type="boolean">true</safe>
          </credential>
          <credential>
            <name>password</name>
            <label>Password</label>
            <safe type="boolean">false</safe>
          </credential>
        </credentials>
      </auth_mode>
    </auth_modes>
    <gateway_settings>
      <gateway_setting>
        <name>subdomain</name>
        <label>Subdomain</label>
      </gateway_setting>
    </gateway_settings>
    <characteristics>
      <supports_purchase type="boolean">true</supports_purchase>
      <supports_authorize type="boolean">true</supports_authorize>
      <supports_capture type="boolean">true</supports_capture>
      <supports_credit type="boolean">true</supports_credit>
      <supports_general_credit type="boolean">true</supports_general_credit>
      <supports_void type="boolean">true</supports_void>
      <supports_adjust type="boolean">true</supports_adjust>
      <supports_verify type="boolean">true</supports_verify>
      <supports_reference_purchase type="boolean">false</supports_reference_purchase>
      <supports_purchase_via_preauthorization type="boolean">false</supports_purchase_via_preauthorization>
      <supports_offsite_purchase type="boolean">false</supports_offsite_purchase>
      <supports_offsite_authorize type="boolean">false</supports_offsite_authorize>
      <supports_offsite_synchronous_purchase type="boolean">false</supports_offsite_synchronous_purchase>
      <supports_offsite_synchronous_authorize type="boolean">false</supports_offsite_synchronous_authorize>
      <supports_3dsecure_purchase type="boolean">true</supports_3dsecure_purchase>
      <supports_3dsecure_authorize type="boolean">true</supports_3dsecure_authorize>
      <supports_3dsecure_2_mpi_purchase type="boolean">true</supports_3dsecure_2_mpi_purchase>
      <supports_3dsecure_2_mpi_authorize type="boolean">true</supports_3dsecure_2_mpi_authorize>
      <supports_store type="boolean">true</supports_store>
      <supports_remove type="boolean">true</supports_remove>
      <supports_fraud_review type="boolean">false</supports_fraud_review>
      <supports_network_tokenization type="boolean">true</supports_network_tokenization>
      <supports_populate_mit_fields type="boolean">true</supports_populate_mit_fields>
      <supports_inquire_by_gateway_transaction_id type="boolean">false</supports_inquire_by_gateway_transaction_id>
      <supports_inquire_by_order_id type="boolean">false</supports_inquire_by_order_id>
      <supports_transaction_retry type="boolean">true</supports_transaction_retry>
      <supports_stored_stored_credentials type="boolean">false</supports_stored_stored_credentials>
      <supports_3dsecure_2_purchase type="boolean">true</supports_3dsecure_2_purchase>
      <supports_3dsecure_2_authorize type="boolean">true</supports_3dsecure_2_authorize>
      <supports_stored_credentials type="boolean">true</supports_stored_credentials>
      <supports_card_scheme_ntid type="boolean">true</supports_card_scheme_ntid>
      <supports_moto_exemption type="boolean">true</supports_moto_exemption>
      <supports_low_value_exemption type="boolean">true</supports_low_value_exemption>
    </characteristics>
    <payment_methods>
      <payment_method>credit_card</payment_method>
      <payment_method>apple_pay</payment_method>
      <payment_method>google_pay</payment_method>
      <payment_method>third_party_token</payment_method>
      <payment_method>bank_account</payment_method>
    </payment_methods>
    <gateway_specific_fields>
      <gateway_specific_field>shopper_reference</gateway_specific_field>
      <gateway_specific_field>shopper_statement</gateway_specific_field>
      <gateway_specific_field>fraud_offset</gateway_specific_field>
      <gateway_specific_field>selected_brand</gateway_specific_field>
      <gateway_specific_field>delivery_date</gateway_specific_field>
      <gateway_specific_field>merchant_order_reference</gateway_specific_field>
      <gateway_specific_field>shopper_interaction</gateway_specific_field>
      <gateway_specific_field>installments</gateway_specific_field>
      <gateway_specific_field>recurring_processing_model</gateway_specific_field>
      <gateway_specific_field>brand_override</gateway_specific_field>
      <gateway_specific_field>custom_routing_flag</gateway_specific_field>
      <gateway_specific_field>user_agent</gateway_specific_field>
      <gateway_specific_field>accept_header</gateway_specific_field>
      <gateway_specific_field>risk_data</gateway_specific_field>
      <gateway_specific_field>shopper_ip</gateway_specific_field>
      <gateway_specific_field>threed_dynamic</gateway_specific_field>
      <gateway_specific_field>idempotency_key</gateway_specific_field>
      <gateway_specific_field>device_fingerprint</gateway_specific_field>
      <gateway_specific_field>adjust_authorisation_data</gateway_specific_field>
      <gateway_specific_field>authorisation_type</gateway_specific_field>
      <gateway_specific_field>requested_test_acquirer_response_code</gateway_specific_field>
      <gateway_specific_field>update_shopper_statement</gateway_specific_field>
      <gateway_specific_field>industry_usage</gateway_specific_field>
      <gateway_specific_field>capture_delay_hours</gateway_specific_field>
      <gateway_specific_field>splits</gateway_specific_field>
      <gateway_specific_field>tokenize_only</gateway_specific_field>
      <gateway_specific_field>recurring_contract_type</gateway_specific_field>
      <gateway_specific_field>recurring_detail_reference</gateway_specific_field>
      <gateway_specific_field>sub_merchant_id</gateway_specific_field>
      <gateway_specific_field>sub_merchant_name</gateway_specific_field>
      <gateway_specific_field>sub_merchant_street</gateway_specific_field>
      <gateway_specific_field>sub_merchant_city</gateway_specific_field>
      <gateway_specific_field>sub_merchant_state</gateway_specific_field>
      <gateway_specific_field>sub_merchant_postal_code</gateway_specific_field>
      <gateway_specific_field>sub_merchant_country</gateway_specific_field>
      <gateway_specific_field>sub_merchant_tax_id</gateway_specific_field>
      <gateway_specific_field>sub_merchant_mcc</gateway_specific_field>
      <gateway_specific_field>sub_merchant_data</gateway_specific_field>
      <gateway_specific_field>cancel_or_refund</gateway_specific_field>
      <gateway_specific_field>network_transaction_id</gateway_specific_field>
      <gateway_specific_field>external_platform</gateway_specific_field>
      <gateway_specific_field>merchant_application</gateway_specific_field>
      <gateway_specific_field>verify_amount</gateway_specific_field>
      <gateway_specific_field>level_2_data</gateway_specific_field>
      <gateway_specific_field>level_3_data</gateway_specific_field>
      <gateway_specific_field>additional_data_airline</gateway_specific_field>
      <gateway_specific_field>additional_data_lodging</gateway_specific_field>
      <gateway_specific_field>store</gateway_specific_field>
      <gateway_specific_field>date_of_birth</gateway_specific_field>
      <gateway_specific_field>nationality</gateway_specific_field>
      <gateway_specific_field>fund_source</gateway_specific_field>
      <gateway_specific_field>address_override</gateway_specific_field>
      <gateway_specific_field>mcc</gateway_specific_field>
      <gateway_specific_field>metadata</gateway_specific_field>
    </gateway_specific_fields>
    <supported_countries>AT, AU, BE, BG, BR, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GI, GR, HK, HU, IE, IS, IT, LI, LT, LU, LV, MC, MT, MX, NL, NO, PL, PT, RO, SE, SG, SK, SI, US</supported_countries>
    <supported_cardtypes>visa, master, american_express, diners_club, jcb, dankort, maestro, discover, elo, naranja, cabal, unionpay</supported_cardtypes>
    <regions>asia_pacific, europe, latin_america, north_america</regions>
    <homepage>https://www.adyen.com/</homepage>
    <display_api_url>https://pal-live.adyen.com/pal/servlet/</display_api_url>
    <company_name>Adyen</company_name>
  </gateway>
</gateways>

Retrieve a list of all gateways, and their properties, supported by Spreedly. This call can be used to dynamically present a gateway credential form to users or to do any sort of dynamic rendering.

URL Parameters

Parameter Description
format
required
One of json or xml

Response Body

Notable response elements include:

Element Description
gateways Root element
❯ name The human readable name of the gateway
❯ gateway_type The type (short name) of the gateway. Use this value when provisioning a gateway.
❯ auth_modes A list of authorization modes for the gateway. An auth mode is basically a list of credentials required for this gateway (some gateways support various ways of entering credentials).
❯ gateway_settings The non-credential fields that can be specified at the gateway level, and included in all transactions
❯ characteristics A list of operations (such as purchase, capture etc…) that the gateway supports
❯ payment_methods A list of payment methods (such as credit_card, apple_pay, google_pay, etc…) that the gateway supports
❯ gateway_specific_fields The list of gateway specific fields that can be specified in supported gateway transactions
❯ supported_countries The list of countries this gateway supports
❯ supported_cardtypes The list of credit card brands this gateway supports
❯ regions The list of geographic regions this gateway supports (determined by the supported_countries)