mollie-api-typescript 1.12.1 → 1.12.3

package/dist/esm/models/paymentdetails.d.ts

@@ -0,0 +1,367 @@
+import * as z from "zod/v3";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { RFCDate } from "../types/rfcdate.js";
+import { Amount } from "./amount.js";
+import { AmountNullable } from "./amountnullable.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import { PaymentDetailsCardAuditionResponse } from "./paymentdetailscardauditionresponse.js";
+import { PaymentDetailsCardFundingResponse } from "./paymentdetailscardfundingresponse.js";
+import { PaymentDetailsCardLabelResponse } from "./paymentdetailscardlabelresponse.js";
+import { PaymentDetailsCardSecurityResponse } from "./paymentdetailscardsecurityresponse.js";
+import { PaymentDetailsFailureReasonResponse } from "./paymentdetailsfailurereasonresponse.js";
+import { PaymentDetailsFeeRegionResponse } from "./paymentdetailsfeeregionresponse.js";
+import { PaymentDetailsReceiptCardReadMethodResponse } from "./paymentdetailsreceiptcardreadmethodresponse.js";
+import { PaymentDetailsReceiptCardVerificationMethodResponse } from "./paymentdetailsreceiptcardverificationmethodresponse.js";
+import { PaymentDetailsSellerProtectionResponse } from "./paymentdetailssellerprotectionresponse.js";
+import { PaymentDetailsWalletResponse } from "./paymentdetailswalletresponse.js";
+/**
+ * The Point of sale receipt object.
+ *
+ * @remarks
+ *
+ * * `authorizationCode` _string|null_ - a unique code provided by the cardholder's bank to confirm that the
+ *   transaction was successfully approved.
+ * * `applicationIdentifier` _string|null_ - the unique number that identifies a specific payment application
+ *   on a chip card.
+ * * `cardReadMethod` _string|null_ - the method by which the card was read by the terminal. Possible values:
+ *   `chip` | `magnetic-stripe` | `near-field-communication` | `contactless` | `moto`.
+ * * `cardVerificationMethod` _string|null_ - the method used to verify the cardholder's identity. Possible
+ *   values: `no-cvm-required` | `online-pin` | `offline-pin` | `consumer-device` | `signature` |
+ *   `signature-and-online-pin` | `online-pin-and-signature` | `none` | `failed`.
+ */
+export type Receipt = {
+    /**
+     * A unique code provided by the cardholder's bank to confirm that the transaction was successfully approved.
+     */
+    authorizationCode?: string | null | undefined;
+    /**
+     * The unique number that identifies a specific payment application on a chip card.
+     */
+    applicationIdentifier?: string | null | undefined;
+    /**
+     * The method by which the card was read by the terminal.
+     */
+    cardReadMethod?: PaymentDetailsReceiptCardReadMethodResponse | null | undefined;
+    /**
+     * The method used to verify the cardholder's identity.
+     */
+    cardVerificationMethod?: PaymentDetailsReceiptCardVerificationMethodResponse | null | undefined;
+};
+/**
+ * **Optional include.** If a QR code was requested during payment creation for a QR-compatible payment method,
+ *
+ * @remarks
+ * the QR code details will be available in this object.
+ *
+ * The QR code can be scanned by the customer to complete the payment on their mobile device. For example,
+ * Bancontact QR payments can be completed by the customer using the Bancontact app.
+ *
+ * * `height` _integer_
+ * * `width` _integer_
+ * * `src` _string_
+ */
+export type PaymentDetailsQrCode = {
+    /**
+     * The height of the QR code image in pixels.
+     */
+    height?: number | undefined;
+    /**
+     * The width of the QR code image in pixels.
+     */
+    width?: number | undefined;
+    /**
+     * The URL to the QR code image.
+     */
+    src?: string | undefined;
+};
+/**
+ * An object containing payment details collected during the payment process. For example, details may include the
+ *
+ * @remarks
+ * customer's card or bank details and a payment reference. For the full list of details, please refer to the
+ * [method-specific parameters](extra-payment-parameters) guide.
+ */
+export type PaymentDetails = {
+    /**
+     * The customer's name, if made available by the payment method. For card payments, refer to `details.cardHolder`.
+     */
+    consumerName?: string | null | undefined;
+    /**
+     * The customer's account reference.
+     *
+     * @remarks
+     *
+     * For banking-based payment methods — such as iDEAL — this is normally either an IBAN or a domestic bank
+     * account number.
+     *
+     * For PayPal, the account reference is an email address.
+     *
+     * For card and Bancontact payments, refer to `details.cardNumber`.
+     */
+    consumerAccount?: string | null | undefined;
+    /**
+     * The BIC of the customer's bank account, if applicable.
+     */
+    consumerBic?: string | null | undefined;
+    /**
+     * For wallet payment methods — such as Apple Pay and PayPal — the shipping address is often already known by
+     *
+     * @remarks
+     * the wallet provider. In these cases the shipping address may be available as a payment detail.
+     */
+    shippingAddress?: {
+        [k: string]: any;
+    } | null | undefined;
+    /**
+     * The customer's masked card number.
+     */
+    cardNumber?: string | null | undefined;
+    /**
+     * The name of the bank that the customer will need to make the bank transfer payment towards.
+     */
+    bankName?: string | undefined;
+    /**
+     * The bank account number the customer will need to make the bank transfer payment towards.
+     */
+    bankAccount?: string | undefined;
+    /**
+     * The BIC of the bank the customer will need to make the bank transfer payment towards.
+     */
+    bankBic?: string | undefined;
+    /**
+     * The Mollie-generated reference the customer needs to use when transfering the amount. Do not apply any
+     *
+     * @remarks
+     * formatting here; show it to the customer as-is.
+     */
+    transferReference?: string | null | undefined;
+    /**
+     * Bizum payment reference of the transaction.
+     */
+    bizumReference?: string | null | undefined;
+    /**
+     * A unique fingerprint for this specific card. Can be used to identify returning customers.
+     */
+    cardFingerprint?: string | null | undefined;
+    /**
+     * The customer's name as shown on their card.
+     */
+    cardHolder?: string | null | undefined;
+    /**
+     * The card's target audience, if known.
+     */
+    cardAudience?: PaymentDetailsCardAuditionResponse | null | undefined;
+    /**
+     * The card's label, if known.
+     */
+    cardLabel?: PaymentDetailsCardLabelResponse | null | undefined;
+    /**
+     * The ISO 3166-1 alpha-2 country code of the country the card was issued in.
+     */
+    cardCountryCode?: string | null | undefined;
+    /**
+     * The expiry date (`MM/YY`) of the card as displayed on the card.
+     */
+    cardExpiryDate?: string | null | undefined;
+    /**
+     * The card type.
+     */
+    cardFunding?: PaymentDetailsCardFundingResponse | null | undefined;
+    /**
+     * The level of security applied during card processing.
+     */
+    cardSecurity?: PaymentDetailsCardSecurityResponse | null | undefined;
+    /**
+     * The applicable card fee region.
+     */
+    feeRegion?: PaymentDetailsFeeRegionResponse | null | undefined;
+    /**
+     * The first6 and last4 digits of the card number.
+     */
+    cardMaskedNumber?: string | null | undefined;
+    /**
+     * The outcome of authentication attempted on transactions enforced by 3DS (ie valid only for `oneoff` and `first`).
+     */
+    card3dsEci?: string | null | undefined;
+    /**
+     * The first6 digit of the card bank identification number.
+     */
+    cardBin?: string | null | undefined;
+    /**
+     * The issuer of the Card.
+     */
+    cardIssuer?: string | null | undefined;
+    /**
+     * A failure code to help understand why the payment failed.
+     */
+    failureReason?: PaymentDetailsFailureReasonResponse | null | undefined;
+    /**
+     * A human-friendly failure message that can be shown to the customer. The message is translated in accordance
+     *
+     * @remarks
+     * with the payment's locale setting.
+     */
+    failureMessage?: string | null | undefined;
+    /**
+     * The wallet used when creating the payment.
+     */
+    wallet?: PaymentDetailsWalletResponse | null | undefined;
+    /**
+     * Multibanco payment reference of the transaction.
+     */
+    multibancoReference?: string | null | undefined;
+    /**
+     * Multibanco entity reference of the transaction.
+     */
+    multibancoEntity?: string | null | undefined;
+    /**
+     * PayPal's reference for the payment.
+     */
+    paypalReference?: string | null | undefined;
+    /**
+     * ID of the customer's PayPal account.
+     */
+    paypalPayerId?: string | null | undefined;
+    /**
+     * Indicates to what extent the payment is eligible for PayPal's Seller Protection. Only available for PayPal
+     *
+     * @remarks
+     * payments, and if the information is made available by PayPal.
+     */
+    sellerProtection?: PaymentDetailsSellerProtectionResponse | null | undefined;
+    /**
+     * In v2 endpoints, monetary amounts are represented as objects with a `currency` and `value` field.
+     */
+    paypalFee?: AmountNullable | null | undefined;
+    /**
+     * The paysafecard customer reference either provided via the API or otherwise auto-generated by Mollie.
+     */
+    customerReference?: string | undefined;
+    /**
+     * The ID of the terminal device where the payment took place on.
+     */
+    terminalId?: string | undefined;
+    /**
+     * The first 6 digits & last 4 digits of the customer's masked card number.
+     */
+    maskedNumber?: string | null | undefined;
+    /**
+     * The Point of sale receipt object.
+     *
+     * @remarks
+     *
+     * * `authorizationCode` _string|null_ - a unique code provided by the cardholder's bank to confirm that the
+     *   transaction was successfully approved.
+     * * `applicationIdentifier` _string|null_ - the unique number that identifies a specific payment application
+     *   on a chip card.
+     * * `cardReadMethod` _string|null_ - the method by which the card was read by the terminal. Possible values:
+     *   `chip` | `magnetic-stripe` | `near-field-communication` | `contactless` | `moto`.
+     * * `cardVerificationMethod` _string|null_ - the method used to verify the cardholder's identity. Possible
+     *   values: `no-cvm-required` | `online-pin` | `offline-pin` | `consumer-device` | `signature` |
+     *   `signature-and-online-pin` | `online-pin-and-signature` | `none` | `failed`.
+     */
+    receipt?: Receipt | undefined;
+    /**
+     * The creditor identifier indicates who is authorized to execute the payment. In this case, it is a reference
+     *
+     * @remarks
+     * to Mollie.
+     */
+    creditorIdentifier?: string | null | undefined;
+    /**
+     * Estimated date the payment is debited from the customer's bank account, in `YYYY-MM-DD` format.
+     */
+    dueDate?: RFCDate | null | undefined;
+    /**
+     * Date the payment has been signed by the customer, in `YYYY-MM-DD` format. Only available if the payment has
+     *
+     * @remarks
+     * been signed.
+     */
+    signatureDate?: RFCDate | null | undefined;
+    /**
+     * The official reason why this payment has failed. A detailed description of each reason is available on the
+     *
+     * @remarks
+     * website of the European Payments Council.
+     */
+    bankReasonCode?: string | null | undefined;
+    /**
+     * A human-friendly description of the failure reason.
+     */
+    bankReason?: string | null | undefined;
+    /**
+     * The end-to-end identifier you provided in the batch file.
+     */
+    endToEndIdentifier?: string | null | undefined;
+    /**
+     * The mandate reference you provided in the batch file.
+     */
+    mandateReference?: string | null | undefined;
+    /**
+     * The batch reference you provided in the batch file.
+     */
+    batchReference?: string | null | undefined;
+    /**
+     * The file reference you provided in the batch file.
+     */
+    fileReference?: string | null | undefined;
+    /**
+     * **Optional include.** If a QR code was requested during payment creation for a QR-compatible payment method,
+     *
+     * @remarks
+     * the QR code details will be available in this object.
+     *
+     * The QR code can be scanned by the customer to complete the payment on their mobile device. For example,
+     * Bancontact QR payments can be completed by the customer using the Bancontact app.
+     *
+     * * `height` _integer_
+     * * `width` _integer_
+     * * `src` _string_
+     */
+    qrCode?: PaymentDetailsQrCode | undefined;
+    /**
+     * For payments with gift cards: the masked gift card number of the first gift card applied to the payment.
+     */
+    voucherNumber?: string | undefined;
+    /**
+     * An array of detail objects for each gift card that was used on this payment, if any.
+     */
+    giftcards?: Array<{
+        [k: string]: any;
+    }> | undefined;
+    /**
+     * For payments with vouchers: the brand name of the first voucher applied.
+     */
+    issuer?: string | undefined;
+    /**
+     * An array of detail objects for each voucher that was used on this payment, if any.
+     */
+    vouchers?: Array<{
+        [k: string]: any;
+    }> | undefined;
+    /**
+     * In v2 endpoints, monetary amounts are represented as objects with a `currency` and `value` field.
+     */
+    remainderAmount?: Amount | undefined;
+    /**
+     * The payment method used to pay the remainder amount, after all gift cards or vouchers were applied.
+     */
+    remainderMethod?: string | undefined;
+    /**
+     * **Optional include.** The full payment method details of the remainder payment.
+     */
+    remainderDetails?: {
+        [k: string]: any;
+    } | undefined;
+};
+/** @internal */
+export declare const Receipt$inboundSchema: z.ZodType<Receipt, z.ZodTypeDef, unknown>;
+export declare function receiptFromJSON(jsonString: string): SafeParseResult<Receipt, SDKValidationError>;
+/** @internal */
+export declare const PaymentDetailsQrCode$inboundSchema: z.ZodType<PaymentDetailsQrCode, z.ZodTypeDef, unknown>;
+export declare function paymentDetailsQrCodeFromJSON(jsonString: string): SafeParseResult<PaymentDetailsQrCode, SDKValidationError>;
+/** @internal */
+export declare const PaymentDetails$inboundSchema: z.ZodType<PaymentDetails, z.ZodTypeDef, unknown>;
+export declare function paymentDetailsFromJSON(jsonString: string): SafeParseResult<PaymentDetails, SDKValidationError>;
+//# sourceMappingURL=paymentdetails.d.ts.map

