Skip to main content

Generating and configuring the checkout page

After signing up as a merchant, your account manager will provide you with an api key, and application key. For the purposes of this sandbox, please use the following:

  • Api key:
  • App key:

The first step to generate the checkout page is to generate an authentication token.

curl --location 'https://beta.digitzsapi.com/v3/auth/token' \
--header 'x-api-key: {{your api key}}' \
--header 'Content-Type: application/json' \
--data '{
"data": {
"type": "auth",
"attributes": {
"appKey": "{{your app key}}"
}
}
}'

You will get a token. Take not of this as you will use it in succeeding requests..

The second step after getting an authorization token, is to generate your checkout page. Here's how to do it:

curl --location 'https://5nnmxcc8c0.execute-api.us-west-2.amazonaws.com/prod/generator/genPayment' \
--header 'x-api-key: {{ your api key }}' \
--header 'Authorization: Bearer {{ authentication token from step 1 }}' \
--header 'Content-Type: application/json' \
--data '{
"merchant_id": "{{ your digitzs id }}",
"is_capture_email": true,
"is_capture_zip": true,
"enable_token": true,
"payment_version": "v4",
"style": ""
}'

The third step is to configure your Checkout page:

The checkout page supports the following query parameters:

  • amount: Amount to be processed by the checkout form. This is in cents format, ex $1 = 100. this is a required field
  • email: Email of the customer using the checkout page. This is an optional field
  • zip: Zip code of the customer using the checkout page. This is an optional field
  • invoice: Unique invoice # of the sale of the checkout page. This is an optional field
  • splitConfig: Split config, only for transactions going through Propay Gateway. This is an optional field

Here's an example of a configured checkout page: Pay via Checkout