MOmollie
Methods API

Enable payment method

Changed on

Enable a payment method on a specific profile.

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

Some payment methods require extra steps in order to be activated. In cases where a step at the payment method provider needs to be completed first, the status will be set to pending-external and the response will contain a link to complete the activation at the provider.

To enable voucher or gift card issuers, refer to the Enable payment method issuer endpoint.

🔑 Access with

API key

Advanced access token with profiles.write

OAuth access with profiles.write

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

Request

  • Base URL
    https://api.mollie.com/v2
  • URL
    https://api.mollie.com/v2/profiles/{profileId}/methods/{methodId}
  • 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

Response

The payment method object.

resourcestring required

Indicates the response contains a payment method object. Will always contain the string method for this endpoint.

id'null' | 'alma' | 'applepay' | 'bacs' | 'bancomatpay' | 'bancontact' | 'banktransfer' | 'belfius' | 'billie' | 'billink' | 'bizum' | 'blik' | 'creditcard' | 'directdebit' | 'eps' | 'giftcard' | 'ideal' | 'in3' | 'kbc' | 'klarna' | 'mbway' | 'mobilepay' | 'multibanco' | 'mybank' | 'paybybank' | 'paypal' | 'paysafecard' | 'pointofsale' | 'przelewy24' | 'riverty' | 'satispay' | 'swish' | 'trustly' | 'twint' | 'vipps' | 'voucher' | 'wero' nullable required

The unique identifier of the payment method. When used during payment creation, the payment method selection screen will be skipped.

descriptionstring required

The full name of the payment method.

If a locale parameter is provided, the name is translated to the given locale if possible.

statusstring nullable required

The payment method's activation status for this profile.

Possible values: activated pending-boarding pending-review pending-external rejected

Example response

{
  "resource": "method",
  "id": "ideal",
  "description": "iDeal",
  "minimumAmount": {
    "currency": "EUR",
    "value": "10.00"
  },
  "maximumAmount": {
    "currency": "EUR",
    "value": "10.00"
  },
  "image": {
    "size1x": "https://...",
    "size2x": "https://...",
    "svg": "https://..."
  },
  "status": "activated",
  "issuers": [
    {
      "id": "ideal_ABNANL2A",
      "name": "ING Bank",
      "image": {
        "size1x": "https://...",
        "size2x": "https://...",
        "svg": "https://..."
      }
    }
  ],
  "_links": {
    "self": {
      "href": "https://...",
      "type": "application/hal+json"
    },
    "documentation": {
      "href": "https://...",
      "type": "application/hal+json"
    }
  }
}

Changes

  • 64fc448adebbRevision 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