Methods

Overview

Available Operations

list - List payment methods
all - List all payment methods
get - Get payment method

list

Retrieve all enabled payment methods. The results of this endpoint are not paginated — unlike most other list endpoints in our API.

For test mode, all pending and enabled payment methods are returned. If no payment methods are requested yet, the most popular payment methods are returned in the test mode. For live mode, only fully enabled payment methods are returned.

Payment methods can be requested and enabled via the Mollie Dashboard, or via the Enable payment method endpoint of the Profiles API.

The list can optionally be filtered using a number of parameters described below.

By default, only payment methods for the Euro currency are returned. If you wish to retrieve payment methods which exclusively support other currencies (e.g. Twint), you need to use the amount parameters.

ℹ️ Note: This endpoint only returns online payment methods. If you wish to retrieve the information about a non-online payment method, you can use the Get payment method endpoint.

Example Usage: list-method-200-3

package hello.world;

import com.mollie.mollie.Client;
import com.mollie.mollie.models.components.*;
import com.mollie.mollie.models.errors.ErrorResponse;
import com.mollie.mollie.models.operations.ListMethodsRequest;
import com.mollie.mollie.models.operations.ListMethodsResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws ErrorResponse, Exception {

        Client sdk = Client.builder()
                .profileId("pfl_5B8cwPMGnU")
                .testmode(false)
                .security(Security.builder()
                    .apiKey(System.getenv().getOrDefault("API_KEY", ""))
                    .build())
            .build();

        ListMethodsRequest req = ListMethodsRequest.builder()
                .sequenceType(SequenceType.ONEOFF)
                .locale(Locale.EN_US)
                .amount(Amount.builder()
                    .currency("EUR")
                    .value("10.00")
                    .build())
                .resource(MethodResourceParameter.PAYMENTS)
                .billingCountry("DE")
                .includeWallets(MethodIncludeWalletsParameter.APPLEPAY)
                .orderLineCategories(LineCategories.ECO)
                .include("issuers")
                .idempotencyKey("123e4567-e89b-12d3-a456-426")
                .build();

        ListMethodsResponse res = sdk.methods().list()
                .request(req)
                .call();

        if (res.object().isPresent()) {
            System.out.println(res.object().get());
        }
    }
}

Example Usage: list-methods-200-1

package hello.world;

import com.mollie.mollie.Client;
import com.mollie.mollie.models.components.*;
import com.mollie.mollie.models.errors.ErrorResponse;
import com.mollie.mollie.models.operations.ListMethodsRequest;
import com.mollie.mollie.models.operations.ListMethodsResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws ErrorResponse, Exception {

        Client sdk = Client.builder()
                .profileId("pfl_5B8cwPMGnU")
                .testmode(false)
                .security(Security.builder()
                    .apiKey(System.getenv().getOrDefault("API_KEY", ""))
                    .build())
            .build();

        ListMethodsRequest req = ListMethodsRequest.builder()
                .sequenceType(SequenceType.ONEOFF)
                .locale(Locale.EN_US)
                .amount(Amount.builder()
                    .currency("EUR")
                    .value("10.00")
                    .build())
                .resource(MethodResourceParameter.PAYMENTS)
                .billingCountry("DE")
                .includeWallets(MethodIncludeWalletsParameter.APPLEPAY)
                .orderLineCategories(LineCategories.ECO)
                .include("issuers")
                .idempotencyKey("123e4567-e89b-12d3-a456-426")
                .build();

        ListMethodsResponse res = sdk.methods().list()
                .request(req)
                .call();

        if (res.object().isPresent()) {
            System.out.println(res.object().get());
        }
    }
}

Example Usage: list-methods-200-2

package hello.world;

