Skip to main content

Pact Contracts

Supported Pact Specification versions#


Compatibility with Provider Contracts#

Pact contracts may be used in the following situations:

Consumer ContractProvider Verification
PactOpenAPI (bi-directional)

Strategies to capture consumer contracts#

Transform mock files#

Some tools allow you to serialise their mocks to file. In this case, you can create a CLI tool to read the mock and transform it to Pact file. It is also common for teams to build custom mock servers using simply HTTP frameworks like ExpressJS with a set of JSON fixture files. One of the benefits of this approach is that if the mocking tool is used in multiple places and languages, you can reuse a single CLI tool.

Examples include Mountebank and Wiremock.


If you have your own custom mocking server, or want to test against a real environment periodically, a record/replay strategy could be a useful strategy.

Tools like VCR and Polly can record the actualy calls your application makes and story them as a fixture file for future use. This makes your tests reliable, but introduces the possibility of drift. Converting this mocks into a pact file reduces that possibility.

See our record/replay example for more.

API integration#

Most tools have language specific APIs you can use to introspect the actual calls made to the mocks, in order to review behaviour.

In this mode, you must be careful only to serialise the mocks that were invoked by the application.

See our Wiremock example for more.

Converting mocks into a Pact compatible format#

When converting your mocks into a pact file, take note of the following considerations:

  1. You must generate a Pact V2 specification compatible file.
  2. You should not include any matchers, unless you are confident in their application.
    • Matchers are currently ignored by the cross-contract validation process, but may be supported at a later date
  3. You should validate the pact file is correct prior to uploading to Pactflow. You can use the JSON schema below, or attempt to load it into a stub server.

Below is an pact file based off the Wiremock example project.

{  "consumer": { "name": "pactflow-example-consumer-wiremock" }, // The name of the consumer application  "provider": { "name": "pactflow-example-provider-restassured" }, // the name of the provider application  "interactions": [    {      "description": "POST_/products_f25f7b8e-35f2-4796-bebf-5f61d31d06b3", // Ideally a human readable description of the scenario, if possible      "request": {        "method": "POST",        "path": "/products",        "query": "foo=bar&baz=bat&bat=1&bat=2", // note array syntax is not supported for multiple query params (i.e. the bat param)        "body": { // this may be any valid JSON value such as a string or object          "id": "27",          "name": "pizza",          "type": "food",          "price": 27.0        },        "headers": { "Content-Type": "application/json" } // key/value pairs of expected headers      },      "response": {        "status": 200,        "headers": { "Content-Type": "application/json" },        "body": { "id": "27", "name": "pizza", "type": "food" }      }    }  ],  "metadata": {    "pactSpecification": { "version": "2.0.0" },    "client": { // These aren't mandatory, but are useful in      "name": "name of the adapter",      "version": "semver compatible version of the adapter"    }  }}

Pact JSON Schema#

You can use this JSON schema as a guide to validate your pact generation tool.