Skip to content

Commit 76519a3

Browse files
sumup-bot[bot]sumup-bot[bot]
committed
chore: generate code
1 parent 9d14668 commit 76519a3

28 files changed

Lines changed: 734 additions & 189 deletions

‎src/main/java/com/sumup/sdk/clients/CheckoutsAsyncClient.java‎

Lines changed: 73 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,10 +14,19 @@
1414
/**
1515
* Client for the "Checkouts" API group.
1616
*
17-
* <p>Accept payments from your end users by adding the Checkouts model to your platform. SumUp
18-
* supports standard and single payment 3DS checkout flows. The Checkout model allows creating,
19-
* listing, retrieving, processing and deactivating checkouts. A payment is completed by creating a
20-
* checkout and then processing the checkout.
17+
* <p>Checkouts represent online payment sessions that you create before attempting to charge a
18+
* payer. A checkout captures the payment intent, such as the amount, currency, merchant, and
19+
* optional customer or redirect settings, and then moves through its lifecycle as you process it.
20+
* Use this tag to: - create a checkout before collecting or confirming payment details - process
21+
* the checkout with a card, saved card, wallet, or supported alternative payment method - retrieve
22+
* or list checkouts to inspect their current state and associated payment attempts - deactivate a
23+
* checkout that should no longer be used Typical workflow: - create a checkout with the order
24+
* amount, currency, and merchant information - process the checkout through SumUp client tools such
25+
* as the [Payment Widget and Swift Checkout
26+
* SDK](https://developer.sumup.com/online-payments/checkouts) - retrieve the checkout or use the
27+
* Transactions endpoints to inspect the resulting payment record Checkouts are used to initiate and
28+
* orchestrate online payments. Transactions remain the authoritative record of the resulting
29+
* payment outcome.
2130
*/
2231
public final class CheckoutsAsyncClient {
2332
private final ApiClient apiClient;
@@ -31,6 +40,66 @@ public CheckoutsAsyncClient(ApiClient apiClient) {
3140
this.apiClient = Objects.requireNonNull(apiClient, "apiClient");
3241
}
3342

43+
/**
44+
* Create an apple pay session.
45+
*
46+
* <p>Creates an Apple Pay merchant session for the specified checkout. Use this endpoint after
47+
* the customer selects Apple Pay and before calling
48+
* `ApplePaySession.completeMerchantValidation(...)` in the browser. SumUp validates the merchant
49+
* session request and returns the Apple Pay session object that your frontend should pass to
50+
* Apple's JavaScript API.
51+
*
52+
* <p>Operation ID: CreateApplePaySession
53+
*
54+
* @param id Unique ID of the checkout resource.
55+
* @param request The data needed to create an apple pay session for a checkout.
56+
* <p>Call the overload that accepts RequestOptions to customize headers, authorization, or
57+
* request timeout.
58+
* @return CompletableFuture resolved with {@code java.util.Map<String, Object>} parsed response.
59+
* @throws ApiException if the SumUp API returns an error.
60+
*/
61+
public CompletableFuture<java.util.Map<String, Object>> createApplePaySession(
62+
String id, com.sumup.sdk.models.CreateApplePaySessionRequest request) throws ApiException {
63+
return createApplePaySession(id, request, null);
64+
}
65+
66+
/**
67+
* Create an apple pay session.
68+
*
69+
* <p>Creates an Apple Pay merchant session for the specified checkout. Use this endpoint after
70+
* the customer selects Apple Pay and before calling
71+
* `ApplePaySession.completeMerchantValidation(...)` in the browser. SumUp validates the merchant
72+
* session request and returns the Apple Pay session object that your frontend should pass to
73+
* Apple's JavaScript API.
74+
*
75+
* <p>Operation ID: CreateApplePaySession
76+
*
77+
* @param id Unique ID of the checkout resource.
78+
* @param request The data needed to create an apple pay session for a checkout.
79+
* @param requestOptions Request-specific overrides (headers, authorization, or timeout). Pass
80+
* {@code null} to use client defaults.
81+
* @return CompletableFuture resolved with {@code java.util.Map<String, Object>} parsed response.
82+
* @throws ApiException if the SumUp API returns an error.
83+
*/
84+
public CompletableFuture<java.util.Map<String, Object>> createApplePaySession(
85+
String id,
86+
com.sumup.sdk.models.CreateApplePaySessionRequest request,
87+
RequestOptions requestOptions)
88+
throws ApiException {
89+
Objects.requireNonNull(id, "id");
90+
String path = "/v0.2/checkouts/{id}/apple-pay-session";
91+
path = path.replace("{id}", ApiClient.urlEncode(String.valueOf(id)));
92+
93+
return this.apiClient.sendAsync(
94+
HttpMethod.PUT,
95+
path,
96+
null,
97+
null,
98+
request,
99+
new TypeReference<java.util.Map<String, Object>>() {},
100+
requestOptions);
101+
}
102+
34103
/**
35104
* Create a checkout
36105
*

‎src/main/java/com/sumup/sdk/clients/CheckoutsClient.java‎

Lines changed: 73 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,19 @@
1313
/**
1414
* Client for the "Checkouts" API group.
1515
*
16-
* <p>Accept payments from your end users by adding the Checkouts model to your platform. SumUp
17-
* supports standard and single payment 3DS checkout flows. The Checkout model allows creating,
18-
* listing, retrieving, processing and deactivating checkouts. A payment is completed by creating a
19-
* checkout and then processing the checkout.
16+
* <p>Checkouts represent online payment sessions that you create before attempting to charge a
17+
* payer. A checkout captures the payment intent, such as the amount, currency, merchant, and
18+
* optional customer or redirect settings, and then moves through its lifecycle as you process it.
19+
* Use this tag to: - create a checkout before collecting or confirming payment details - process
20+
* the checkout with a card, saved card, wallet, or supported alternative payment method - retrieve
21+
* or list checkouts to inspect their current state and associated payment attempts - deactivate a
22+
* checkout that should no longer be used Typical workflow: - create a checkout with the order
23+
* amount, currency, and merchant information - process the checkout through SumUp client tools such
24+
* as the [Payment Widget and Swift Checkout
25+
* SDK](https://developer.sumup.com/online-payments/checkouts) - retrieve the checkout or use the
26+
* Transactions endpoints to inspect the resulting payment record Checkouts are used to initiate and
27+
* orchestrate online payments. Transactions remain the authoritative record of the resulting
28+
* payment outcome.
2029
*/
2130
public final class CheckoutsClient {
2231
private final ApiClient apiClient;
@@ -30,6 +39,66 @@ public CheckoutsClient(ApiClient apiClient) {
3039
this.apiClient = Objects.requireNonNull(apiClient, "apiClient");
3140
}
3241

42+
/**
43+
* Create an apple pay session.
44+
*
45+
* <p>Creates an Apple Pay merchant session for the specified checkout. Use this endpoint after
46+
* the customer selects Apple Pay and before calling
47+
* `ApplePaySession.completeMerchantValidation(...)` in the browser. SumUp validates the merchant
48+
* session request and returns the Apple Pay session object that your frontend should pass to
49+
* Apple's JavaScript API.
50+
*
51+
* <p>Operation ID: CreateApplePaySession
52+
*
53+
* @param id Unique ID of the checkout resource.
54+
* @param request The data needed to create an apple pay session for a checkout.
55+
* <p>Call the overload that accepts RequestOptions to customize headers, authorization, or
56+
* request timeout.
57+
* @return {@code java.util.Map<String, Object>} parsed response.
58+
* @throws ApiException if the SumUp API returns an error.
59+
*/
60+
public java.util.Map<String, Object> createApplePaySession(
61+
String id, com.sumup.sdk.models.CreateApplePaySessionRequest request) throws ApiException {
62+
return createApplePaySession(id, request, null);
63+
}
64+
65+
/**
66+
* Create an apple pay session.
67+
*
68+
* <p>Creates an Apple Pay merchant session for the specified checkout. Use this endpoint after
69+
* the customer selects Apple Pay and before calling
70+
* `ApplePaySession.completeMerchantValidation(...)` in the browser. SumUp validates the merchant
71+
* session request and returns the Apple Pay session object that your frontend should pass to
72+
* Apple's JavaScript API.
73+
*
74+
* <p>Operation ID: CreateApplePaySession
75+
*
76+
* @param id Unique ID of the checkout resource.
77+
* @param request The data needed to create an apple pay session for a checkout.
78+
* @param requestOptions Request-specific overrides (headers, authorization, or timeout). Pass
79+
* {@code null} to use client defaults.
80+
* @return {@code java.util.Map<String, Object>} parsed response.
81+
* @throws ApiException if the SumUp API returns an error.
82+
*/
83+
public java.util.Map<String, Object> createApplePaySession(
84+
String id,
85+
com.sumup.sdk.models.CreateApplePaySessionRequest request,
86+
RequestOptions requestOptions)
87+
throws ApiException {
88+
Objects.requireNonNull(id, "id");
89+
String path = "/v0.2/checkouts/{id}/apple-pay-session";
90+
path = path.replace("{id}", ApiClient.urlEncode(String.valueOf(id)));
91+
92+
return this.apiClient.send(
93+
HttpMethod.PUT,
94+
path,
95+
null,
96+
null,
97+
request,
98+
new TypeReference<java.util.Map<String, Object>>() {},
99+
requestOptions);
100+
}
101+
33102
/**
34103
* Create a checkout
35104
*

‎src/main/java/com/sumup/sdk/clients/PayoutsAsyncClient.java‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ public PayoutsAsyncClient(ApiClient apiClient) {
3333
/**
3434
* List payouts
3535
*
36-
* <p>Lists ordered payouts for the merchant profile.
36+
* <p>Lists ordered payouts for the merchant account.
3737
*
3838
* <p>Operation ID: ListPayouts
3939
*
@@ -52,7 +52,7 @@ public CompletableFuture<com.sumup.sdk.models.FinancialPayouts> listPayouts(
5252
/**
5353
* List payouts
5454
*
55-
* <p>Lists ordered payouts for the merchant profile.
55+
* <p>Lists ordered payouts for the merchant account.
5656
*
5757
* <p>Operation ID: ListPayouts
5858
*
@@ -75,7 +75,7 @@ public CompletableFuture<com.sumup.sdk.models.FinancialPayouts> listPayouts(
7575
/**
7676
* List payouts
7777
*
78-
* <p>Lists ordered payouts for the merchant profile.
78+
* <p>Lists ordered payouts for the merchant account.
7979
*
8080
* <p>Operation ID: ListPayouts
8181
*
@@ -116,7 +116,7 @@ public CompletableFuture<com.sumup.sdk.models.FinancialPayouts> listPayouts(
116116
/**
117117
* List payouts
118118
*
119-
* <p>Lists ordered payouts for the merchant profile.
119+
* <p>Lists ordered payouts for the merchant account.
120120
*
121121
* <p>Operation ID: ListPayoutsV1
122122
*
@@ -137,7 +137,7 @@ public CompletableFuture<com.sumup.sdk.models.FinancialPayouts> listPayoutsV1(
137137
/**
138138
* List payouts
139139
*
140-
* <p>Lists ordered payouts for the merchant profile.
140+
* <p>Lists ordered payouts for the merchant account.
141141
*
142142
* <p>Operation ID: ListPayoutsV1
143143
*
@@ -162,7 +162,7 @@ public CompletableFuture<com.sumup.sdk.models.FinancialPayouts> listPayoutsV1(
162162
/**
163163
* List payouts
164164
*
165-
* <p>Lists ordered payouts for the merchant profile.
165+
* <p>Lists ordered payouts for the merchant account.
166166
*
167167
* <p>Operation ID: ListPayoutsV1
168168
*

‎src/main/java/com/sumup/sdk/clients/PayoutsClient.java‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ public PayoutsClient(ApiClient apiClient) {
3232
/**
3333
* List payouts
3434
*
35-
* <p>Lists ordered payouts for the merchant profile.
35+
* <p>Lists ordered payouts for the merchant account.
3636
*
3737
* <p>Operation ID: ListPayouts
3838
*
@@ -51,7 +51,7 @@ public com.sumup.sdk.models.FinancialPayouts listPayouts(
5151
/**
5252
* List payouts
5353
*
54-
* <p>Lists ordered payouts for the merchant profile.
54+
* <p>Lists ordered payouts for the merchant account.
5555
*
5656
* <p>Operation ID: ListPayouts
5757
*
@@ -74,7 +74,7 @@ public com.sumup.sdk.models.FinancialPayouts listPayouts(
7474
/**
7575
* List payouts
7676
*
77-
* <p>Lists ordered payouts for the merchant profile.
77+
* <p>Lists ordered payouts for the merchant account.
7878
*
7979
* <p>Operation ID: ListPayouts
8080
*
@@ -115,7 +115,7 @@ public com.sumup.sdk.models.FinancialPayouts listPayouts(
115115
/**
116116
* List payouts
117117
*
118-
* <p>Lists ordered payouts for the merchant profile.
118+
* <p>Lists ordered payouts for the merchant account.
119119
*
120120
* <p>Operation ID: ListPayoutsV1
121121
*
@@ -136,7 +136,7 @@ public com.sumup.sdk.models.FinancialPayouts listPayoutsV1(
136136
/**
137137
* List payouts
138138
*
139-
* <p>Lists ordered payouts for the merchant profile.
139+
* <p>Lists ordered payouts for the merchant account.
140140
*
141141
* <p>Operation ID: ListPayoutsV1
142142
*
@@ -161,7 +161,7 @@ public com.sumup.sdk.models.FinancialPayouts listPayoutsV1(
161161
/**
162162
* List payouts
163163
*
164-
* <p>Lists ordered payouts for the merchant profile.
164+
* <p>Lists ordered payouts for the merchant account.
165165
*
166166
* <p>Operation ID: ListPayoutsV1
167167
*

‎src/main/java/com/sumup/sdk/clients/TransactionsAsyncClient.java‎

Lines changed: 28 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,22 @@
1414
/**
1515
* Client for the "Transactions" API group.
1616
*
17-
* <p>Retrieve details for a specific transaction by it’s `id` or any other required query
18-
* parameter, or list all transactions related to the merchant account.
17+
* <p>Transactions represent completed or attempted payment operations processed for a merchant
18+
* account. A transaction contains the core payment result, such as the amount, currency, payment
19+
* method, creation time, and current high-level status. In addition to the main payment outcome, a
20+
* transaction can contain related events that describe what happened after the original payment
21+
* attempt. These events provide visibility into the financial lifecycle of the transaction, for
22+
* example: - `PAYOUT`: the payment being prepared for payout or included in a payout to the
23+
* merchant - `REFUND`: money returned to the payer - `CHARGE_BACK`: money reversed after the
24+
* original payment - `PAYOUT_DEDUCTION`: an amount deducted from a payout to cover a refund or
25+
* chargeback From an integrator's perspective, transactions are the authoritative record of payment
26+
* outcomes. Use this tag to: - list transactions for reporting, reconciliation, and customer
27+
* support workflows - retrieve a single transaction when you need the latest payment details -
28+
* inspect `simple_status` for the current merchant-facing outcome of the payment - inspect `events`
29+
* or `transaction_events` when you need refund, payout, or chargeback history Typical workflow: -
30+
* create and process payments through the Checkouts endpoints - use the Transactions endpoints to
31+
* read the resulting payment records - use the returned statuses and events to update your own
32+
* order, accounting, or support systems
1933
*/
2034
public final class TransactionsAsyncClient {
2135
private final ApiClient apiClient;
@@ -33,8 +47,8 @@ public TransactionsAsyncClient(ApiClient apiClient) {
3347
* Retrieve a transaction
3448
*
3549
* <p>Retrieves the full details of an identified transaction. The transaction resource is
36-
* identified by a query parameter and *one* of following parameters is required: * `id` *
37-
* `internal_id` * `transaction_code` * `foreign_transaction_id` * `client_transaction_id`
50+
* identified by a query parameter and *one* of following parameters is required: - `id` -
51+
* `internal_id` - `transaction_code` - `foreign_transaction_id` - `client_transaction_id`
3852
*
3953
* <p>Operation ID: GetTransaction
4054
*
@@ -53,8 +67,8 @@ public CompletableFuture<com.sumup.sdk.models.TransactionFull> getTransaction()
5367
* Retrieve a transaction
5468
*
5569
* <p>Retrieves the full details of an identified transaction. The transaction resource is
56-
* identified by a query parameter and *one* of following parameters is required: * `id` *
57-
* `internal_id` * `transaction_code` * `foreign_transaction_id` * `client_transaction_id`
70+
* identified by a query parameter and *one* of following parameters is required: - `id` -
71+
* `internal_id` - `transaction_code` - `foreign_transaction_id` - `client_transaction_id`
5872
*
5973
* <p>Operation ID: GetTransaction
6074
*
@@ -73,8 +87,8 @@ public CompletableFuture<com.sumup.sdk.models.TransactionFull> getTransaction(
7387
* Retrieve a transaction
7488
*
7589
* <p>Retrieves the full details of an identified transaction. The transaction resource is
76-
* identified by a query parameter and *one* of following parameters is required: * `id` *
77-
* `internal_id` * `transaction_code` * `foreign_transaction_id` * `client_transaction_id`
90+
* identified by a query parameter and *one* of following parameters is required: - `id` -
91+
* `internal_id` - `transaction_code` - `foreign_transaction_id` - `client_transaction_id`
7892
*
7993
* <p>Operation ID: GetTransaction
8094
*
@@ -106,8 +120,8 @@ public CompletableFuture<com.sumup.sdk.models.TransactionFull> getTransaction(
106120
* Retrieve a transaction
107121
*
108122
* <p>Retrieves the full details of an identified transaction. The transaction resource is
109-
* identified by a query parameter and *one* of following parameters is required: * `id` *
110-
* `internal_id` * `transaction_code` * `foreign_transaction_id` * `client_transaction_id`
123+
* identified by a query parameter and *one* of following parameters is required: - `id` -
124+
* `internal_id` - `transaction_code` - `foreign_transaction_id` - `client_transaction_id`
111125
*
112126
* <p>Operation ID: GetTransactionV2.1
113127
*
@@ -126,8 +140,8 @@ public CompletableFuture<com.sumup.sdk.models.TransactionFull> getTransactionV21
126140
* Retrieve a transaction
127141
*
128142
* <p>Retrieves the full details of an identified transaction. The transaction resource is
129-
* identified by a query parameter and *one* of following parameters is required: * `id` *
130-
* `internal_id` * `transaction_code` * `foreign_transaction_id` * `client_transaction_id`
143+
* identified by a query parameter and *one* of following parameters is required: - `id` -
144+
* `internal_id` - `transaction_code` - `foreign_transaction_id` - `client_transaction_id`
131145
*
132146
* <p>Operation ID: GetTransactionV2.1
133147
*
@@ -147,8 +161,8 @@ public CompletableFuture<com.sumup.sdk.models.TransactionFull> getTransactionV21
147161
* Retrieve a transaction
148162
*
149163
* <p>Retrieves the full details of an identified transaction. The transaction resource is
150-
* identified by a query parameter and *one* of following parameters is required: * `id` *
151-
* `internal_id` * `transaction_code` * `foreign_transaction_id` * `client_transaction_id`
164+
* identified by a query parameter and *one* of following parameters is required: - `id` -
165+
* `internal_id` - `transaction_code` - `foreign_transaction_id` - `client_transaction_id`
152166
*
153167
* <p>Operation ID: GetTransactionV2.1
154168
*

0 commit comments

Comments
 (0)