payment_gateways
Description
This property helper lets you know which payment gateways we currently support.
The values
JSON object has the following properties
- name: The name of this payment gateway.
- type: The internal designation of this payment method.
- id_description: The description of the id field for this gateway.
- test_id: The default id you can use for testing this gateway.
- key_description: The description of the key field for this gateway.
- test_key: The default key you can use for testing this gateway.
- third_party_key_description: The description of the third party key field for this gateway.
- test_third_party_key: The default third party key you can use for testing this gateway.
- supports_auth_only: Whether or not this gateway supports authorize only instead of auth+capture.
- card_verification: This value is using for verification, can have one of this value:
"Disabled": Will never verify payment methods. Not recommended.
"Enabled, automatically": Will perform a verification on zero-amount transactions when a payment method is required (such as future subscriptions). Greater than zero-amount transactions will be authorized or auth+captured at the full amount. "Always and only verify": For all transactions where a payment method is required (both zero-amount and greater than zero-amount), the payment method will be verified. Payment will not be collected without additional action. Only recommended in specific situations.
In all cases, a payment method will not be required for "free" transactions, such as if a coupon brings the order total to zero. - card_verification_config: This setting configures what amount should be used when verifying the customers card, based on the card type. It should be a stringified valid JSON object, formatted like this (which is also the default value):
{"verification_amounts": {"visa": 1, "mastercard": 1, "american_express": 1, "discover": 1, "default": 1}}
Please check with your gateway or merchant account provider for these values, as some processors prefer different values. - supports_card_verification: Whether or not this gateway supports verification mode. If false, the currency set in Foxy will be ignored by the gateway, so you must ensure your Foxy account matches the currency of the gateway account.
- supports_multi_currency: Whether or not this gateway supports multiple currencies. If false, the currency set in Foxy will be ignored by the gateway, so you must ensure your Foxy account matches the currency of the gateway account.
- supports_3d_secure: Whether or not this gateway supports 3D Secure functionality.
- config_3d_secure: For which types of CC supports 3D Secure functionality.
- is_deprecated: True if this gateway is deprecated and should no longer be used.
- additional_fields: If this gateway requires additional information, this will contain details about the data which needs to be collected to configure this gateway.
Interact with this resource
To interact with this resource and see it in the context of the API, you can utilise Postman or your Terminal/Console to perform requests. If you have a Foxy store, you can also use the API browser in the admin to interact with resources connected to your store.
Actions
- GET
- View a payment_gateways
- HEAD
- Get just the header response
- OPTIONS
- Get a response explaining which HTTP methods are supported
Properties
Property | Description | Type | Constraints |
---|---|---|---|
message | A small, human readable explanation of this property helper. | String | Read only |
values | JSON objects with the gateway type as the object key and various properties and there values. | JSON | Read only |
Example Representation
{ "_links": { "curies": [ { "name": "fx", "href": "https://api.foxycart.com/rels/{rel}", "templated": true } ], "self": { "href": "https://api.foxycart.com/property_helpers/payment_gateways", "title": "List of supported Payment Gateways and valid entries for that resource's type setting." }, "fx:property_helpers": { "href": "https://api.foxycart.com/property_helpers", "title": "Property Helpers Home" } }, "message": "The key values listed here are the correct values for the PaymentGateway type field. It also includes all of the additional default values for a payment gateway.", "values": { "authorize": { "description": "Braintree", "type": "braintree_sdk", "use_auth_only": false, "account_id": "", "account_key": "", "third_party_key": "", "card_verification": "", "card_verification_config": "", "config_3d_secure": "", "additional_fields": "{\"private_key\":\"\",\"merchant_account_id\":\"\",\"threedsecure\":\"\",\"frauddetection\":\"native\",\"test_private_key\":\"a866e141e0315c712dd3f15377f759c9\",\"test_merchant_account_id\":\"\",\"test_threedsecure\":\"\",\"test_frauddetection\":\"native\"}", "test_account_id": "nmkfrzgtsrx2kbpm", "test_account_key": "ybzzcyggyfkd2fvv", "test_third_party_key": "", "test_card_verification": "enabled_automatically", "test_card_verification_config": "{\"verification_amounts\":{\"visa\":1,\"mastercard\":1,\"american_express\":1,\"discover\":1,\"default\":11}}", "date_created": "2024-11-11T15:10:27-0800", "date_modified": "2024-11-28T08:46:56-0800" }, "orbital_salem": { "name": "Chase Paymentech Orbital (Salem)", "id_description": "Username (optional)", "test_id": "", "key_description": "Password (optional)", "test_key": "", "third_party_key_description": "Merchant ID", "test_third_party_key": "", "supports_auth_only": 1, "supports_multi_currency": false, "supports_3d_secure": 0, "is_deprecated": false, "additional_fields": { "blocks": [ { "id": "orbital_additonal_fields", "parent_id": "gateway_live", "fields": [ { "id": "terminal_id", "name": "Terminal ID", "type": "text", "default_value": "001", "description": "If you don't know the exact value, leave it blank" } ], "is_live": true }, { "id": "test_orbital_additional_fields", "parent_id": "gateway_test", "fields": [ { "id": "test_terminal_id", "name": "Test Terminal ID", "type": "text", "default_value": "001", "description": "If you don't know the exact value, leave it blank" } ], "is_live": false } ] } }, ... } }
<?xml version="1.0" encoding="UTF-8"?> <resource href="https://api.foxycart.com/property_helpers/payment_gateways"> <link rel="self" href="https://api.foxycart.com/property_helpers/payment_gateways" title="List of supported Payment Gateways and valid entries for that resource&#039;s type setting."/> <link rel="https://api.foxycart.com/rels/property_helpers" href="https://api.foxycart.com/property_helpers" title="Property Helpers Home"/> <message>The key values listed here are the correct values for the PaymentGateway type field. It also includes all of the additional default values for a payment gateway.</message> <values> <authorize> <name>Authorize.net</name> <id_description>API ID</id_description> <test_id>BxFSnPy7</test_id> <key_description>Transaction Key</key_description> <test_key>8SPBTpqs4uf2ZwM8</test_key> <third_party_key_description></third_party_key_description> <test_third_party_key></test_third_party_key> <supports_auth_only>1</supports_auth_only> <supports_multi_currency>false</supports_multi_currency> <supports_3d_secure>0</supports_3d_secure> <is_deprecated>false</is_deprecated> <additional_fields></additional_fields> </authorize> <orbital_salem> <name>Chase Paymentech Orbital (Salem)</name> <id_description>Username (optional)</id_description> <test_id></test_id> <key_description>Password (optional)</key_description> <test_key></test_key> <third_party_key_description>Merchant ID</third_party_key_description> <test_third_party_key></test_third_party_key> <supports_auth_only>1</supports_auth_only> <supports_multi_currency>false</supports_multi_currency> <supports_3d_secure>0</supports_3d_secure> <is_deprecated>false</is_deprecated> <additional_fields> <blocks> <id>orbital_additonal_fields</id> <parent_id>gateway_live</parent_id> <fields> <id>terminal_id</id> <name>Terminal ID</name> <type>text</type> <default_value>001</default_value> <description>If you don&#039;t know the exact value, leave it blank</description> </fields> <is_live>true</is_live> </blocks> <blocks> <id>test_orbital_additional_fields</id> <parent_id>gateway_test</parent_id> <fields> <id>test_terminal_id</id> <name>Test Terminal ID</name> <type>text</type> <default_value>001</default_value> <description>If you don&#039;t know the exact value, leave it blank</description> </fields> <is_live>false</is_live> </blocks> </additional_fields> </orbital_salem> ... </values> </resource>
{ "properties": { "message": "The key values listed here are the correct values for the PaymentGateway type field. It also includes all of the additional default values for a payment gateway.", "values": { "authorize": { "name": "Authorize.net", "id_description": "API ID", "test_id": "BxFSnPy7", "key_description": "Transaction Key", "test_key": "8SPBTpqs4uf2ZwM8", "third_party_key_description": "", "test_third_party_key": "", "supports_auth_only": 1, "supports_multi_currency": false, "supports_3d_secure": 0, "is_deprecated": false, "additional_fields": "" }, "orbital_tampa": { "name": "Chase Paymentech Orbital (Tampa)", "id_description": "Username (optional)", "test_id": "", "key_description": "Password (optional)", "test_key": "", "third_party_key_description": "Merchant ID", "test_third_party_key": "", "supports_auth_only": 1, "supports_multi_currency": false, "supports_3d_secure": 0, "is_deprecated": false, "additional_fields": { "blocks": [ { "id": "orbital_additonal_fields", "parent_id": "gateway_live", "fields": [ { "id": "terminal_id", "name": "Terminal ID", "type": "text", "default_value": "001", "description": "If you don't know the exact value, leave it blank" } ], "is_live": true }, { "id": "test_orbital_additional_fields", "parent_id": "gateway_test", "fields": [ { "id": "test_terminal_id", "name": "Test Terminal ID", "type": "text", "default_value": "001", "description": "If you don't know the exact value, leave it blank" } ], "is_live": false } ] } }, ... } }, "links": [ { "rel": [ "self" ], "href": "https://api.foxycart.com/property_helpers/payment_gateways" }, { "rel": [ "https://api.foxycart.com/rels/property_helpers" ], "href": "https://api.foxycart.com/property_helpers" } ] }
Zoomable Resources
This resource has no linked resources which can be "zoomed" in on, filtered and embedded within this resource.