package/dist/esm/models/paymentdetails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymentdetails.d.ts","sourceRoot":"","sources":["../../../src/models/paymentdetails.ts"],"names":[],"mappings":"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"}

package/dist/esm/models/paymentdetails.js

@@ -0,0 +1,105 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 45ee14e5d815
+ */
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { RFCDate } from "../types/rfcdate.js";
+import { Amount$inboundSchema } from "./amount.js";
+import { AmountNullable$inboundSchema, } from "./amountnullable.js";
+import { PaymentDetailsCardAuditionResponse$inboundSchema, } from "./paymentdetailscardauditionresponse.js";
+import { PaymentDetailsCardFundingResponse$inboundSchema, } from "./paymentdetailscardfundingresponse.js";
+import { PaymentDetailsCardLabelResponse$inboundSchema, } from "./paymentdetailscardlabelresponse.js";
+import { PaymentDetailsCardSecurityResponse$inboundSchema, } from "./paymentdetailscardsecurityresponse.js";
+import { PaymentDetailsFailureReasonResponse$inboundSchema, } from "./paymentdetailsfailurereasonresponse.js";
+import { PaymentDetailsFeeRegionResponse$inboundSchema, } from "./paymentdetailsfeeregionresponse.js";
+import { PaymentDetailsReceiptCardReadMethodResponse$inboundSchema, } from "./paymentdetailsreceiptcardreadmethodresponse.js";
+import { PaymentDetailsReceiptCardVerificationMethodResponse$inboundSchema, } from "./paymentdetailsreceiptcardverificationmethodresponse.js";
+import { PaymentDetailsSellerProtectionResponse$inboundSchema, } from "./paymentdetailssellerprotectionresponse.js";
+import { PaymentDetailsWalletResponse$inboundSchema, } from "./paymentdetailswalletresponse.js";
+/** @internal */
+export const Receipt$inboundSchema = z.object({
+    authorizationCode: z.nullable(z.string()).optional(),
+    applicationIdentifier: z.nullable(z.string()).optional(),
+    cardReadMethod: z.nullable(PaymentDetailsReceiptCardReadMethodResponse$inboundSchema).optional(),
+    cardVerificationMethod: z.nullable(PaymentDetailsReceiptCardVerificationMethodResponse$inboundSchema).optional(),
+});
+export function receiptFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => Receipt$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'Receipt' from JSON`);
+}
+/** @internal */
+export const PaymentDetailsQrCode$inboundSchema = z.object({
+    height: z.number().int().optional(),
+    width: z.number().int().optional(),
+    src: z.string().optional(),
+});
+export function paymentDetailsQrCodeFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => PaymentDetailsQrCode$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'PaymentDetailsQrCode' from JSON`);
+}
+/** @internal */
+export const PaymentDetails$inboundSchema = z.object({
+    consumerName: z.nullable(z.string()).optional(),
+    consumerAccount: z.nullable(z.string()).optional(),
+    consumerBic: z.nullable(z.string()).optional(),
+    shippingAddress: z.nullable(z.record(z.any())).optional(),
+    cardNumber: z.nullable(z.string()).optional(),
+    bankName: z.string().optional(),
+    bankAccount: z.string().optional(),
+    bankBic: z.string().optional(),
+    transferReference: z.nullable(z.string()).optional(),
+    bizumReference: z.nullable(z.string()).optional(),
+    cardFingerprint: z.nullable(z.string()).optional(),
+    cardHolder: z.nullable(z.string()).optional(),
+    cardAudience: z.nullable(PaymentDetailsCardAuditionResponse$inboundSchema)
+        .optional(),
+    cardLabel: z.nullable(PaymentDetailsCardLabelResponse$inboundSchema)
+        .optional(),
+    cardCountryCode: z.nullable(z.string()).optional(),
+    cardExpiryDate: z.nullable(z.string()).optional(),
+    cardFunding: z.nullable(PaymentDetailsCardFundingResponse$inboundSchema)
+        .optional(),
+    cardSecurity: z.nullable(PaymentDetailsCardSecurityResponse$inboundSchema)
+        .optional(),
+    feeRegion: z.nullable(PaymentDetailsFeeRegionResponse$inboundSchema)
+        .optional(),
+    cardMaskedNumber: z.nullable(z.string()).optional(),
+    card3dsEci: z.nullable(z.string()).optional(),
+    cardBin: z.nullable(z.string()).optional(),
+    cardIssuer: z.nullable(z.string()).optional(),
+    failureReason: z.nullable(PaymentDetailsFailureReasonResponse$inboundSchema)
+        .optional(),
+    failureMessage: z.nullable(z.string()).optional(),
+    wallet: z.nullable(PaymentDetailsWalletResponse$inboundSchema).optional(),
+    multibancoReference: z.nullable(z.string()).optional(),
+    multibancoEntity: z.nullable(z.string()).optional(),
+    paypalReference: z.nullable(z.string()).optional(),
+    paypalPayerId: z.nullable(z.string()).optional(),
+    sellerProtection: z.nullable(PaymentDetailsSellerProtectionResponse$inboundSchema).optional(),
+    paypalFee: z.nullable(AmountNullable$inboundSchema).optional(),
+    customerReference: z.string().optional(),
+    terminalId: z.string().optional(),
+    maskedNumber: z.nullable(z.string()).optional(),
+    receipt: z.lazy(() => Receipt$inboundSchema).optional(),
+    creditorIdentifier: z.nullable(z.string()).optional(),
+    dueDate: z.nullable(z.string().transform(v => new RFCDate(v))).optional(),
+    signatureDate: z.nullable(z.string().transform(v => new RFCDate(v)))
+        .optional(),
+    bankReasonCode: z.nullable(z.string()).optional(),
+    bankReason: z.nullable(z.string()).optional(),
+    endToEndIdentifier: z.nullable(z.string()).optional(),
+    mandateReference: z.nullable(z.string()).optional(),
+    batchReference: z.nullable(z.string()).optional(),
+    fileReference: z.nullable(z.string()).optional(),
+    qrCode: z.lazy(() => PaymentDetailsQrCode$inboundSchema).optional(),
+    voucherNumber: z.string().optional(),
+    giftcards: z.array(z.record(z.any())).optional(),
+    issuer: z.string().optional(),
+    vouchers: z.array(z.record(z.any())).optional(),
+    remainderAmount: Amount$inboundSchema.optional(),
+    remainderMethod: z.string().optional(),
+    remainderDetails: z.record(z.any()).optional(),
+});
+export function paymentDetailsFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => PaymentDetails$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'PaymentDetails' from JSON`);
+}
+//# sourceMappingURL=paymentdetails.js.map

package/dist/esm/models/paymentdetails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymentdetails.js","sourceRoot":"","sources":["../../../src/models/paymentdetails.ts"],"names":[],"mappings":"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"}

package/dist/esm/models/paymentrequest.d.ts

@@ -204,11 +204,16 @@ export type PaymentRequestApplicationFee = {
     description?: string | undefined;
 };
 /**
- * Billie is a business-to-business (B2B) payment method. It requires extra information to identify the organization
+ * Billie is a business-to-business (B2B) payment method. It requires extra information to identify the
  *
  * @remarks
- * that is completing the payment. It is recommended to include these parameters up front for a seamless flow.
- * Otherwise, Billie will ask the customer to complete the missing fields during checkout.
+ * organization that is completing the payment. It is recommended to include these parameters up front for a
+ * seamless flow. Otherwise, Billie will ask the customer to complete the missing fields during checkout.
+ *
+ * * `billingAddress.organizationName`: The organization's name.
+ * * `registrationNumber` _string_: The organization's registration number.
+ * * `vatNumber` _string_: The organization's VAT number.
+ * * `entityType` _string_: The organization's entity type.
  */
 export type Company = {
     /**
@@ -432,7 +437,19 @@ export type PaymentRequest = {
      */
     profileId?: string | undefined;
     /**
-     * The date by which the payment should be completed in `YYYY-MM-DD` format
+     * The date the bank transfer payment should expire, in `YYYY-MM-DD` format. The minimum date is tomorrow, and the
+     *
+     * @remarks
+     * maximum date is 100 days after tomorrow.
+     *
+     * After you created the payment, you can still update the `dueDate` via [Update payment](update-payment).
+     *
+     * <Callout icon="📘" theme="info">
+     *   If `dueDate` falls out of business days, it will be set to the **next business day** and the payment will
+     *   expire at 00:00 (on the following business day).
+     *   Example: `dueDate` is `2025-12-06` (Saturday) -> `dueDate` will be set for `2025-12-08`, `expiresAt`
+     *   `2025-12-09 00:00`
+     * </Callout>
      */
     dueDate?: string | undefined;
     /**
@@ -453,45 +470,52 @@ export type PaymentRequest = {
      */
     testmode?: boolean | null | undefined;
     /**
-     * The Apple Pay Payment token object (encoded as JSON) that is part of the result of authorizing a payment request.
+     * The [Apple Pay Payment](https://developer.apple.com/documentation/apple_pay_on_the_web/applepaypayment) token
      *
      * @remarks
-     * The token contains the payment information needed to authorize the payment.
+     * object (encoded as JSON) that is part of the result of authorizing a payment request. The token contains the
+     * payment information needed to authorize the payment.
      *
-     * The object should be passed encoded in a JSON string.
+     * The object should be passed encoded in a JSON string. For example:
+     * `{"paymentData": {"version": "EC_v1", "data": "vK3BbrCbI/...."}}`
      */
     applePayPaymentToken?: string | undefined;
     /**
-     * Billie is a business-to-business (B2B) payment method. It requires extra information to identify the organization
+     * Billie is a business-to-business (B2B) payment method. It requires extra information to identify the
      *
      * @remarks
-     * that is completing the payment. It is recommended to include these parameters up front for a seamless flow.
-     * Otherwise, Billie will ask the customer to complete the missing fields during checkout.
+     * organization that is completing the payment. It is recommended to include these parameters up front for a
+     * seamless flow. Otherwise, Billie will ask the customer to complete the missing fields during checkout.
+     *
+     * * `billingAddress.organizationName`: The organization's name.
+     * * `registrationNumber` _string_: The organization's registration number.
+     * * `vatNumber` _string_: The organization's VAT number.
+     * * `entityType` _string_: The organization's entity type.
      */
     company?: Company | undefined;
     /**
-     * When creating credit card payments using Mollie Components, you need to provide the card token you received from
+     * When creating credit card payments using Mollie Components, you need to provide the card token you received
      *
      * @remarks
-     * the card component in this field. The token represents the customer's card information needed to complete the
-     * payment. Note: field only valid for oneoff and first payments. For recurring payments, the customerId alone is
-     * enough.
+     * from the card component in this field. The token represents the customer's card information needed to complete
+     * the payment. **Note:** field only valid for `oneoff` and `first` payments. For recurring payments, the
+     * `customerId` alone is enough.
      */
     cardToken?: string | undefined;
     /**
-     * The Google Pay payment token object (encoded as JSON) returned by the Google Pay SDK after the customer authorizes
+     * The Google Pay payment token object (encoded as JSON) returned by the Google Pay SDK after the customer
      *
      * @remarks
-     * the payment. The token contains the payment information needed to complete the payment.
+     * authorizes the payment. The token contains the payment information needed to complete the payment.
      *
      * The object should be passed encoded in a JSON string.
      */
     googlePayPaymentToken?: string | undefined;
     /**
-     * The card token you received from the card component of Mollie Components. The token represents the customer's card
+     * The card token you received from the card component of Mollie Components. The token represents the customer's
      *
      * @remarks
-     * information needed to complete the payment.
+     * card information needed to complete the payment.
      */
     voucherNumber?: string | undefined;
     /**
@@ -499,10 +523,10 @@ export type PaymentRequest = {
      */
     voucherPin?: string | undefined;
     /**
-     * The customer's date of birth. If not provided via the API, iDeal in3 will ask the customer to provide it during
+     * The customer's date of birth. If not provided via the API, iDeal in3 will ask the customer to provide it
      *
      * @remarks
-     * the payment process.
+     * during the payment process.
      */
     consumerDateOfBirth?: RFCDate | undefined;
     /**
@@ -510,7 +534,11 @@ export type PaymentRequest = {
      *
      * @remarks
      * You can submit your extra data in this field if you have agreed upon this with Klarna. This field should be an
-     * object containing any of the allowed keys and sub-objects described at the Klarna Developer Documentation.
+     * object containing any of the allowed keys and sub-objects described at the
+     * <Anchor label="Klarna Developer Documentation" target="_blank" href="https://docs.klarna.com/acquirer/mollie/api/extra-merchant-data/">Klarna Developer Documentation</Anchor>.
+     *
+     * Reach out to your account manager at Mollie to enable this feature with Klarna, and to agree on which fields
+     * you can send.
      */
     extraMerchantData?: {
         [k: string]: any;
@@ -523,21 +551,28 @@ export type PaymentRequest = {
      */
     sessionId?: string | undefined;
     /**
-     * Indicate if you are about to deliver digital goods, such as for example a software license. Setting this parameter
+     * Indicate if you are about to deliver digital goods, such as for example a software license. Setting this
      *
      * @remarks
-     * can have consequences for your PayPal Seller Protection. Refer to PayPal's documentation for more information.
+     * parameter can have consequences for your PayPal Seller Protection. Refer to
+     * [PayPal's documentation](https://www.paypal.com/us/webapps/mpp/ua/seller-protection) for more information.
      */
     digitalGoods?: boolean | undefined;
     /**
-     * Used by paysafecard for customer identification across payments. When you generate a customer reference yourself,
+     * Used by paysafecard for customer identification across payments. When you generate a customer reference
      *
      * @remarks
-     * make sure not to put personal identifiable information or IP addresses in the customer reference directly.
+     * yourself, make sure not to put personal identifiable information or IP addresses in the customer reference
+     * directly.
+     *
+     * If not provided, Mollie will use a hashed version of the customer's IP address.
      */
     customerReference?: string | undefined;
     /**
-     * The ID of the terminal device where you want to initiate the payment on.
+     * The ID of the terminal device where you want to initiate the payment on. See also the
+     *
+     * @remarks
+     * [Terminals API](ref:terminals-api).
      */
     terminalId?: string | undefined;
 };