Skip to content

README.md

Latest commit

 

History

History
170 lines (133 loc) · 8.65 KB

README.md

File metadata and controls

170 lines (133 loc) · 8.65 KB

Sessions

Overview

Available Operations

create

🚧 Beta feature

This feature is currently in private beta, and the final specification may still change.

Create a session to start a checkout process with Mollie Components.

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.CreateSessionResponse;
import java.lang.Exception;
import java.util.List;

public class Application {

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

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

        CreateSessionResponse res = sdk.sessions().create()
                .idempotencyKey("123e4567-e89b-12d3-a456-426")
                .sessionRequest(SessionRequest.builder()
                    .amount(Amount.builder()
                        .currency("EUR")
                        .value("10.00")
                        .build())
                    .description("Order #12345")
                    .lines(List.of())
                    .redirectUrl("https://example.org/redirect")
                    .billingAddress(PaymentAddress.builder()
                        .title("Mr.")
                        .givenName("Piet")
                        .familyName("Mondriaan")
                        .organizationName("Mollie B.V.")
                        .streetAndNumber("Keizersgracht 126")
                        .streetAdditional("Apt. 1")
                        .postalCode("1234AB")
                        .email("piet@example.org")
                        .phone("31208202070")
                        .city("Amsterdam")
                        .region("Noord-Holland")
                        .country("NL")
                        .build())
                    .shippingAddress(PaymentAddress.builder()
                        .title("Mr.")
                        .givenName("Piet")
                        .familyName("Mondriaan")
                        .organizationName("Mollie B.V.")
                        .streetAndNumber("Keizersgracht 126")
                        .streetAdditional("Apt. 1")
                        .postalCode("1234AB")
                        .email("piet@example.org")
                        .phone("31208202070")
                        .city("Amsterdam")
                        .region("Noord-Holland")
                        .country("NL")
                        .build())
                    .customerId("cst_5B8cwPMGnU")
                    .sequenceType(SessionSequenceType.ONEOFF)
                    .payment(Payment.builder()
                        .webhookUrl("https://example.org/webhook")
                        .build())
                    .profileId("pfl_5B8cwPMGnU")
                    .testmode(false)
                    .build())
                .call();

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

Parameters

Parameter Type Required Description Example
idempotencyKey Optional<String> ➖ A unique key to ensure idempotent requests. This key should be a UUID v4 string. 123e4567-e89b-12d3-a456-426
sessionRequest Optional<SessionRequest> ➖ N/A

Response

CreateSessionResponse

Errors

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

get

🚧 Beta feature

This feature is currently in private beta, and the final specification may still change.

Retrieve a session to view its details and status to inform your customers about the checkout process.

Example Usage

package hello.world;

import com.mollie.mollie.Client;
import com.mollie.mollie.models.components.Security;
import com.mollie.mollie.models.operations.GetSessionResponse;
import java.lang.Exception;

public class Application {

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

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

        GetSessionResponse res = sdk.sessions().get()
                .sessionId("sess_82jFYDTrLcCQV68NLDvMJ")
                .idempotencyKey("123e4567-e89b-12d3-a456-426")
                .call();

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

Parameters

Parameter Type Required Description Example
sessionId String ✔️ Provide the ID of the related session. sess_82jFYDTrLcCQV68NLDvMJ
idempotencyKey Optional<String> ➖ A unique key to ensure idempotent requests. This key should be a UUID v4 string. 123e4567-e89b-12d3-a456-426

Response

GetSessionResponse

Errors

Error Type Status Code Content Type
models/errors/APIException 4XX, 5XX */*
⚡