import com.mollie.mollie.Client;
import com.mollie.mollie.models.components.*;
import com.mollie.mollie.models.errors.ErrorResponse;
import com.mollie.mollie.models.operations.ListMethodsRequest;
import com.mollie.mollie.models.operations.ListMethodsResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws ErrorResponse, Exception {

        Client sdk = Client.builder()
                .profileId("pfl_5B8cwPMGnU")
                .testmode(false)
                .security(Security.builder()
                    .apiKey(System.getenv().getOrDefault("API_KEY", ""))
                    .build())
            .build();

        ListMethodsRequest req = ListMethodsRequest.builder()
                .sequenceType(SequenceType.ONEOFF)
                .locale(Locale.EN_US)
                .amount(Amount.builder()
                    .currency("EUR")
                    .value("10.00")
                    .build())
                .resource(MethodResourceParameter.PAYMENTS)
                .billingCountry("DE")
                .includeWallets(MethodIncludeWalletsParameter.APPLEPAY)
                .orderLineCategories(LineCategories.ECO)
                .include("issuers")
                .idempotencyKey("123e4567-e89b-12d3-a456-426")
                .build();

        ListMethodsResponse res = sdk.methods().list()
                .request(req)
                .call();

        if (res.object().isPresent()) {
            System.out.println(res.object().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	ListMethodsRequest	✔️	The request object to use for the request.

Response

ListMethodsResponse

Errors

Error Type	Status Code	Content Type
models/errors/ErrorResponse	400	application/hal+json
models/errors/APIException	4XX, 5XX	/

all

Retrieve all payment methods that Mollie offers, regardless of the eligibility of the organization for the specific method. The results of this endpoint are not paginated — unlike most other list endpoints in our API.

The list can optionally be filtered using a number of parameters described below.

ℹ️ Note: This endpoint only returns online payment methods. If you wish to retrieve the information about a non-online payment method, you can use the Get payment method endpoint.

Example Usage: list-all-methods-200-1

package hello.world;

import com.mollie.mollie.Client;
import com.mollie.mollie.models.components.*;
import com.mollie.mollie.models.errors.ErrorResponse;
import com.mollie.mollie.models.operations.ListAllMethodsRequest;
import com.mollie.mollie.models.operations.ListAllMethodsResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws ErrorResponse, Exception {

        Client sdk = Client.builder()
                .profileId("pfl_5B8cwPMGnU")
                .testmode(false)
                .security(Security.builder()
                    .apiKey(System.getenv().getOrDefault("API_KEY", ""))
                    .build())
            .build();

        ListAllMethodsRequest req = ListAllMethodsRequest.builder()
                .locale(Locale.EN_US)
                .amount(Amount.builder()
                    .currency("EUR")
                    .value("10.00")
                    .build())
                .include("issuers")
                .sequenceType(SequenceType.ONEOFF)
                .idempotencyKey("123e4567-e89b-12d3-a456-426")
                .build();

        ListAllMethodsResponse res = sdk.methods().all()
                .request(req)
                .call();

        if (res.object().isPresent()) {
            System.out.println(res.object().get());
        }
    }
}

Example Usage: list-all-methods-200-2

package hello.world;

import com.mollie.mollie.Client;
import com.mollie.mollie.models.components.*;
import com.mollie.mollie.models.errors.ErrorResponse;
import com.mollie.mollie.models.operations.ListAllMethodsRequest;
import com.mollie.mollie.models.operations.ListAllMethodsResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws ErrorResponse, Exception {

        Client sdk = Client.builder()
                .profileId("pfl_5B8cwPMGnU")
                .testmode(false)
                .security(Security.builder()
                    .apiKey(System.getenv().getOrDefault("API_KEY", ""))
                    .build())
            .build();

        ListAllMethodsRequest req = ListAllMethodsRequest.builder()
                .locale(Locale.EN_US)
                .amount(Amount.builder()
                    .currency("EUR")
                    .value("10.00")
                    .build())
                .include("issuers")
                .sequenceType(SequenceType.ONEOFF)
                .idempotencyKey("123e4567-e89b-12d3-a456-426")
                .build();

        ListAllMethodsResponse res = sdk.methods().all()
                .request(req)
                .call();

        if (res.object().isPresent()) {
            System.out.println(res.object().get());
        }
    }
}

Example Usage: list-all-methods-200-3

package hello.world;

import com.mollie.mollie.Client;
import com.mollie.mollie.models.components.*;
import com.mollie.mollie.models.errors.ErrorResponse;
import com.mollie.mollie.models.operations.ListAllMethodsRequest;
import com.mollie.mollie.models.operations.ListAllMethodsResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws ErrorResponse, Exception {

        Client sdk = Client.builder()
                .profileId("pfl_5B8cwPMGnU")
                .testmode(false)
                .security(Security.builder()
                    .apiKey(System.getenv().getOrDefault("API_KEY", ""))
                    .build())
            .build();

        ListAllMethodsRequest req = ListAllMethodsRequest.builder()
                .locale(Locale.EN_US)
                .amount(Amount.builder()
                    .currency("EUR")
                    .value("10.00")
                    .build())
                .include("issuers")
                .sequenceType(SequenceType.ONEOFF)
                .idempotencyKey("123e4567-e89b-12d3-a456-426")
                .build();

        ListAllMethodsResponse res = sdk.methods().all()
                .request(req)
                .call();

        if (res.object().isPresent()) {
            System.out.println(res.object().get());
        }
    }
}

