Clearhaus changelog developer.clearhaus.com

From today, the Resource Owner Password Credentials Grant is only available for legacy integrations.

Since the introduction of the Client Credentials Grant the Resource Owner Password Credentials Grant has been deprecated. This is the beginning of phasing it out.

Migrating away from the Resource Owner Password Credentials Grant is done by registering a client while being logged in with the email and password used to perform the Resource Owner Password Credentials Grant. Then, change your authentication request to use the Client Credentials Grant with the new Client ID and Client Secret (see Supported grants for an example).

Add googlepay and vipps to the payment_method enum.

See https://developer.clearhaus.com/rels/transaction#properties and https://developer.clearhaus.com/merchant-api/tql/#payment-method.

The Record and Application resources have been updated to be consistent with support for multiple accounts in the context of a single Application.

Deprecations

Removal of deprecated properties and link relations will take effect from August 25, 2020.

Record Properties

• merchant_id
• mcc (replaced by mccs)
• states.contract (replaced by states.contracts)
• states.account (replaced by states.accounts)
• currencies will be converted from a set of currencies (["DKK", "EUR"]) to an object of currency counts ({ "DKK": 1, "EUR": 2 })

See https://developer.clearhaus.com/rels/record#properties.

Record and Application link relations

• ch:account (replaced by ch:accounts)
• ch:contract (replaced by ch:contracts)

See https://developer.clearhaus.com/rels/record#link-relations and https://developer.clearhaus.com/rels/application#link-relations.

Add samsungpay to the payment_method enum.

See https://developer.clearhaus.com/rels/transaction#properties and https://developer.clearhaus.com/merchant-api/tql/#payment-method.

Expand the JSON resource to achieve parity with the PDF resource.

See https://developer.clearhaus.com/rels/contract#properties.

Add fees.interchange and fees.scheme to settlement resource.

This feature will gradually roll out from March 1st.

NB: The fees are only relevant for Interchange+ merchants.

See https://developer.clearhaus.com/rels/settlement#properties.

Add Retrieval Reference Number to transaction resource.

This property is also supported by the transaction query language.

See https://developer.clearhaus.com/rels/transaction#properties and https://developer.clearhaus.com/merchant-api/tql/#identifiers.

Starting with the OAuth token endpoint on Wednesday January 15th 2020 the Merchant API will start enforcing rate limits.

The issued tokens are valid for 24 hours and it is best practice to make use of the expires_in property to take advantage of the lifetime of the token and avoid unnecessary calls to the OAuth2 token endpoint.

Given the growing interest in the Merchant API we will gradually extend rate limiting to other resources as the need arises.

See example access token response with expires_in at https://developer.clearhaus.com/merchant-api/start/#supported-grants.

Add support for settlement information on authorizations.

The properties amount_gross and amount_net will not be utilized as they are only relevant for captures, refunds and credits.

This feature will gradually roll out from December 10th.

See https://developer.clearhaus.com/rels/transaction#properties.

Add support for creating OAuth Clients in the Developer portal.

Previously client registration was made by request via support@clearhaus.com.

With this new functionality the Resource Owner Password Credentials Grant becomes deprecated and existing clients can be transitioned to the Client Credentials Grant.

See https://developer.clearhaus.com/merchant-api/start/#client-registration and https://developer.clearhaus.com/merchant-api/clients.