Get issuer

Issuers API v1

Warning

The v1 API has been deprecated. The v1 API will be supported for the foreseeable future, at least until July 2023. However, new features will only be added to the v2 API.

The new v2 API no longer supports retrieving issuers separately. Instead, issuers can be retrieved by using the issuers include on the Methods API. Documentation for the Methods API v2 can be found here. For more information on the v2 API, refer to our v2 migration guide.

GEThttps://api.mollie.com/v1/issuers/*id*

Authentication:API keysApp access tokens

Retrieve a payment method issuer by its issuer identifier.

The Issuers API only supports iDEAL.

Parameters

Replace id in the endpoint URL by the issuer’s ID, for example ideal_ABNANL2A.

Access token parameters

If you are using organization access tokens or are creating an OAuth app, the testmode query string parameter is also available.

testmodebooleanoptionalShow details

Set this to true to only retrieve the issuer if it is available in test mode.

Response

200 application/json

resourcestring

Indicates the response contains an issuer object. Will always contain issuer for this endpoint.

idstring

The identifier uniquely referring to this issuer. When supplying this ID as the issuer parameter during payment creation, the issuer selection screen is skipped.

namestring

The full name of the issuer, for example ‘ABN AMRO’.

methodstring

The payment method this issuer belongs to.

Possible values: ideal

imageobject

URLs of images representing the payment method issuer.

Show child parameters

normalstring

The URL for an issuer icon of 55x37 pixels.

biggerstring

The URL for an issuer icon of 110x74 pixels.

Example

Request

curl -X GET https://api.mollie.com/v1/issuers/ideal_ABNANL2A \
    -H "Authorization: Bearer test_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM"

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
    "resource": "issuer",
    "id": "ideal_ABNANL2A",
    "name": "ABN AMRO",
    "method": "ideal",
    "image": {
        "normal": "https://www.mollie.com/images/checkout/v2/ideal-issuer-icons/ABNANL2A.png",
        "bigger": "https://www.mollie.com/images/checkout/v2/ideal-issuer-icons/ABNANL2A%402x.png"
    }
}