MOmollie
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.

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

Request

  • Base URL
    https://api.mollie.com
  • 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

Headers

idempotency-keystring
Example:123e4567-e89b-12d3-a456-426

A unique key to ensure idempotent requests. This key should be a UUID v4 string.

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

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

Changes

  • 489fede6d3d0Revision 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

  • 7cab62b21830Revision changes
    • info

      added the non-success response with the status