Multiple accounts support

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.

Transaction API: Payment method support for Samsung Pay

Application API: JSON Contract

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

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

Settlement API: Interchange and scheme fees

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.

Transaction API: RRN

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.

Rate Limiting

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.

Transaction API: Settlement information on authorizations

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.

OAuth Client registration

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.

Application API: New modifiers in APQL

Add support for additional modifiers in AQPL.

See https://developer.clearhaus.com/merchant-api/apql.