integrations.sh
← all integrations

adyen.com – BinLookupService

OpenAPI apis-guru payment

The BIN Lookup API provides endpoints for retrieving information, such as cost estimates, and 3D Secure supported version based on a given BIN.

Authentication

You need an to authenticate to the API.

If using an API key, add an X-API-Key header with the API key as the value, for example:

curl-H "Content-Type: application/json" \-H "X-API-Key: YOUR_API_KEY" \...

Alternatively, you can use the username and password to connect to the API using basic authentication, for example:

curl-U "ws@Company.YOUR_COMPANY_ACCOUNT":"YOUR_BASIC_AUTHENTICATION_PASSWORD" \-H "Content-Type: application/json" \...

Versioning

The BinLookup API supports using a version suffix in the endpoint URL. This suffix has the following format: "vXX", where XX is the version number.

For example:

https://pal-test.adyen.com/pal/servlet/BinLookup/v40/get3dsAvailability```## Going live
To authneticate to the live endpoints, you need an [API credential](https://docs.adyen.com/development-resources/api-credentials) from your live Customer Area.
The live endpoint URLs contain a prefix which is unique to your company account:

https://{PREFIX}-pal-live.adyenpayments.com/pal/servlet/BinLookup/v40/get3dsAvailability


Get your `{PREFIX}` from your live Customer Area under **Developers** > **API URLs** > **Prefix**.
Homepage
https://api.apis.guru/v2/specs/adyen.com:BinLookupService/40.json
Provider
adyen.com:BinLookupService / BinLookupService
OpenAPI version
3.1.0
Spec (JSON)
https://api.apis.guru/v2/specs/adyen.com/BinLookupService/40/openapi.json
Spec (YAML)
https://api.apis.guru/v2/specs/adyen.com/BinLookupService/40/openapi.yaml

Tools (4)

Extracted live via the executor SDK.

  • general.postGet3dsAvailability

    Verifies whether 3D Secure is available for the specified BIN or card brand. For 3D Secure 2, this endpoint also returns device fingerprinting keys.

    For more information, refer to .

  • general.postGetCostEstimate

    This API is available only for merchants operating in Australia, the EU, and the UK.

    Use the Adyen Cost Estimation API to pre-calculate interchange and scheme fee costs. Knowing these costs prior actual payment authorisation gives you an opportunity to charge those costs to the cardholder, if necessary.

    To retrieve this information, make the call to the /getCostEstimate endpoint. The response to this call contains the amount of the interchange and scheme fees charged by the network for this transaction, and also which surcharging policy is possible (based on current regulations).

    Since not all information is known in advance (for example, if the cardholder will successfully authenticate via 3D Secure or if you also plan to provide additional Level 2/3 data), the returned amounts are based on a set of assumption criteria you define in the assumptions parameter.

  • openapi.previewSpec

    Preview an OpenAPI document before adding it as a source

  • openapi.addSource

    Add an OpenAPI source and register its operations as tools