Installation

POST https://install.sandbox-checkout.payjustnow.io/v2

In order to use the checkout gateway you first need to configure your settings by performing a POST on the installation endpoint.

On successful installation you will receive back a generated secret signing key.

The OpenAPI specification for this operation can be found here.

note

The authentication headers are not required on this call as there will be no secret signing key for your account yet.

Here is an example of a successful gateway installation request and response:

    POST /v2 HTTP/1.1    Content-Type: application/json    User-Agent: PostmanRuntime/7.32.2    Accept: */*    Host: install.sandbox-checkout.payjustnow.io    Accept-Encoding: gzip, deflate, br    Connection: keep-alive    Content-Length: 307        {        "merchantAccountId": "1",        "merchantAccountApiKey": "secret",        "checkoutStatusCallbackUrl": "https://1ce00205-499c-422f-a8ea-05d3856d5cf3.mock.pstmn.io",        "callbackFailuresEmail": "[email protected]",        "minimumCheckoutAmountCents": 10000,        "maximumCheckoutAmountCents": 500000    }        HTTP/1.1 200 OK    Date: Thu, 16 Mar 2023 09:34:26 GMT    Content-Type: application/json    Content-Length: 79    Connection: keep-alive    x-amzn-RequestId: 02401a4a-6244-42f6-8df8-eb567e569951    Content-Encoding: gzip    x-amz-apigw-id: B3hZNEDqDoEF-Wg=    X-Amzn-Trace-Id: Root=1-6412e2a1-72eab5a25e2647870bce9843        {        "secretSigningKey": "05bea2b2-a3a0-49c6-99ab-79cd1527ec22"    }

IMPORTANT

You can only execute this API successfully once.

If you attempt to execute this again you will receive a HTTP 403 status back from the API.

You need to rather execute the PATCH (Update) operation to perform any updates to your settings.