com.adgoji.mollie.api — com.adgoji/mollie 0.3.4

cancel-payment-by-id clj

(cancel-payment-by-id client payment-id)

Cancel a single payment by payment-id.

cancel-subscription-by-id clj

(cancel-subscription-by-id client customer-id subscription-id)

Cancel a single customer's subscription by subscription-id.

create-customer clj

(create-customer client customer)

Create a new Mollie customer.

Customer can be used for Mollie checkout and recurring features. All customer keys are optional.

Example:

(mollie.api/create-customer mollie-client {})

create-mandate clj

(create-mandate client customer-id mandate)

Create a new mandate for a given customer-id.

A mandate essentially symbolizes the authorization a customer gave you to recurrently charge their card or bank account.

Example:

(mollie.api/create-mandate
  mollie-client
  {:method :directdebit
   :consumer-name "Test Customer"
   :consumer-account "NL55INGB0000000000"})

Creating a mandate explicitly is not strictly required to process recurring payments. In basic implementations it suffices to create-customer, do a first payment with the customer, and then charge recurring payments on the customer. A mandate is created automatically for the first payment, and that mandate is automatically used for any consecutive recurring payments.

create-payment clj

(create-payment client payment)

(create-payment client payment customer-id)

Create a new payment.

If customer-id is provided, create a new payment for customer. To create a recurring payment customer-id is mandatory.

For some reason it's not possible to create a recurring payment for customer by providing customer-id in the request body (Mollie returns an error that payment method is not enabled), but it can be created without any issues by providing customer-id as a path parameter (second arity).

Examples:

• create one-off payment

(mollie.api/create-payment
  mollie-client
  {:amount
    {:value 100.00M
     :currency "EUR"}
   :description "Mollie one-off payment"
   :redirect-url "https://example.com"})

• create first payment (customer is required)

(mollie.api/create-payment
  mollie-client
  {:amount
    {:value 100.00M
     :currency "EUR"}
   :description "First payment to start a subscription"
   :sequence-type :first
   :redirect-url "https://example.com"
   :customer-id "cus_123"})

• create recurring payment (mandate is required)

(mollie.api/create-payment
  mollie-client
  {:amount
    {:value 100.00M
     :currency "EUR"}
   :description "Next subscription payment"
   :sequence-type :recurring})

create-subscription clj

(create-subscription client customer-id subscription)

Create a new subscription for a given customer-id.

Subscription description should be unique.

Example:

(let [description (str "Test subscription" (random-uuid))]
  (mollie.api/create-subscription
    mollie-client
    {:amount
      {:value 100.00M
       :currency "EUR"}
     :interval "1 months"
     :description description}))

delete-customer-by-id clj

(delete-customer-by-id client customer-id)

Delete a single customer by customer-id.

get-customer-by-id clj

(get-customer-by-id client customer-id)

Fetch a single customer by customer-id.

get-customers-list clj

(get-customers-list client opts)

Fetch all customers.

get-mandate-by-id clj

(get-mandate-by-id client customer-id mandate-id)

Fetch a single customer's mandate by mandate-id.

get-mandates-list clj

(get-mandates-list client customer-id opts)

Fetch all customer's mandates.

get-payment-by-id clj

(get-payment-by-id client payment-id)

Fetch a single payment by payment-id.

get-payments-list clj

(get-payments-list client opts)

(get-payments-list client customer-id opts)

(get-payments-list client customer-id subscription-id opts)

Fetch all payments.

If customer-id is provided, fetch only payments for a given customer.

If customer-id and subscription-id are provided, fetch only payments for a given customer and a given subscription.

get-subscription-by-id clj

(get-subscription-by-id client customer-id subscription-id)

Fetch a single customer's subscription by subscription-id.

get-subscriptions-list clj

(get-subscriptions-list client opts)

(get-subscriptions-list client customer-id opts)

Fetch a list of subscriptions.

If customer-id is omitted, fetch all subscriptions for all customers.

new-client clj

(new-client params)

Create a new Mollie API client.

Parameters:

• :api-key required. Can be obtained from Mollie dashboard.
• :base-url optionally override base URL for Mollie API.
• :check-response? optional (default false). If true, all responses will be additionally checked against spec. An error will be thrown if response doesn't conform to a spec.
• :throw-exceptions? optional (default true). If true, throw an exception if HTTP status code from Mollie API is >= 400.

Example:

(def mollie-client
  (mollie.api/new-client
    {:api-key "string"
     :base-url "https://api.mollie.com"
     :check-response? true
     :throw-exceptions? false}))

revoke-mandate-by-id clj

(revoke-mandate-by-id client customer-id mandate-id)

Revoke a specific customer's mandate by mandate-id.

update-customer-by-id clj

(update-customer-by-id client customer-id data)

Update a single customer by customer-id.

update-payment-by-id clj

(update-payment-by-id client payment-id data)

Update a single payment by payment-id.

update-subscription-by-id clj

(update-subscription-by-id client customer-id subscription-id data)

Update a single customer's subscription by subscription-id.