Checkout.com APIs accept and return JSON in the HTTP body, and return standard HTTP response codes.
Our API reference is written using the OpenAPI specification. We have one spec for the current account structure and one for the new account structure. Merchants can download the specs using the download button on either version of the API reference.
The API reference is hosted on Vercel.
Append /previous
to all links (including preview ones) for the ABC API reference.
Most teams write the spec before building out the functionality. The preferred way to contribute is using our GitHub workflow, which means you just have to edit the spec on your own GitHub organisation instead of editing directly on this one.
If you fork this repo to edit your spec, you will need to:
- Install the dependencies using
npm i
- Run
npm run start
to view your changes on http://localhost:3001.
When you raise a PR, it will automatically tag the Docs Admin team, of which the Tech Writing team are members.
A PR review from this team is required before any changes can be merged into master
. However, you'll still need approval from a relevant product manager before the changes are accepted.
If you need help, ask in the #ask-docs Slack channel.
Use the appropriate directory (or directories) for your change to the ABC or NAS specification(s).
To run this project locally, clone the repository and run these commands in sequence:
npm i
npm run build:all
- OR
npm run build:abc
- OR
npm run build:nas
- OR
npm run start
The project should then be available at port 3001 (navigate to localhost:3001
in your browser), for example:
localhost:3001/previous
(ABC)localhost:3001
(NAS)