For the complete documentation index, see llms.txt. This page is also available as Markdown.

Templating

Manage checkout templates that pre-define the field visibility and layout for the customer data collection form. To apply a template, pass its ID in the checkout_template_id field when creating a checkout.

Create Template

post
/v2/template/checkoutDetails
Authorizations
AuthorizationstringRequired

HTTP Basic authentication using entity credentials (username:password encoded in Base64).

Body
namestring · max: 255Required
entity_idstringOptional

Entity Id can be located on the organization level as Organization ID (Administration > Organizations > [Organization] > Organisation ID value)

billing_is_same_as_shippingbooleanOptional

Indicates whether billing address is same as shipping address or not.

Default: true
shipping_first_billing_secondbooleanOptional

Indicates the order of addresses in which the merchant wants to collect the information from the customer.

Default: false
Responses
200

Successful

application/json
namestring · max: 255Required
entity_idstringOptional

Entity Id can be located on the organization level as Organization ID (Administration > Organizations > [Organization] > Organisation ID value)

billing_is_same_as_shippingbooleanOptional

Indicates whether billing address is same as shipping address or not.

Default: true
shipping_first_billing_secondbooleanOptional

Indicates the order of addresses in which the merchant wants to collect the information from the customer.

Default: false
idstringOptional
created_atstring · dateOptional
updated_atstring · dateOptional
statusstring · enumOptional

Indicates whether the template is active or not.

Possible values:
post
/v2/template/checkoutDetails

Get a template by id

get
/v2/template/checkoutDetails/{id}
Authorizations
AuthorizationstringRequired

HTTP Basic authentication using entity credentials (username:password encoded in Base64).

Path parameters
idstringRequired

The id parameter in the GET API uniquely identifies a checkout template, allowing you to retrieve detailed information about a specific template by providing its associated identifier.

Responses
200

Successful

application/json
namestring · max: 255Required
entity_idstringOptional

Entity Id can be located on the organization level as Organization ID (Administration > Organizations > [Organization] > Organisation ID value)

billing_is_same_as_shippingbooleanOptional

Indicates whether billing address is same as shipping address or not.

Default: true
shipping_first_billing_secondbooleanOptional

Indicates the order of addresses in which the merchant wants to collect the information from the customer.

Default: false
idstringOptional
created_atstring · dateOptional
updated_atstring · dateOptional
statusstring · enumOptional

Indicates whether the template is active or not.

Possible values:
get
/v2/template/checkoutDetails/{id}

Delete a template by id

delete
/v2/template/checkoutDetails/{id}
Authorizations
AuthorizationstringRequired

HTTP Basic authentication using entity credentials (username:password encoded in Base64).

Path parameters
idstringRequired

The id parameter in the GET API uniquely identifies a checkout template, allowing you to retrieve detailed information about a specific template by providing its associated identifier.

Responses
delete
/v2/template/checkoutDetails/{id}

No content

Update Template

patch
/v2/template/checkoutDetails/{id}
Authorizations
AuthorizationstringRequired

HTTP Basic authentication using entity credentials (username:password encoded in Base64).

Path parameters
idstringRequired

The id parameter in the GET API uniquely identifies a checkout template, allowing you to retrieve detailed information about a specific template by providing its associated identifier.

Body
namestring · max: 255Required
entity_idstringOptional

Entity Id can be located on the organization level as Organization ID (Administration > Organizations > [Organization] > Organisation ID value)

billing_is_same_as_shippingbooleanOptional

Indicates whether billing address is same as shipping address or not.

Default: true
shipping_first_billing_secondbooleanOptional

Indicates the order of addresses in which the merchant wants to collect the information from the customer.

Default: false
Responses
200

Successful

application/json
namestring · max: 255Required
entity_idstringOptional

Entity Id can be located on the organization level as Organization ID (Administration > Organizations > [Organization] > Organisation ID value)

billing_is_same_as_shippingbooleanOptional

Indicates whether billing address is same as shipping address or not.

Default: true
shipping_first_billing_secondbooleanOptional

Indicates the order of addresses in which the merchant wants to collect the information from the customer.

Default: false
idstringOptional
created_atstring · dateOptional
updated_atstring · dateOptional
statusstring · enumOptional

Indicates whether the template is active or not.

Possible values:
patch
/v2/template/checkoutDetails/{id}

List Templates

get
/v2/template/checkoutDetails/
Authorizations
AuthorizationstringRequired

HTTP Basic authentication using entity credentials (username:password encoded in Base64).

Query parameters
searchstringOptional

Filter templates using RSQL syntax. Combine expressions with ; (AND) or , (OR).

Filterable fields:

FieldTypeOperators
namestring== != =in= =out= =regex= =contains=
created_atdate== != =in= =out= =gt= =ge= =lt= =le=
updated_atdate== != =in= =out= =gt= =ge= =lt= =le=
entity_idstring== != =in= =out= =regex=

Examples:

  • name==MyTemplate;entity_id==a6b45428-0296-4394-8ddd-0b50b5b20aa9
  • name==TemplateName
order_criteriastring · enumOptionalPossible values:
order_bystring · enumOptional

The ordering sequence of the selected templates If not selected then Descending order is the default order.

Possible values:
page_numbernumber · min: 1Optional

A filter query in RSQL format to retrieve templates based on page number. If not selected then a default pageNumber is 1.

page_sizenumberOptional

A filter query in RSQL format to retrieve templates based on page size. If not selected then a default pageSize is 50

Responses
200

Successful

application/json
namestring · max: 255Required
entity_idstringOptional

Entity Id can be located on the organization level as Organization ID (Administration > Organizations > [Organization] > Organisation ID value)

billing_is_same_as_shippingbooleanOptional

Indicates whether billing address is same as shipping address or not.

Default: true
shipping_first_billing_secondbooleanOptional

Indicates the order of addresses in which the merchant wants to collect the information from the customer.

Default: false
get
/v2/template/checkoutDetails/

Count Templates

get
/v2/template/checkoutDetails/count
Authorizations
AuthorizationstringRequired

HTTP Basic authentication using entity credentials (username:password encoded in Base64).

Query parameters
searchstringRequired

Filter templates using RSQL syntax. Combine expressions with ; (AND) or , (OR).

Filterable fields:

FieldTypeOperators
namestring== != =in= =out= =regex= =contains=
created_atdate== != =in= =out= =gt= =ge= =lt= =le=
updated_atdate== != =in= =out= =gt= =ge= =lt= =le=
entity_idstring== != =in= =out= =regex=

Examples:

  • name==MyTemplate;entity_id==a6b45428-0296-4394-8ddd-0b50b5b20aa9
  • name==TemplateName
Responses
200

Successful

application/json
countnumberOptional

Count

get
/v2/template/checkoutDetails/count

Last updated

Was this helpful?