Methods API

Enable payment method issuer

Changed on

Enable an issuer for a payment method on a specific profile.

Currently only the payment methods voucher and giftcard are supported.

When using a profile-specific API credential, the alias me can be used instead of the profile ID to refer to the current profile.

🔑 Access with

API key

Advanced access token with profiles.write

OAuth access with profiles.write

post/profiles/{profileId}/methods/{methodId}/issuers/{issuerId}

Request

  • Base URL
    https://api.mollie.com/v2
  • URL
    https://api.mollie.com/v2/profiles/{profileId}/methods/{methodId}/issuers/{issuerId}
  • Auth
    • HTTP bearer
    • or HTTP bearer
    • or OAuth 2
      Authorization code: https://my.mollie.com/oauth2/authorize
      Token URL: https://api.mollie.com/oauth2/tokens scopes: profiles.write

Request body

contractIdstring nullable

When enabling a voucher issuer, an inbetween party may be involved which you have a contract with. Provide the contract ID for the first time you enable an issuer via this contractor.

You can update the contract ID as long as it is not approved yet, by repeating the API call with a different contract ID.

Example request

{
  "contractId": "ideal"
}

Response

The payment method issuer object.

OR

Example response

{
  "id": "festivalcadeau",
  "description": "FestivalCadeau Giftcard",
  "status": "activated",
  "_links": {
    "self": {
      "href": "https://...",
      "type": "application/hal+json"
    },
    "documentation": {
      "href": "https://...",
      "type": "application/hal+json"
    }
  }
}

Changes

    • breaking

      removed the success response with the status

    • info

      added the non-success response with the status

    • info

      added the success response with the status