Example Usage: list-all-methods-200-4

package hello.world;

import com.mollie.mollie.Client;
import com.mollie.mollie.models.components.*;
import com.mollie.mollie.models.errors.ErrorResponse;
import com.mollie.mollie.models.operations.ListAllMethodsRequest;
import com.mollie.mollie.models.operations.ListAllMethodsResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws ErrorResponse, Exception {

        Client sdk = Client.builder()
                .profileId("pfl_5B8cwPMGnU")
                .testmode(false)
                .security(Security.builder()
                    .apiKey(System.getenv().getOrDefault("API_KEY", ""))
                    .build())
            .build();

        ListAllMethodsRequest req = ListAllMethodsRequest.builder()
                .locale(Locale.EN_US)
                .amount(Amount.builder()
                    .currency("EUR")
                    .value("10.00")
                    .build())
                .include("issuers")
                .sequenceType(SequenceType.ONEOFF)
                .idempotencyKey("123e4567-e89b-12d3-a456-426")
                .build();

        ListAllMethodsResponse res = sdk.methods().all()
                .request(req)
                .call();

        if (res.object().isPresent()) {
            System.out.println(res.object().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	ListAllMethodsRequest	✔️	The request object to use for the request.

Response

ListAllMethodsResponse

Errors

Error Type	Status Code	Content Type
models/errors/ErrorResponse	400	application/hal+json
models/errors/APIException	4XX, 5XX	/

get

Retrieve a single payment method by its ID.

If a method is not available on this profile, a 404 Not Found response is returned. If the method is available but not enabled yet, a status 403 Forbidden is returned. You can enable payments methods via the Enable payment method endpoint of the Profiles API, or via the Mollie Dashboard.

If you do not know the method's ID, you can use the methods list endpoint to retrieve all payment methods that are available.

Additionally, it is possible to check if wallet methods such as Apple Pay are enabled by passing the wallet ID (applepay) as the method ID.

Example Usage

package hello.world;

import com.mollie.mollie.Client;
import com.mollie.mollie.models.components.*;
import com.mollie.mollie.models.errors.ErrorResponse;
import com.mollie.mollie.models.operations.GetMethodRequest;
import com.mollie.mollie.models.operations.GetMethodResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws ErrorResponse, Exception {

        Client sdk = Client.builder()
                .profileId("pfl_5B8cwPMGnU")
                .testmode(false)
                .security(Security.builder()
                    .apiKey(System.getenv().getOrDefault("API_KEY", ""))
                    .build())
            .build();

        GetMethodRequest req = GetMethodRequest.builder()
                .methodId(Method.IDEAL)
                .locale(Locale.EN_US)
                .currency("EUR")
                .include("issuers")
                .sequenceType(SequenceType.ONEOFF)
                .idempotencyKey("123e4567-e89b-12d3-a456-426")
                .build();

        GetMethodResponse res = sdk.methods().get()
                .request(req)
                .call();

        if (res.entityMethodGet().isPresent()) {
            System.out.println(res.entityMethodGet().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	GetMethodRequest	✔️	The request object to use for the request.

Response

GetMethodResponse

Errors

Error Type	Status Code	Content Type
models/errors/ErrorResponse	400, 404	application/hal+json
models/errors/APIException	4XX, 5XX	/

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Methods

Overview

Available Operations

list

Example Usage: list-method-200-3

Example Usage: list-methods-200-1

Example Usage: list-methods-200-2

Parameters

Response

Errors

all

Example Usage: list-all-methods-200-1

Example Usage: list-all-methods-200-2

Example Usage: list-all-methods-200-3

Example Usage: list-all-methods-200-4

Parameters

Response

Errors

get

Example Usage

Parameters

Response

Errors

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

Methods

Overview

Available Operations

list

Example Usage: list-method-200-3

Example Usage: list-methods-200-1

Example Usage: list-methods-200-2

Parameters

Response

Errors

all

Example Usage: list-all-methods-200-1

Example Usage: list-all-methods-200-2

Example Usage: list-all-methods-200-3

Example Usage: list-all-methods-200-4

Parameters

Response

Errors

get

Example Usage

Parameters

Response

Errors