Add update and delete methods to PaymentLinksBinder

Introduces `update` and `delete` methods for managing payment links, aligning with Mollie's API capabilities. Additionally, extends `CreateParameters` and introduces `UpdateParameters` to support new fields like `minimumAmount`, `archived`, and `allowedMethods`. Updates `PaymentLinkData` to include reusable and archived properties.

Author: TimmyGuy

src/binders/paymentLinks/PaymentLinksBinder.ts

@@ -6,7 +6,13 @@ import assertWellFormedId from '../../plumbing/assertWellFormedId';
 import renege from '../../plumbing/renege';
 import type Callback from '../../types/Callback';
 import Binder from '../Binder';
-import { type CreateParameters, type GetParameters, type IterateParameters, type PageParameters } from './parameters';
+import {
+  type CreateParameters,
+  type GetParameters,
+  type IterateParameters,
+  type PageParameters,
+  type UpdateParameters,
+} from './parameters';
 
 const pathSegment = 'payment-links';
 
@@ -68,4 +74,30 @@ export default class PaymentsLinksBinder extends Binder<PaymentLinkData, Payment
     const { valuesPerMinute, ...query } = parameters ?? {};
     return this.networkClient.iterate<PaymentLinkData, PaymentLink>(pathSegment, 'payment_links', query, valuesPerMinute);
   }
+
+  /**
+   * Update a payment link object by its token.
+   *
+   * @see https://docs.mollie.com/reference/update-payment-link
+   */
+  public update(id: string, parameters: Partial<UpdateParameters>): Promise<PaymentLink>;
+  public update(id: string, parameters: Partial<UpdateParameters>, callback: Callback<PaymentLink>): void;
+  public update(id: string, parameters: Partial<UpdateParameters>) {
+    if (renege(this, this.update, ...arguments)) return;
+    assertWellFormedId(id, 'payment-link');
+    return this.networkClient.patch<PaymentLinkData, PaymentLink>(`${pathSegment}/${id}`, parameters);
+  }
+
+  /**
+   * Delete a payment link object by its token.
+   *
+   * @see https://docs.mollie.com/reference/delete-payment-link
+   */
+  public delete(id: string): Promise<true>;
+  public delete(id: string, callback: Callback<true>): void;
+  public delete(id: string) {
+    if (renege(this, this.delete, ...arguments)) return;
+    assertWellFormedId(id, 'payment-link');
+    return this.networkClient.delete<PaymentLinkData, true>(`${pathSegment}/${id}`);
+  }
 }

src/binders/paymentLinks/parameters.ts

@@ -1,7 +1,7 @@
 import { type PaymentLinkData } from '../../data/paymentLinks/data';
 import { type IdempotencyParameter, type PaginationParameters, type ThrottlingParameter } from '../../types/parameters';
 
-export type CreateParameters = Pick<PaymentLinkData, 'description' | 'amount' | 'redirectUrl' | 'webhookUrl' | 'expiresAt'> & {
+export type CreateParameters = Pick<PaymentLinkData, 'description' | 'amount' | 'minimumAmount' | 'redirectUrl' | 'webhookUrl' | 'reusable' | 'expiresAt' | 'allowedMethods'> & {
   profileId?: string;
   testmode?: boolean;
 } & IdempotencyParameter;
@@ -15,4 +15,9 @@ export type PageParameters = PaginationParameters & {
   testmode?: boolean;
 };
 
+export type UpdateParameters = Pick<PaymentLinkData, 'description' | 'minimumAmount' | 'archived' | 'allowedMethods'> & {
+  profileId?: string;
+  testmode?: boolean;
+};
+
 export type IterateParameters = Omit<PageParameters, 'limit'> & ThrottlingParameter;

src/data/paymentLinks/data.ts

@@ -1,4 +1,4 @@
-import { type Amount, type ApiMode, type Links, type Url } from '../global';
+import { type Amount, type ApiMode, type Links, PaymentMethod, type Url } from '../global';
 import type Model from '../Model';
 
 export interface PaymentLinkData extends Model<'payment-link'> {
@@ -28,7 +28,19 @@ export interface PaymentLinkData extends Model<'payment-link'> {
    *
    * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=amount#response
    */
-  amount: Amount;
+  amount?: Amount;
+  /**
+   * The minimum amount of the payment link. This property is only allowed when there is no amount provided.
+   *
+   * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=minimumAmount#response
+   */
+  minimumAmount?: Amount;
+  /**
+   * Whether the payment link is archived
+   *
+   * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=archived#response
+   */
+  archived: boolean;
   /**
    * The URL your customer will be redirected to after completing the payment process.
    *
@@ -41,6 +53,13 @@ export interface PaymentLinkData extends Model<'payment-link'> {
    * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=redirectUrl#response
    */
   webhookUrl?: string;
+  /**
+   * Indicates whether the payment link is reusable. If this field is set to true, customers can make multiple payments using the same link.
+   *
+   * @default false
+   * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=reusable#response
+   */
+  reusable?: boolean;
   /**
    * The payment link's date and time of creation, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    *
@@ -65,5 +84,11 @@ export interface PaymentLinkData extends Model<'payment-link'> {
    * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=expiresAt#response
    */
   expiresAt?: string;
+  /**
+   * The expiry date and time of the payment link, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+   *
+   * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=allowedMethods#response
+   */
+  allowedMethods?: PaymentMethod[];
   _links: Links & { paymentLink: Url };
 }