Skip to content

Latest commit

 

History

History
92 lines (61 loc) · 4.33 KB

README.md

File metadata and controls

92 lines (61 loc) · 4.33 KB
Raw

Mollie API Golang client

Actions

Testing Linter CodeQL

Go ecosystem

Go Reference Go Report Card OpenSSF Best Practices

Accepting iDEAL, Apple Pay, Bancontact, SOFORT Banking, Creditcard, SEPA Bank transfer, SEPA Direct debit, PayPal, Belfius Direct Net, KBC/CBC, paysafecard, Giftcards, Giropay, EPS and Przelewy24 online payments without fixed monthly costs or any punishing registration procedures. Just use the Mollie API to receive payments directly on your website or easily refund transactions to your customers.

Requirements

To use the Mollie API client, the following things are required:

  • Get yourself a free Mollie account. No sign up costs.
  • Now you're ready to use the Mollie API client in test mode.
  • Follow a few steps to enable payment methods in live mode, and let us handle the rest.
  • Up-to-date OpenSSL (or other SSL/TLS toolkit)

For leveraging Mollie Connect (advanced use cases only), it is recommended to be familiar with the OAuth2 protocol.

Install

go get -u github.com/VictorAvelar/mollie-api-go/v4/mollie

Usage

Testing using API tokens

Using the config helper

// Create a configuration object with idempotency enabled.
config := mollie.NewAPITestingConfig(true)

Using the NewConfig method

// Create a configuration object with idempotency enabled.
config := mollie.NewConfig(true, mollie.ApiTokenEnv)

_ := config.ToggleIdempotency()

Testing using Organization access tokens

Using the config helper for org tokens

// Create a configuration object with idempotency enabled.
config := mollie.NewOrgTestingConfig(true)

Using the NewConfig method for org tokens

// Create a configuration object with idempotency enabled.
config := mollie.NewConfig(true, mollie.OrgTokenEnv)

_ := config.ToggleIdempotency()

Create an API client

// build your desired config
client, err := mollie.NewClient(config)
if err != nil {
    log.Fatal(err)
}
// perform operations with the API.

Upgrade guide

  • If you want to upgrade from v2 -> v3, the list of breaking and notable changes can be found in the docs.
  • If you want to upgrade from v3 -> v4, the list of breaking and notable changes can be found in the docs.

API parity

Checks to the API changelog are performed constantly to ensure API parity and compatibility, however it might happen that not all the changes are implemented right away.

For checking all the related tasks you can check the issues labeled with the API parity label.