KosmoKrator

data

Checkout.com Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Checkout.com KosmoKrator integration.

Lua Namespace

Agents call this integration through app.integrations.checkout_com.*. Use lua_read_doc("integrations.checkout-com") inside KosmoKrator to discover the same reference at runtime.

Call Lua from the Headless CLI

Use kosmo integrations:lua when a shell script, CI job, cron job, or another coding CLI should run a deterministic Checkout.com workflow without starting an interactive agent session.

Inline Lua call
kosmo integrations:lua --eval 'dump(app.integrations.checkout_com.retrieve_updated_card_details({body = "example_body"}))' --json
Read Lua docs headlessly
kosmo integrations:lua --eval 'print(docs.read("checkout-com"))' --json
kosmo integrations:lua --eval 'print(docs.read("checkout-com.retrieve_updated_card_details"))' --json

Workflow file

Put repeatable logic in a Lua file, then execute it with JSON output for the calling process.

workflow.lua
local checkout_com = app.integrations.checkout_com
local result = checkout_com.retrieve_updated_card_details({body = "example_body"})

dump(result)
Run the workflow
kosmo integrations:lua workflow.lua --json
kosmo integrations:lua workflow.lua --force --json
Namespace note. integrations:lua exposes app.integrations.checkout_com, app.mcp.*, docs.*, json.*, and regex.*. Use app.integrations.checkout_com.default.* or app.integrations.checkout_com.work.* when you configured named credential accounts.

MCP-only Lua

If the script only needs configured MCP servers and does not need Checkout.com, use the narrower mcp:lua command.

MCP Lua command
# Use mcp:lua for MCP-only scripts; use integrations:lua for this integration namespace.
kosmo mcp:lua --eval 'dump(mcp.servers())' --json

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

Checkout.com Integration

Use the checkout-com integration to manage Checkout.com payments, payouts, payment sessions, hosted payments, payment links, disputes, issuing cards and controls, platform entities, workflows, balances, transfers, reports, files, and authentication token requests.

All endpoint tools are generated from the official Checkout.com OpenAPI document at https://api-reference.checkout.com/v1/swagger.json. Configure a Checkout.com key or access token; authenticated runtime calls send Authorization: Bearer <value>. Checkout.com base URLs are unique per account, so set url and access_url to the sandbox or production URLs shown in your Checkout.com dashboard.

Common Tools

  • checkout_com_request_a_payment_or_payout, checkout_com_get_payments_list, checkout_com_get_payment_details, checkout_com_capture_a_payment, checkout_com_refund_a_payment, checkout_com_cancel_a_payment, and checkout_com_void_a_payment cover payment lifecycle operations.
  • checkout_com_create_payment_session, checkout_com_submit_payment_session, and checkout_com_create_and_submit_payment_session cover payment sessions.
  • Platform entity, payment instrument, dispute, issuing card, control, transfer, workflow, balance, report, file, and identity-verification tools map directly to the official API reference.
  • checkout_com_request_an_access_token uses access_url and form-encoded body fields such as grant_type, client_id, client_secret, and scope.

Request Shape

Path, query, and header parameters are exposed as snake_case tool parameters. JSON, form-encoded, and multipart request bodies are passed through the body object and should match the official Checkout.com schema for the endpoint. Header parameters such as cko_idempotency_key are mapped to their documented names.

Return Shape

JSON responses are returned as decoded arrays/objects from Checkout.com. Empty successful responses return { success = true, status = <http_status> }.

Examples

local methods = app.integrations["checkout-com"].get_payment_methods({})

local payment = app.integrations["checkout-com"].request_a_payment_or_payout({
  cko_idempotency_key = "example-payment-key-001",
  body = {
    source = { type = "token", token = "tok_example" },
    amount = 1299,
    currency = "USD",
    reference = "example-order-001"
  }
})

local token = app.integrations["checkout-com"].request_an_access_token({
  body = {
    grant_type = "client_credentials",
    client_id = "ack_example",
    client_secret = "example-secret",
    scope = "gateway"
  }
})

Use fake IDs, tokens, customers, disputes, cardholders, and metadata in tests and prompts. Never place real card data, customer data, payment IDs, account prefixes, API keys, access tokens, or files in fixtures or Lua examples.

Raw agent markdown
# Checkout.com Integration

Use the `checkout-com` integration to manage Checkout.com payments, payouts, payment sessions, hosted payments, payment links, disputes, issuing cards and controls, platform entities, workflows, balances, transfers, reports, files, and authentication token requests.

All endpoint tools are generated from the official Checkout.com OpenAPI document at `https://api-reference.checkout.com/v1/swagger.json`. Configure a Checkout.com key or access token; authenticated runtime calls send `Authorization: Bearer <value>`. Checkout.com base URLs are unique per account, so set `url` and `access_url` to the sandbox or production URLs shown in your Checkout.com dashboard.

## Common Tools

- `checkout_com_request_a_payment_or_payout`, `checkout_com_get_payments_list`, `checkout_com_get_payment_details`, `checkout_com_capture_a_payment`, `checkout_com_refund_a_payment`, `checkout_com_cancel_a_payment`, and `checkout_com_void_a_payment` cover payment lifecycle operations.
- `checkout_com_create_payment_session`, `checkout_com_submit_payment_session`, and `checkout_com_create_and_submit_payment_session` cover payment sessions.
- Platform entity, payment instrument, dispute, issuing card, control, transfer, workflow, balance, report, file, and identity-verification tools map directly to the official API reference.
- `checkout_com_request_an_access_token` uses `access_url` and form-encoded `body` fields such as `grant_type`, `client_id`, `client_secret`, and `scope`.

## Request Shape

Path, query, and header parameters are exposed as snake_case tool parameters. JSON, form-encoded, and multipart request bodies are passed through the `body` object and should match the official Checkout.com schema for the endpoint. Header parameters such as `cko_idempotency_key` are mapped to their documented names.

## Return Shape

JSON responses are returned as decoded arrays/objects from Checkout.com. Empty successful responses return `{ success = true, status = <http_status> }`.

## Examples

```lua
local methods = app.integrations["checkout-com"].get_payment_methods({})

local payment = app.integrations["checkout-com"].request_a_payment_or_payout({
  cko_idempotency_key = "example-payment-key-001",
  body = {
    source = { type = "token", token = "tok_example" },
    amount = 1299,
    currency = "USD",
    reference = "example-order-001"
  }
})

local token = app.integrations["checkout-com"].request_an_access_token({
  body = {
    grant_type = "client_credentials",
    client_id = "ack_example",
    client_secret = "example-secret",
    scope = "gateway"
  }
})
```

Use fake IDs, tokens, customers, disputes, cardholders, and metadata in tests and prompts. Never place real card data, customer data, payment IDs, account prefixes, API keys, access tokens, or files in fixtures or Lua examples.
Metadata-derived Lua example
local result = app.integrations.checkout_com.retrieve_updated_card_details({body = "example_body"})
print(result)

Functions

retrieve_updated_card_details Read

Retrieve updated card credentials. The following card schemes are supported: - Mastercard - Visa - American Express Official Checkout.com endpoint: POST /account-updater/cards.

Lua path
app.integrations.checkout_com.retrieve_updated_card_details
Full name
checkout-com.checkout_com_retrieve_updated_card_details
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
onboard_entity Read

Onboard an entity so they can start using Checkout services. Official Checkout.com endpoint: POST /accounts/entities.

Lua path
app.integrations.checkout_com.onboard_entity
Full name
checkout-com.checkout_com_onboard_entity
ParameterTypeRequiredDescription
accept string yes Used to describe the type of content the client can interpret. Use the schema_version value to specify the payload format. The latest version is 3.0.
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_sub_entity_members Read

Beta Retrieve information on all users of a sub-entity that has been invited through Hosted Onboarding. Only one user can be invited to onboard the sub-entity through Hosted Onboarding. To enable the Hosted Onboarding feature, contact your Account Manager. Official Checkout.com endpoint: GET /accounts/entities/{entityId}/members.

Lua path
app.integrations.checkout_com.get_sub_entity_members
Full name
checkout-com.checkout_com_get_sub_entity_members
ParameterTypeRequiredDescription
entity_id string yes The ID of the sub-entity
reinvite_sub_entity_members Read

Beta Resend an invitation to the user of a sub-entity. The user will receive another email to continue their Hosted Onboarding application. An invitation can only be resent to the user originally registered to the sub-entity. To enable the Hosted Onboarding feature, contact your Account Manager. Official Checkout.com endpoint: PUT /accounts/entities/{entityId}/members/{userId}.

Lua path
app.integrations.checkout_com.reinvite_sub_entity_members
Full name
checkout-com.checkout_com_reinvite_sub_entity_members
ParameterTypeRequiredDescription
entity_id string yes The ID of the sub-entity
user_id string yes The ID of the invited user.
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_platforms_payment_instrument Read

Retrieve the details of a specific payment instrument used for sub-entity payouts. Official Checkout.com endpoint: GET /accounts/entities/{entityId}/payment-instruments/{id}.

Lua path
app.integrations.checkout_com.get_platforms_payment_instrument
Full name
checkout-com.checkout_com_get_platforms_payment_instrument
ParameterTypeRequiredDescription
entity_id string yes The sub-entity's ID.
id string yes The payment instrument's ID.
update_platforms_payment_instrument Write

Set an existing payment instrument as default. This will make it the destination instrument when a scheduled payout is made. You can also update the label of a payment instrument. Official Checkout.com endpoint: PATCH /accounts/entities/{entityId}/payment-instruments/{id}.

Lua path
app.integrations.checkout_com.update_platforms_payment_instrument
Full name
checkout-com.checkout_com_update_platforms_payment_instrument
ParameterTypeRequiredDescription
entity_id string yes The sub-entity's ID.
id string yes The payment instrument's ID.
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_reserve_rule Read

Retrieve the details of a specific reserve rule. Official Checkout.com endpoint: GET /accounts/entities/{entityId}/reserve-rules/{id}.

Lua path
app.integrations.checkout_com.get_reserve_rule
Full name
checkout-com.checkout_com_get_reserve_rule
ParameterTypeRequiredDescription
entity_id string yes The sub-entity's ID.
id string yes The reserve rule ID.
update_reserve_rule Write

Update an upcoming reserve rule. Only reserve rules that have never been active can be updated. Official Checkout.com endpoint: PUT /accounts/entities/{entityId}/reserve-rules/{id}.

Lua path
app.integrations.checkout_com.update_reserve_rule
Full name
checkout-com.checkout_com_update_reserve_rule
ParameterTypeRequiredDescription
entity_id string yes The sub-entity's ID.
id string yes The reserve rule ID.
if_match string yes Identifies a specific version of a reserve rule to update.
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_entity_details Read

Use this endpoint to retrieve an entity and its full details. Official Checkout.com endpoint: GET /accounts/entities/{id}.

Lua path
app.integrations.checkout_com.get_entity_details
Full name
checkout-com.checkout_com_get_entity_details
ParameterTypeRequiredDescription
accept string yes Used to describe the type of content the client can interpret. Use the schema_version value to specify the payload format. The latest version is 3.0.
id string yes The ID of the entity.
update_entity_details Write

Update an entity. **Note:** when you update a entity we may conduct further due diligence checks when necessary. During these checks, your payment capabilities will remain the same. Official Checkout.com endpoint: PUT /accounts/entities/{id}.

Lua path
app.integrations.checkout_com.update_entity_details
Full name
checkout-com.checkout_com_update_entity_details
ParameterTypeRequiredDescription
accept string yes Used to describe the type of content the client can interpret. Use the schema_version value to specify the payload format. The latest version is 3.0.
id string yes The ID of the entity.
body object yes Request body matching the official Checkout.com OpenAPI schema.
add_platforms_payment_instrument Write

Create a bank account payment instrument for your sub-entity. You can use this payment instrument as a payout destination. Official Checkout.com endpoint: POST /accounts/entities/{id}/payment-instruments.

Lua path
app.integrations.checkout_com.add_platforms_payment_instrument
Full name
checkout-com.checkout_com_add_platforms_payment_instrument
ParameterTypeRequiredDescription
id string yes The sub-entity's ID.
body object yes Request body matching the official Checkout.com OpenAPI schema.
query_platforms_payment_instruments Read

Fetch all of the payment instruments for a sub-entity. You can filter by `status` to identify `verified` instruments that are ready to be used for Payouts. Official Checkout.com endpoint: GET /accounts/entities/{id}/payment-instruments.

Lua path
app.integrations.checkout_com.query_platforms_payment_instruments
Full name
checkout-com.checkout_com_query_platforms_payment_instruments
ParameterTypeRequiredDescription
id string yes The sub-entity's ID.
status string no status
get_sub_entitys_payout_schedule Read

You can schedule when your sub-entities receive their funds using our Platforms solution. Use this endpoint to retrieve information about a sub-entity's schedule. Official Checkout.com endpoint: GET /accounts/entities/{id}/payout-schedules.

Lua path
app.integrations.checkout_com.get_sub_entitys_payout_schedule
Full name
checkout-com.checkout_com_get_sub_entitys_payout_schedule
ParameterTypeRequiredDescription
id string yes The ID of the sub-entity
put_sub_entitys_payout_schedule Read

You can schedule when your sub-entities receive their funds using our Platforms solution. Use this endpoint to update a sub-entity's schedule. Official Checkout.com endpoint: PUT /accounts/entities/{id}/payout-schedules.

Lua path
app.integrations.checkout_com.put_sub_entitys_payout_schedule
Full name
checkout-com.checkout_com_put_sub_entitys_payout_schedule
ParameterTypeRequiredDescription
id string yes The ID of the sub-entity
body object yes Request body matching the official Checkout.com OpenAPI schema.
add_reserve_rule Write

Create a sub-entity reserve rule. Official Checkout.com endpoint: POST /accounts/entities/{id}/reserve-rules.

Lua path
app.integrations.checkout_com.add_reserve_rule
Full name
checkout-com.checkout_com_add_reserve_rule
ParameterTypeRequiredDescription
id string yes The sub-entity's ID.
body object yes Request body matching the official Checkout.com OpenAPI schema.
query_reserve_rules Read

Fetch all of the reserve rules for a sub-entity. Official Checkout.com endpoint: GET /accounts/entities/{id}/reserve-rules.

Lua path
app.integrations.checkout_com.query_reserve_rules
Full name
checkout-com.checkout_com_query_reserve_rules
ParameterTypeRequiredDescription
id string yes The sub-entity's ID.
delegate_payment Read

Create a delegated payment token Official Checkout.com endpoint: POST /agentic_commerce/delegate_payment.

Lua path
app.integrations.checkout_com.delegate_payment
Full name
checkout-com.checkout_com_delegate_payment
ParameterTypeRequiredDescription
signature string yes A Base64-encoded HMAC-SHA256 signature used for request body integrity verification. Compute the signature as follows: 1. Concatenate the `Timestamp` header value (as a UTF-8 string) with the raw JSON request body (as a UTF-8 string). 2. Compute the HMAC-SHA25
timestamp string yes The timestamp of the request, in RFC 3339 format (for example, `2026-03-11T10:30:00Z`). The timestamp must be within 5 minutes of the server time. Requests with a timestamp outside this window are rejected with a `401` response.
cko_idempotency_key string no An optional idempotency key for safely retrying payment requests
api_version string no The API version to use for the request. If not specified, the default version (`2026-01-30`) is used.
body object no Request body matching the official Checkout.com OpenAPI schema.
create_aml_verification Write

Beta Create an [AML screening](https://www.checkout.com/docs/business-operations/manage-identities/screen-aml-databases). If the request is successful, you receive a `201 Created` response with the AML screening resource. Official Checkout.com endpoint: POST /aml-verifications.

Lua path
app.integrations.checkout_com.create_aml_verification
Full name
checkout-com.checkout_com_create_aml_verification
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
retrieve_aml_screening Read

Get the detailed result of an [AML screening](https://www.checkout.com/docs/business-operations/manage-identities/screen-aml-databases). Official Checkout.com endpoint: GET /aml-verifications/{aml_verification_id}.

Lua path
app.integrations.checkout_com.retrieve_aml_screening
Full name
checkout-com.checkout_com_retrieve_aml_screening
ParameterTypeRequiredDescription
aml_verification_id string yes The AML screening's unique identifier.
upload_apple_pay_certificate Read

Upload a payment processing certificate. This will allow you to start processing payments via Apple Pay. Official Checkout.com endpoint: POST /applepay/certificates.

Lua path
app.integrations.checkout_com.upload_apple_pay_certificate
Full name
checkout-com.checkout_com_upload_apple_pay_certificate
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
apple_pay_enroll_merchant Read

Enroll a domain to the Apple Pay Service Official Checkout.com endpoint: POST /applepay/enrollments.

Lua path
app.integrations.checkout_com.apple_pay_enroll_merchant
Full name
checkout-com.checkout_com_apple_pay_enroll_merchant
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
generate_apple_pay_signing_request Read

Generate a certificate signing request. You'll need to upload this to your Apple Developer account to download a payment processing certificate. Official Checkout.com endpoint: POST /applepay/signing-requests.

Lua path
app.integrations.checkout_com.generate_apple_pay_signing_request
Full name
checkout-com.checkout_com_generate_apple_pay_signing_request
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
get_entity_balances Read

Use this endpoint to retrieve balances for each sub-account in an entity. *Note:* The sub-account is referred to as _currency account_ in the API. Official Checkout.com endpoint: GET /balances/{id}.

Lua path
app.integrations.checkout_com.get_entity_balances
Full name
checkout-com.checkout_com_get_entity_balances
ParameterTypeRequiredDescription
id string yes The ID of the entity.
query string no The query to apply to limit the currency accounts.
with_currency_account_id boolean no Specifies if the response should include the sub-account ID that corresponds to each set of balances.
compliance_requests_get_compliance_request Read

Retrieve an existing compliance request by payment ID. Official Checkout.com endpoint: GET /compliance-requests/{payment_id}.

Lua path
app.integrations.checkout_com.compliance_requests_get_compliance_request
Full name
checkout-com.checkout_com_compliance_requests_get_compliance_request
ParameterTypeRequiredDescription
payment_id string yes The compliance request's payment ID.
compliance_requests_submit_compliance_request_response Write

Submit a response to a compliance request. Official Checkout.com endpoint: POST /compliance-requests/{payment_id}.

Lua path
app.integrations.checkout_com.compliance_requests_submit_compliance_request_response
Full name
checkout-com.checkout_com_compliance_requests_submit_compliance_request_response
ParameterTypeRequiredDescription
payment_id string yes The compliance request's payment ID.
body object no Request body matching the official Checkout.com OpenAPI schema.
request_access_token Read

OAuth endpoint to exchange your access key ID and access key secret for an access token. Official Checkout.com endpoint: POST /connect/token.

Lua path
app.integrations.checkout_com.request_access_token
Full name
checkout-com.checkout_com_request_an_access_token
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
create_customer Write

Store a customer's details in a customer object to reuse in future payments. When creating a customer, you can link payment instruments – the customer `id` returned can be passed as a source when making a payment. **NOTE:** Specify a `default` instrument, otherwise the `instruments` array will not be saved on creation. Official Checkout.com endpoint: POST /customers.

Lua path
app.integrations.checkout_com.create_customer
Full name
checkout-com.checkout_com_create_customer
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_customer_details Read

Returns the details of a customer and their payment instruments. Official Checkout.com endpoint: GET /customers/{identifier}.

Lua path
app.integrations.checkout_com.get_customer_details
Full name
checkout-com.checkout_com_get_customer_details
ParameterTypeRequiredDescription
identifier object yes The customer's ID or email
update_customer_details Write

Update the details of a customer and link payment instruments to them. Official Checkout.com endpoint: PATCH /customers/{identifier}.

Lua path
app.integrations.checkout_com.update_customer_details
Full name
checkout-com.checkout_com_update_customer_details
ParameterTypeRequiredDescription
identifier string yes The customer's ID
body object yes Request body matching the official Checkout.com OpenAPI schema.
delete_customer Write

Delete a customer and all of their linked payment instruments. Official Checkout.com endpoint: DELETE /customers/{identifier}.

Lua path
app.integrations.checkout_com.delete_customer
Full name
checkout-com.checkout_com_delete_customer
ParameterTypeRequiredDescription
identifier string yes The customer's ID
get_disputes Read

Returns a list of all disputes against your business. The results will be returned in reverse chronological order, showing the last modified dispute (for example, where you've recently added a piece of evidence) first. You can use the optional parameters below to skip or limit results. Official Checkout.com endpoint: GET /disputes.

Lua path
app.integrations.checkout_com.get_disputes
Full name
checkout-com.checkout_com_get_disputes
ParameterTypeRequiredDescription
limit number no The numbers of results to return
skip number no The number of results to skip
from string no The date and time from which to filter disputes, based on the dispute's `last_update` field
to string no The date and time until which to filter disputes, based on the dispute's `last_update` field
id string no The unique identifier of the dispute
entity_ids string no One or more comma-separated client entities. This works like a logical *OR* operator
sub_entity_ids string no One or more comma-separated sub-entities. This works like a logical *OR* operator
processing_channel_ids string no One or more comma-separated processing channels. This works like a logical *OR* operator.
segment_ids string no One or more comma-separated segments. This works like a logical *OR* operator.
statuses string no One or more comma-separated statuses. This works like a logical *OR* operator
payment_id string no The unique identifier of the payment
payment_reference string no An optional reference (such as an order ID) that you can use later to identify the payment. Previously known as `TrackId`
payment_arn string no The acquirer reference number (ARN) that you can use to query the issuing bank
payment_mcc string no The merchant category code (MCC) of the payment (ISO 18245)
this_channel_only boolean no If `true`, only returns disputes of the specific channel that the secret key is associated with. Otherwise, returns all disputes for that business
get_dispute_details Read

Returns all the details of a dispute using the dispute identifier. Official Checkout.com endpoint: GET /disputes/{dispute_id}.

Lua path
app.integrations.checkout_com.get_dispute_details
Full name
checkout-com.checkout_com_get_dispute_details
ParameterTypeRequiredDescription
dispute_id string yes The dispute identifier
accept_dispute Read

If a dispute is legitimate, you can choose to accept it. This will close it for you and remove it from your list of open disputes. There are no further financial implications. Official Checkout.com endpoint: POST /disputes/{dispute_id}/accept.

Lua path
app.integrations.checkout_com.accept_dispute
Full name
checkout-com.checkout_com_accept_dispute
ParameterTypeRequiredDescription
dispute_id string yes The dispute identifier
body object no Request body matching the official Checkout.com OpenAPI schema.
provide_dispute_evidence Read

Provide dispute evidence Official Checkout.com endpoint: PUT /disputes/{dispute_id}/evidence.

Lua path
app.integrations.checkout_com.provide_dispute_evidence
Full name
checkout-com.checkout_com_provide_dispute_evidence
ParameterTypeRequiredDescription
dispute_id string yes The dispute identifier.
body object no Request body matching the official Checkout.com OpenAPI schema.
get_dispute_evidence Read

Retrieves a list of the evidence submitted in response to a specific dispute. Official Checkout.com endpoint: GET /disputes/{dispute_id}/evidence.

Lua path
app.integrations.checkout_com.get_dispute_evidence
Full name
checkout-com.checkout_com_get_dispute_evidence
ParameterTypeRequiredDescription
dispute_id string yes The dispute identifier.
submit_dispute_evidence Write

With this final request, you can submit the evidence that you have previously provided. Make sure you have provided all the relevant information before using this request. You will not be able to amend your evidence once you have submitted it. Official Checkout.com endpoint: POST /disputes/{dispute_id}/evidence.

Lua path
app.integrations.checkout_com.submit_dispute_evidence
Full name
checkout-com.checkout_com_submit_dispute_evidence
ParameterTypeRequiredDescription
dispute_id string yes The dispute identifier.
body object no Request body matching the official Checkout.com OpenAPI schema.
submit_dispute_arbitration_evidence Write

Submits the previously provided arbitration evidence to the scheme. You cannot amend evidence after you submit with this endpoint. Ensure you have provided all of the required information. Official Checkout.com endpoint: POST /disputes/{dispute_id}/evidence/arbitration.

Lua path
app.integrations.checkout_com.submit_dispute_arbitration_evidence
Full name
checkout-com.checkout_com_submit_dispute_arbitration_evidence
ParameterTypeRequiredDescription
dispute_id string yes The dispute identifier.
body object no Request body matching the official Checkout.com OpenAPI schema.
get_dispute_submitted_arbitration_evidence Read

Retrieves the unique identifier of the PDF file containing all of the evidence submitted to escalate the dispute to arbitration. To retrieve the file's download link, call the `GET /files/{file_id}` [endpoint](https://api-reference.checkout.com/#operation/getFileInformation) with the returned file ID. Official Checkout.com endpoint: GET /disputes/{dispute_id}/evidence/arbitration/submitted.

Lua path
app.integrations.checkout_com.get_dispute_submitted_arbitration_evidence
Full name
checkout-com.checkout_com_get_dispute_submitted_arbitration_evidence
ParameterTypeRequiredDescription
dispute_id string yes The dispute identifier.
get_dispute_submitted_evidence Read

Retrieves the unique identifier of the PDF file containing all the evidence submitted to represent the dispute case. To retrieve the file's download link, call the `GET /files/{file_id}` [endpoint](https://api-reference.checkout.com/#operation/getFileInformation) with the returned file ID. Evidence submitted before February 2024 cannot be retrieved using this endpoint. Official Checkout.com endpoint: GET /disputes/{dispute_id}/evidence/submitted.

Lua path
app.integrations.checkout_com.get_dispute_submitted_evidence
Full name
checkout-com.checkout_com_get_dispute_submitted_evidence
ParameterTypeRequiredDescription
dispute_id string yes The dispute identifier.
get_dispute_scheme_files Read

Returns all of the scheme files of a dispute using the dispute identifier. Currently available only for VISA disputes. Official Checkout.com endpoint: GET /disputes/{dispute_id}/schemefiles.

Lua path
app.integrations.checkout_com.get_dispute_scheme_files
Full name
checkout-com.checkout_com_get_dispute_scheme_files
ParameterTypeRequiredDescription
dispute_id string yes The dispute identifier
upload_file Read

Upload a file Official Checkout.com endpoint: POST /entities/{entityId}/files.

Lua path
app.integrations.checkout_com.upload_file
Full name
checkout-com.checkout_com_upload_a_file
ParameterTypeRequiredDescription
entity_id string yes The ID of the sub-entity
body object no Request body matching the official Checkout.com OpenAPI schema.
retrieve_file Read

Retrieve information about a previously uploaded file. Please note that the sub-domain – https://files.checkout.com – is slightly different to Checkout.com's other endpoints. See the documentation for more information. Official Checkout.com endpoint: GET /entities/{entityId}/files/{fileId}.

Lua path
app.integrations.checkout_com.retrieve_file
Full name
checkout-com.checkout_com_retrieve_a_file
ParameterTypeRequiredDescription
entity_id string yes The ID of the sub-entity
file_id string yes The ID of the file. The value is always prefixed with `file_`.
create_face_authentication Write

Create a face authentication Official Checkout.com endpoint: POST /face-authentications.

Lua path
app.integrations.checkout_com.create_face_authentication
Full name
checkout-com.checkout_com_create_face_authentication
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
retrieve_face_authentication Read

Beta Get the details of a [face authentication](https://www.checkout.com/docs/business-operations/manage-identities/authenticate-with-biometrics). Official Checkout.com endpoint: GET /face-authentications/{face_authentication_id}.

Lua path
app.integrations.checkout_com.retrieve_face_authentication
Full name
checkout-com.checkout_com_retrieve_face_authentication
ParameterTypeRequiredDescription
face_authentication_id string yes The face authentication's unique identifier.
anonymize_face_authentication Read

Beta Remove the personal data in a [face authentication](https://www.checkout.com/docs/business-operations/manage-identities/authenticate-with-biometrics). Official Checkout.com endpoint: POST /face-authentications/{face_authentication_id}/anonymize.

Lua path
app.integrations.checkout_com.anonymize_face_authentication
Full name
checkout-com.checkout_com_anonymize_face_authentication
ParameterTypeRequiredDescription
face_authentication_id string yes The face authentication's unique identifier.
body object no Request body matching the official Checkout.com OpenAPI schema.
create_fav_attempt Write

Create a face authentication attempt Official Checkout.com endpoint: POST /face-authentications/{face_authentication_id}/attempts.

Lua path
app.integrations.checkout_com.create_fav_attempt
Full name
checkout-com.checkout_com_create_fav_attempt
ParameterTypeRequiredDescription
face_authentication_id string yes The face authentication's unique identifier.
body object no Request body matching the official Checkout.com OpenAPI schema.
list_fav_attempts Read

Beta Get the details of all attempts for a specific [face authentication](https://www.checkout.com/docs/business-operations/manage-identities/authenticate-with-biometrics). Official Checkout.com endpoint: GET /face-authentications/{face_authentication_id}/attempts.

Lua path
app.integrations.checkout_com.list_fav_attempts
Full name
checkout-com.checkout_com_list_fav_attempts
ParameterTypeRequiredDescription
face_authentication_id string yes The face authentication's unique identifier.
get_fav_attempt Read

Beta Get the details of a specific attempt for a [face authentication](https://www.checkout.com/docs/business-operations/manage-identities/authenticate-with-biometrics). Official Checkout.com endpoint: GET /face-authentications/{face_authentication_id}/attempts/{attempt_id}.

Lua path
app.integrations.checkout_com.get_fav_attempt
Full name
checkout-com.checkout_com_get_fav_attempt
ParameterTypeRequiredDescription
face_authentication_id string yes The face authentication's unique identifier.
attempt_id string yes The attempt's unique identifier.
upload_file Read

Upload a file to use as evidence in a dispute. Your file must be in either JPEG/JPG, PNG or PDF format, and be no larger than 4MB. Official Checkout.com endpoint: POST /files.

Lua path
app.integrations.checkout_com.upload_file
Full name
checkout-com.checkout_com_upload_file
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
get_file_information Read

Retrieve information about a file that was previously uploaded. Official Checkout.com endpoint: GET /files/{file_id}.

Lua path
app.integrations.checkout_com.get_file_information
Full name
checkout-com.checkout_com_get_file_information
ParameterTypeRequiredDescription
file_id string yes The file identifier. It is always prefixed by `file_`.
get_financial_actions Read

Returns the list of financial actions and their details. Official Checkout.com endpoint: GET /financial-actions.

Lua path
app.integrations.checkout_com.get_financial_actions
Full name
checkout-com.checkout_com_get_financial_actions
ParameterTypeRequiredDescription
payment_id string no The ID of the payment you want to retrieve financial actions for. Required if `action_id` is not used.
action_id string no The ID of the action you want to retrieve financial actions for. Required if `payment_id` is not used.
limit number no The number of results to retrieve per page. </br> For example, if the total result count is 50, and you use `limit=10`, you will need to iterate over 5 pages containing 10 results each to retrieve all of the reports that match your query.
pagination_token string no A token used for pagination when a response contains results across multiple pages.
get_all_workflows Read

Get all workflows Official Checkout.com endpoint: GET /workflows.

Lua path
app.integrations.checkout_com.get_all_workflows
Full name
checkout-com.checkout_com_get_all_workflows
ParameterTypeRequiredDescription
No parameters.
add_workflow Write

Add a new workflow Official Checkout.com endpoint: POST /workflows.

Lua path
app.integrations.checkout_com.add_workflow
Full name
checkout-com.checkout_com_add_workflow
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_workflow Read

Get the details of a workflow Official Checkout.com endpoint: GET /workflows/{workflowId}.

Lua path
app.integrations.checkout_com.get_workflow
Full name
checkout-com.checkout_com_get_workflow
ParameterTypeRequiredDescription
workflow_id string yes The workflow identifier
remove_workflow Write

Removes a workflow so it is no longer being executed. Actions of already executed workflows will be still processed. Official Checkout.com endpoint: DELETE /workflows/{workflowId}.

Lua path
app.integrations.checkout_com.remove_workflow
Full name
checkout-com.checkout_com_remove_workflow
ParameterTypeRequiredDescription
workflow_id string yes The workflow identifier
patch_workflow Read

Update a workflow. Official Checkout.com endpoint: PATCH /workflows/{workflowId}.

Lua path
app.integrations.checkout_com.patch_workflow
Full name
checkout-com.checkout_com_patch_workflow
ParameterTypeRequiredDescription
workflow_id string yes The workflow identifier
body object yes Request body matching the official Checkout.com OpenAPI schema.
add_workflow_action Write

Adds a workflow action. Actions determine what the workflow will do when it is triggered. Official Checkout.com endpoint: POST /workflows/{workflowId}/actions.

Lua path
app.integrations.checkout_com.add_workflow_action
Full name
checkout-com.checkout_com_add_workflow_action
ParameterTypeRequiredDescription
workflow_id string yes The workflow identifier
body object yes Request body matching the official Checkout.com OpenAPI schema.
update_workflow_action Write

Update a workflow action. Official Checkout.com endpoint: PUT /workflows/{workflowId}/actions/{workflowActionId}.

Lua path
app.integrations.checkout_com.update_workflow_action
Full name
checkout-com.checkout_com_update_workflow_action
ParameterTypeRequiredDescription
workflow_id string yes The workflow identifier
workflow_action_id string yes The workflow action identifier
body object yes Request body matching the official Checkout.com OpenAPI schema.
remove_workflow_action Write

Removes a workflow action. Actions determine what the workflow will do when it is triggered. Official Checkout.com endpoint: DELETE /workflows/{workflowId}/actions/{workflowActionId}.

Lua path
app.integrations.checkout_com.remove_workflow_action
Full name
checkout-com.checkout_com_remove_workflow_action
ParameterTypeRequiredDescription
workflow_id string yes The workflow identifier
workflow_action_id string yes The workflow action identifier
add_workflow_condition Write

Adds a workflow condition. Conditions determine when the workflow will trigger. Official Checkout.com endpoint: POST /workflows/{workflowId}/conditions.

Lua path
app.integrations.checkout_com.add_workflow_condition
Full name
checkout-com.checkout_com_add_workflow_condition
ParameterTypeRequiredDescription
workflow_id string yes The workflow identifier
body object yes Request body matching the official Checkout.com OpenAPI schema.
update_workflow_condition Write

Update a workflow condition. Official Checkout.com endpoint: PUT /workflows/{workflowId}/conditions/{workflowConditionId}.

Lua path
app.integrations.checkout_com.update_workflow_condition
Full name
checkout-com.checkout_com_update_workflow_condition
ParameterTypeRequiredDescription
workflow_id string yes The workflow identifier
workflow_condition_id string yes The workflow condition identifier
body object yes Request body matching the official Checkout.com OpenAPI schema.
remove_workflow_condition Write

Removes a workflow condition. Conditions determine when the workflow will trigger. Official Checkout.com endpoint: DELETE /workflows/{workflowId}/conditions/{workflowConditionId}.

Lua path
app.integrations.checkout_com.remove_workflow_condition
Full name
checkout-com.checkout_com_remove_workflow_condition
ParameterTypeRequiredDescription
workflow_id string yes The workflow identifier
workflow_condition_id string yes The workflow condition identifier
test_workflow Write

Validate a workflow in our Sandbox environment. Official Checkout.com endpoint: POST /workflows/{workflowId}/test.

Lua path
app.integrations.checkout_com.test_workflow
Full name
checkout-com.checkout_com_test_workflow
ParameterTypeRequiredDescription
workflow_id string yes The workflow identifier
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_event_types Read

Get a list of sources and their events for building new workflows Official Checkout.com endpoint: GET /workflows/event-types.

Lua path
app.integrations.checkout_com.get_event_types
Full name
checkout-com.checkout_com_get_event_types
ParameterTypeRequiredDescription
No parameters.
get_workflow_event Read

Get the details of an event Official Checkout.com endpoint: GET /workflows/events/{eventId}.

Lua path
app.integrations.checkout_com.get_workflow_event
Full name
checkout-com.checkout_com_get_workflow_event
ParameterTypeRequiredDescription
event_id string yes The event identifier
get_workflow_action_invocations Read

Get the details of a workflow action executed for the specified event. Official Checkout.com endpoint: GET /workflows/events/{eventId}/actions/{workflowActionId}.

Lua path
app.integrations.checkout_com.get_workflow_action_invocations
Full name
checkout-com.checkout_com_get_workflow_action_invocations
ParameterTypeRequiredDescription
event_id string yes The event identifier
workflow_action_id string yes The workflow action identifier
reflow_by_event Read

Reflows a past event denoted by the event ID and triggers the actions of any workflows with matching conditions. Official Checkout.com endpoint: POST /workflows/events/{eventId}/reflow.

Lua path
app.integrations.checkout_com.reflow_by_event
Full name
checkout-com.checkout_com_reflow_by_event
ParameterTypeRequiredDescription
event_id string yes The unique identifier for the event to be reflowed.
body object no Request body matching the official Checkout.com OpenAPI schema.
reflow_by_event_and_workflow Read

Reflows a past event by event ID and workflow ID. Triggers all the actions of a specific event and workflow combination if the event denoted by the event ID matches the workflow conditions. Official Checkout.com endpoint: POST /workflows/events/{eventId}/workflow/{workflowId}/reflow.

Lua path
app.integrations.checkout_com.reflow_by_event_and_workflow
Full name
checkout-com.checkout_com_reflow_by_event_and_workflow
ParameterTypeRequiredDescription
event_id string yes The unique identifier for the event to be reflowed.
workflow_id string yes The identifier of the workflow whose actions you want to trigger.
body object no Request body matching the official Checkout.com OpenAPI schema.
reflow_events Read

Reflow past events attached to multiple event IDs and workflow IDs, or to multiple subject IDs and workflow IDs. If you don't specify any workflow IDs, all matching workflows will be retriggered. Official Checkout.com endpoint: POST /workflows/events/reflow.

Lua path
app.integrations.checkout_com.reflow_events
Full name
checkout-com.checkout_com_reflow_events
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_subject_events Read

Get all events that relate to a specific subject Official Checkout.com endpoint: GET /workflows/events/subject/{subjectId}.

Lua path
app.integrations.checkout_com.get_subject_events
Full name
checkout-com.checkout_com_get_subject_events
ParameterTypeRequiredDescription
subject_id string yes The event identifier
reflow_by_subject Read

Reflows the events associated with a subject ID (for example, a payment ID or a dispute ID) and triggers the actions of any workflows with matching conditions. Official Checkout.com endpoint: POST /workflows/events/subject/{subjectId}/reflow.

Lua path
app.integrations.checkout_com.reflow_by_subject
Full name
checkout-com.checkout_com_reflow_by_subject
ParameterTypeRequiredDescription
subject_id string yes The subject identifier (for example, a payment ID or a dispute ID). The events associated with these subjects will be reflowed.
body object no Request body matching the official Checkout.com OpenAPI schema.
reflow_by_subject_and_workflow Read

Reflows the events associated with a subject ID (for example, a payment ID or a dispute ID) and triggers the actions of the specified workflow if the conditions match. Official Checkout.com endpoint: POST /workflows/events/subject/{subjectId}/workflow/{workflowId}/reflow.

Lua path
app.integrations.checkout_com.reflow_by_subject_and_workflow
Full name
checkout-com.checkout_com_reflow_by_subject_and_workflow
ParameterTypeRequiredDescription
subject_id string yes The subject identifier (for example, a payment ID or a dispute ID). The events associated with these subjects will be reflowed.
workflow_id string yes The identifier of the workflow whose actions you want to trigger.
body object no Request body matching the official Checkout.com OpenAPI schema.
get_fx_rates Read

Get the indicative foreign exchange (FX) rates that Checkout.com uses to process payments for the following products: - Card Payouts - Daily acquiring >Note: Ensure that you have the relevant product enabled for your account. Otherwise, you receive a `403 Forbidden` error response. Official Checkout.com endpoint: GET /forex/rates.

Lua path
app.integrations.checkout_com.get_fx_rates
Full name
checkout-com.checkout_com_get_fx_rates
ParameterTypeRequiredDescription
product string yes product
source string yes source
currency_pairs string yes currency_pairs
processing_channel_id string yes processing_channel_id
forward_request Write

Beta Forwards an API request to a third-party endpoint. For example, you can forward payment credentials you've stored in our Vault to a third-party payment processor. Official Checkout.com endpoint: POST /forward.

Lua path
app.integrations.checkout_com.forward_request
Full name
checkout-com.checkout_com_forward_request
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_forward_request Write

Retrieve the details of a successfully forwarded API request. The details can be retrieved for up to 14 days after the request was initiated. Official Checkout.com endpoint: GET /forward/{id}.

Lua path
app.integrations.checkout_com.get_forward_request
Full name
checkout-com.checkout_com_get_forward_request
ParameterTypeRequiredDescription
id string yes The unique identifier of the forward request.
create_secret Write

Create a new secret with a plaintext value. **Validation Rules:** - `name`: 1-64 characters, alphanumeric + underscore - `value`: max 8KB - `entity_id` (optional): when provided, secret is scoped to this entity **Response:** Returns metadata. Official Checkout.com endpoint: POST /forward/secrets.

Lua path
app.integrations.checkout_com.create_secret
Full name
checkout-com.checkout_com_create_secret
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
list_secrets Read

Returns metadata for secrets scoped for client_id. Official Checkout.com endpoint: GET /forward/secrets.

Lua path
app.integrations.checkout_com.list_secrets
Full name
checkout-com.checkout_com_list_secrets
ParameterTypeRequiredDescription
No parameters.
update_secret Write

Update an existing secret. After updating, the version is automatically incremented. **Validation Rules:** - Only `value` and `entity_id` can be updated - `value`: max 8KB **Response:** Returns updated metadata with incremented version. Official Checkout.com endpoint: PATCH /forward/secrets/{name}.

Lua path
app.integrations.checkout_com.update_secret
Full name
checkout-com.checkout_com_update_secret
ParameterTypeRequiredDescription
name string yes Secret name.
body object yes Request body matching the official Checkout.com OpenAPI schema.
delete_secret Write

Permanently delete a secret by name. Official Checkout.com endpoint: DELETE /forward/secrets/{name}.

Lua path
app.integrations.checkout_com.delete_secret
Full name
checkout-com.checkout_com_delete_secret
ParameterTypeRequiredDescription
name string yes Secret name.
google_pay_enroll_merchant Read

Enroll an entity to the Google Pay Service. You must accept the Google terms of service to use this feature. Official Checkout.com endpoint: POST /googlepay/enrollments.

Lua path
app.integrations.checkout_com.google_pay_enroll_merchant
Full name
checkout-com.checkout_com_google_pay_enroll_merchant
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
google_pay_register_domain Read

Associates a web domain with the specified enrolled entity. Official Checkout.com endpoint: POST /googlepay/enrollments/{entity_id}/domain.

Lua path
app.integrations.checkout_com.google_pay_register_domain
Full name
checkout-com.checkout_com_google_pay_register_domain
ParameterTypeRequiredDescription
entity_id string yes Unique identifier of the entity.
body object no Request body matching the official Checkout.com OpenAPI schema.
google_pay_get_registered_domains Read

Retrieves all web domains registered for the specified entity. Official Checkout.com endpoint: GET /googlepay/enrollments/{entity_id}/domains.

Lua path
app.integrations.checkout_com.google_pay_get_registered_domains
Full name
checkout-com.checkout_com_google_pay_get_registered_domains
ParameterTypeRequiredDescription
entity_id string yes Unique identifier of the entity.
google_pay_get_enrollment_state Read

Returns the current enrollment state of an entity. Official Checkout.com endpoint: GET /googlepay/enrollments/{entity_id}/state.

Lua path
app.integrations.checkout_com.google_pay_get_enrollment_state
Full name
checkout-com.checkout_com_google_pay_get_enrollment_state
ParameterTypeRequiredDescription
entity_id string yes Unique identifier of the entity.
create_hosted_payments_session Write

Create a Hosted Payments Page session and pass through all the payment information, like the amount, currency, country and reference. To get started with our Hosted Payments Page, contact your solutions engineer or request support. Official Checkout.com endpoint: POST /hosted-payments.

Lua path
app.integrations.checkout_com.create_hosted_payments_session
Full name
checkout-com.checkout_com_create_a_hosted_payments_session
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_hosted_payments_page_details Read

Retrieve details about a specific Hosted Payments Page using the ID returned when it was created. In the response, you will see the status of the Hosted Payments Page. For more information, see the Hosted Payments Page documentation. Official Checkout.com endpoint: GET /hosted-payments/{id}.

Lua path
app.integrations.checkout_com.get_hosted_payments_page_details
Full name
checkout-com.checkout_com_get_hosted_payments_page_details
ParameterTypeRequiredDescription
id object yes id
create_id_document_verification Write

Beta Create an [ID document verification](https://www.checkout.com/docs/business-operations/manage-identities/verify-id-documents) for an applicant. Ensure you use your ID Document Verification [configuration ID](https://www.checkout.com/docs/business-operations/manage-identities/verify-id-documents#Configuration). Official Checkout.com endpoint: POST /id-document-verifications.

Lua path
app.integrations.checkout_com.create_id_document_verification
Full name
checkout-com.checkout_com_create_id_document_verification
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
retrieve_id_document_verification Read

Beta Get the details of an existing [ID document verification](https://www.checkout.com/docs/business-operations/manage-identities/verify-id-documents). Official Checkout.com endpoint: GET /id-document-verifications/{id_document_verification_id}.

Lua path
app.integrations.checkout_com.retrieve_id_document_verification
Full name
checkout-com.checkout_com_retrieve_id_document_verification
ParameterTypeRequiredDescription
id_document_verification_id string yes The ID document verification's unique identifier.
anonymize_id_document_verification Read

Beta Remove the personal data from an [ID document verification](https://www.checkout.com/docs/business-operations/manage-identities/verify-id-documents). Official Checkout.com endpoint: POST /id-document-verifications/{id_document_verification_id}/anonymize.

Lua path
app.integrations.checkout_com.anonymize_id_document_verification
Full name
checkout-com.checkout_com_anonymize_id_document_verification
ParameterTypeRequiredDescription
id_document_verification_id string yes The ID document verification's unique identifier.
body object no Request body matching the official Checkout.com OpenAPI schema.
create_id_document_verification_attempt Write

Create an ID document verification attempt Official Checkout.com endpoint: POST /id-document-verifications/{id_document_verification_id}/attempts.

Lua path
app.integrations.checkout_com.create_id_document_verification_attempt
Full name
checkout-com.checkout_com_create_id_document_verification_attempt
ParameterTypeRequiredDescription
id_document_verification_id string yes The ID document verification's unique identifier.
body object no Request body matching the official Checkout.com OpenAPI schema.
list_attempts_id_document_verification Read

Beta Get the details of all attempts for a specific [ID document verification](https://www.checkout.com/docs/business-operations/manage-identities/verify-id-documents). Official Checkout.com endpoint: GET /id-document-verifications/{id_document_verification_id}/attempts.

Lua path
app.integrations.checkout_com.list_attempts_id_document_verification
Full name
checkout-com.checkout_com_list_attempts_id_document_verification
ParameterTypeRequiredDescription
id_document_verification_id string yes The ID document verification's unique identifier.
get_id_document_verification_attempt Read

Beta Get the details of a specific attempt for an [ID document verification](https://www.checkout.com/docs/business-operations/manage-identities/verify-id-documents). Official Checkout.com endpoint: GET /id-document-verifications/{id_document_verification_id}/attempts/{attempt_id}.

Lua path
app.integrations.checkout_com.get_id_document_verification_attempt
Full name
checkout-com.checkout_com_get_id_document_verification_attempt
ParameterTypeRequiredDescription
id_document_verification_id string yes The ID document verification's unique identifier.
attempt_id string yes The attempt's unique identifier.
pdf_id_document_verification Read

Get ID document verification report Official Checkout.com endpoint: GET /id-document-verifications/{id_document_verification_id}/pdf-report.

Lua path
app.integrations.checkout_com.pdf_id_document_verification
Full name
checkout-com.checkout_com_pdf_id_document_verification
ParameterTypeRequiredDescription
id_document_verification_id string yes The ID document verification's unique identifier.
create_applicant Write

Create a profile for an [Identities applicant](https://www.checkout.com/docs/business-operations/manage-identities/manage-applicants). Official Checkout.com endpoint: POST /applicants.

Lua path
app.integrations.checkout_com.create_applicant
Full name
checkout-com.checkout_com_create_applicant
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
retrieve_applicant Read

Get the details of an [applicant profile](https://www.checkout.com/docs/business-operations/manage-identities/manage-applicants). Official Checkout.com endpoint: GET /applicants/{applicant_id}.

Lua path
app.integrations.checkout_com.retrieve_applicant
Full name
checkout-com.checkout_com_retrieve_applicant
ParameterTypeRequiredDescription
applicant_id string yes The applicant profile's unique identifier.
update_applicant Write

Update the details of an [applicant profile](https://www.checkout.com/docs/business-operations/manage-identities/manage-applicants). Official Checkout.com endpoint: PATCH /applicants/{applicant_id}.

Lua path
app.integrations.checkout_com.update_applicant
Full name
checkout-com.checkout_com_update_applicant
ParameterTypeRequiredDescription
applicant_id string yes The applicant profile's unique identifier.
body object no Request body matching the official Checkout.com OpenAPI schema.
anonymize_applicant Read

Remove the personal data in an [applicant profile](https://www.checkout.com/docs/business-operations/manage-identities/manage-applicants). Official Checkout.com endpoint: POST /applicants/{applicant_id}/anonymize.

Lua path
app.integrations.checkout_com.anonymize_applicant
Full name
checkout-com.checkout_com_anonymize_applicant
ParameterTypeRequiredDescription
applicant_id string yes The applicant profile's unique identifier.
body object no Request body matching the official Checkout.com OpenAPI schema.
create_and_start_identity_verification Write

Create an identity verification and attempt Official Checkout.com endpoint: POST /create-and-open-idv.

Lua path
app.integrations.checkout_com.create_and_start_identity_verification
Full name
checkout-com.checkout_com_create_and_start_identity_verification
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
create_identity_verification Write

Beta Create an [identity verification](https://www.checkout.com/docs/business-operations/manage-identities/verify-identities) linked to an applicant. If successful, you receive a `201 Created` response with the identity verification resource. Ensure you use your identity verification [configuration ID](https://www.checkout.com/docs/business-operations/manage-identities/verify-identities#Configuration). Official Checkout.com endpoint: POST /identity-verifications.

Lua path
app.integrations.checkout_com.create_identity_verification
Full name
checkout-com.checkout_com_create_identity_verification
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
retrieve_identity_verification Read

Beta Get the details of an existing [identity verification](https://www.checkout.com/docs/business-operations/manage-identities/verify-identities). Official Checkout.com endpoint: GET /identity-verifications/{identity_verification_id}.

Lua path
app.integrations.checkout_com.retrieve_identity_verification
Full name
checkout-com.checkout_com_retrieve_identity_verification
ParameterTypeRequiredDescription
identity_verification_id string yes The identity verification's unique identifier.
anonymize_identity_verification Read

Beta Remove the personal data in an [identity verification](https://www.checkout.com/docs/business-operations/manage-identities/verify-identities). Official Checkout.com endpoint: POST /identity-verifications/{identity_verification_id}/anonymize.

Lua path
app.integrations.checkout_com.anonymize_identity_verification
Full name
checkout-com.checkout_com_anonymize_identity_verification
ParameterTypeRequiredDescription
identity_verification_id string yes The identity verification's unique identifier.
body object no Request body matching the official Checkout.com OpenAPI schema.
create_attempt Write

Create an identity verification attempt Official Checkout.com endpoint: POST /identity-verifications/{identity_verification_id}/attempts.

Lua path
app.integrations.checkout_com.create_attempt
Full name
checkout-com.checkout_com_create_attempt
ParameterTypeRequiredDescription
identity_verification_id string yes The identity verification's unique identifier.
body object no Request body matching the official Checkout.com OpenAPI schema.
list_attempts Read

Beta Get all the attempts for a specific [identity verification](https://www.checkout.com/docs/business-operations/manage-identities/verify-identities). Official Checkout.com endpoint: GET /identity-verifications/{identity_verification_id}/attempts.

Lua path
app.integrations.checkout_com.list_attempts
Full name
checkout-com.checkout_com_list_attempts
ParameterTypeRequiredDescription
identity_verification_id string yes The identity verification's unique identifier.
get_attempt Read

Beta Get the details of a specific attempt for an [identity verification](https://www.checkout.com/docs/business-operations/manage-identities/verify-identities). Official Checkout.com endpoint: GET /identity-verifications/{identity_verification_id}/attempts/{attempt_id}.

Lua path
app.integrations.checkout_com.get_attempt
Full name
checkout-com.checkout_com_get_attempt
ParameterTypeRequiredDescription
identity_verification_id string yes The identity verification's unique identifier.
attempt_id string yes The attempt's unique identifier.
pdf_identity_verification Read

Get identity verification report Official Checkout.com endpoint: GET /identity-verifications/{identity_verification_id}/pdf-report.

Lua path
app.integrations.checkout_com.pdf_identity_verification
Full name
checkout-com.checkout_com_pdf_identity_verification
ParameterTypeRequiredDescription
identity_verification_id string yes The identity verification's unique identifier.
create_instrument Write

Create a payment instrument like card, bank, ach or sepa to use for future payments and payouts. The parameters you need to provide when creating a bank account payment instrument depend on the account's country and currency. See the payout formatting documentation, or use the `GET /validation/bank-accounts/{country}/{currency}` endpoint. Official Checkout.com endpoint: POST /instruments.

Lua path
app.integrations.checkout_com.create_instrument
Full name
checkout-com.checkout_com_create_an_instrument
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_instrument_details Read

Retrieve the details of a payment instrument. Official Checkout.com endpoint: GET /instruments/{id}.

Lua path
app.integrations.checkout_com.get_instrument_details
Full name
checkout-com.checkout_com_get_instrument_details
ParameterTypeRequiredDescription
id string yes The instrument ID
update_instrument Write

Update the details of a payment instrument. Official Checkout.com endpoint: PATCH /instruments/{id}.

Lua path
app.integrations.checkout_com.update_instrument
Full name
checkout-com.checkout_com_update_instrument
ParameterTypeRequiredDescription
id string yes The instrument ID
body object yes Request body matching the official Checkout.com OpenAPI schema.
delete_instrument Write

Delete a payment instrument. Official Checkout.com endpoint: DELETE /instruments/{id}.

Lua path
app.integrations.checkout_com.delete_instrument
Full name
checkout-com.checkout_com_delete_instrument
ParameterTypeRequiredDescription
id string yes The ID of the payment instrument to be deleted
request_cardholder_access_token Read

OAuth endpoint to exchange your access key ID and access key secret for an access token. Official Checkout.com endpoint: POST /issuing/access/connect/token.

Lua path
app.integrations.checkout_com.request_cardholder_access_token
Full name
checkout-com.checkout_com_request_cardholder_access_token
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
create_cardholder Write

Create a new cardholder that you can issue a card to at a later point. Official Checkout.com endpoint: POST /issuing/cardholders.

Lua path
app.integrations.checkout_com.create_cardholder
Full name
checkout-com.checkout_com_create_cardholder
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_cardholder Read

Retrieve the details for a cardholder you created previously. Official Checkout.com endpoint: GET /issuing/cardholders/{cardholderId}.

Lua path
app.integrations.checkout_com.get_cardholder
Full name
checkout-com.checkout_com_get_cardholder
ParameterTypeRequiredDescription
cardholder_id string yes cardholderId
update_cardholder Write

Updates the details of an existing cardholder. Official Checkout.com endpoint: PATCH /issuing/cardholders/{cardholderId}.

Lua path
app.integrations.checkout_com.update_cardholder
Full name
checkout-com.checkout_com_update_cardholder
ParameterTypeRequiredDescription
cardholder_id string yes cardholderId
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_cardholder_cards Read

Retrieves the cards issued to the specified cardholder. Card credentials are not returned in the response. The response is limited to a maximum of 150 cards. Official Checkout.com endpoint: GET /issuing/cardholders/{cardholderId}/cards.

Lua path
app.integrations.checkout_com.get_cardholder_cards
Full name
checkout-com.checkout_com_get_cardholder_cards
ParameterTypeRequiredDescription
cardholder_id string yes cardholderId
statuses string no The card statuses to filter the results by. Cards matching any status in this list are returned. If the list is empty, all cards are returned. Format - Comma-separated list
create_card Write

Creates a physical or virtual card and issues it to the specified cardholder. Official Checkout.com endpoint: POST /issuing/cards.

Lua path
app.integrations.checkout_com.create_card
Full name
checkout-com.checkout_com_create_card
ParameterTypeRequiredDescription
cko_idempotency_key string no An optional idempotency key for safely retrying Issuing requests.
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_card Read

Retrieves the details for a card you issued previously. The card's credentials are not returned in the response. Official Checkout.com endpoint: GET /issuing/cards/{cardId}.

Lua path
app.integrations.checkout_com.get_card
Full name
checkout-com.checkout_com_get_card
ParameterTypeRequiredDescription
card_id string yes cardId
update_card Write

Update the details of an issued card. Only the fields for which you provide values will be updated. If you pass `null`, the existing value will be removed. Official Checkout.com endpoint: PATCH /issuing/cards/{cardId}.

Lua path
app.integrations.checkout_com.update_card
Full name
checkout-com.checkout_com_update_card
ParameterTypeRequiredDescription
card_id string yes cardId
body object yes Request body matching the official Checkout.com OpenAPI schema.
enroll_card Read

Enrolls a card in 3D Secure (3DS). Additional information is requested from the cardholder through a 3DS challenge when performing a transaction. Two-factor authentication (2FA) is supported. For maximum security, we recommend using a combination of a one-time password (OTP) sent via SMS, along with a password or question and answer security pair. Official Checkout.com endpoint: POST /issuing/cards/{cardId}/3ds-enrollment.

Lua path
app.integrations.checkout_com.enroll_card
Full name
checkout-com.checkout_com_enroll_card
ParameterTypeRequiredDescription
card_id string yes cardId
body object yes Request body matching the official Checkout.com OpenAPI schema.
update_card_enrollment_details Write

Updates a card's 3DS enrollment details. At least one of the fields is required. Official Checkout.com endpoint: PATCH /issuing/cards/{cardId}/3ds-enrollment.

Lua path
app.integrations.checkout_com.update_card_enrollment_details
Full name
checkout-com.checkout_com_update_card_enrollment_details
ParameterTypeRequiredDescription
card_id string yes cardId
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_card_enrollment_details Read

Retrieves a card's 3DS enrollment details. Official Checkout.com endpoint: GET /issuing/cards/{cardId}/3ds-enrollment.

Lua path
app.integrations.checkout_com.get_card_enrollment_details
Full name
checkout-com.checkout_com_get_card_enrollment_details
ParameterTypeRequiredDescription
card_id string yes cardId
activate_card Write

Activates an `inactive` or `suspended` card so that incoming authorizations can be approved. Activating a renewed card will schedule the parent card for revocation the following day, and transfer all configurations to the newly activated card. This includes 3DS enrollment, card controls, control profiles and tokenisation. Official Checkout.com endpoint: POST /issuing/cards/{cardId}/activate.

Lua path
app.integrations.checkout_com.activate_card
Full name
checkout-com.checkout_com_activate_card
ParameterTypeRequiredDescription
card_id string yes cardId
body object no Request body matching the official Checkout.com OpenAPI schema.
get_card_credentials Read

Retrieves the credentials for a card you issued previously. Official Checkout.com endpoint: GET /issuing/cards/{cardId}/credentials.

Lua path
app.integrations.checkout_com.get_card_credentials
Full name
checkout-com.checkout_com_get_card_credentials
ParameterTypeRequiredDescription
card_id string yes cardId
credentials string no credentials
renew_card Read

Renew a card Official Checkout.com endpoint: POST /issuing/cards/{cardId}/renew.

Lua path
app.integrations.checkout_com.renew_card
Full name
checkout-com.checkout_com_renew_card
ParameterTypeRequiredDescription
card_id string yes cardId
body object yes Request body matching the official Checkout.com OpenAPI schema.
revoke_card Read

Revokes an `inactive`, `active`, or `suspended` card to permanently decline all incoming authorizations. This is a permanent action. Revoked cards cannot be reactivated. Official Checkout.com endpoint: POST /issuing/cards/{cardId}/revoke.

Lua path
app.integrations.checkout_com.revoke_card
Full name
checkout-com.checkout_com_revoke_card
ParameterTypeRequiredDescription
card_id string yes cardId
body object yes Request body matching the official Checkout.com OpenAPI schema.
add_scheduled_revocation_date Write

Schedules a card to be revoked at 00:00(UTC) on a specified date. Official Checkout.com endpoint: POST /issuing/cards/{cardId}/schedule-revocation.

Lua path
app.integrations.checkout_com.add_scheduled_revocation_date
Full name
checkout-com.checkout_com_add_scheduled_revocation_date
ParameterTypeRequiredDescription
card_id string yes cardId
body object yes Request body matching the official Checkout.com OpenAPI schema.
delete_scheduled_revocation_date Write

Delete a card's scheduled revocation. Official Checkout.com endpoint: DELETE /issuing/cards/{cardId}/schedule-revocation.

Lua path
app.integrations.checkout_com.delete_scheduled_revocation_date
Full name
checkout-com.checkout_com_delete_scheduled_revocation_date
ParameterTypeRequiredDescription
card_id string yes cardId
suspend_card Read

Suspends an `active` or `inactive` card to temporarily decline all incoming authorizations. A `suspended` card can be reactivated. Official Checkout.com endpoint: POST /issuing/cards/{cardId}/suspend.

Lua path
app.integrations.checkout_com.suspend_card
Full name
checkout-com.checkout_com_suspend_card
ParameterTypeRequiredDescription
card_id string yes cardId
body object yes Request body matching the official Checkout.com OpenAPI schema.
create_control Write

Creates a control and applies it to the specified target. Official Checkout.com endpoint: POST /issuing/controls.

Lua path
app.integrations.checkout_com.create_control
Full name
checkout-com.checkout_com_create_control
ParameterTypeRequiredDescription
cko_idempotency_key string no An optional idempotency key for safely retrying Issuing requests.
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_control_by_target Read

Retrieves a list of spending controls applied to the specified target. Official Checkout.com endpoint: GET /issuing/controls.

Lua path
app.integrations.checkout_com.get_control_by_target
Full name
checkout-com.checkout_com_get_control_by_target
ParameterTypeRequiredDescription
target_id string yes target_id
get_control Read

Retrieves the details of an existing control. Official Checkout.com endpoint: GET /issuing/controls/{controlId}.

Lua path
app.integrations.checkout_com.get_control
Full name
checkout-com.checkout_com_get_control
ParameterTypeRequiredDescription
control_id string yes controlId
card_id string no The unique identifier for the card you want to get the remaining cascading velocity control for.
update_control Write

Updates an existing control. Official Checkout.com endpoint: PUT /issuing/controls/{controlId}.

Lua path
app.integrations.checkout_com.update_control
Full name
checkout-com.checkout_com_update_control
ParameterTypeRequiredDescription
control_id string yes controlId
body object yes Request body matching the official Checkout.com OpenAPI schema.
delete_control Write

Removes an existing control from the target it was applied to. If you want to reapply an equivalent control to the target, you must create a new control. Official Checkout.com endpoint: DELETE /issuing/controls/{controlId}.

Lua path
app.integrations.checkout_com.delete_control
Full name
checkout-com.checkout_com_delete_control
ParameterTypeRequiredDescription
control_id string yes controlId
create_control_group Write

Creates a control group and applies it to the specified target. Official Checkout.com endpoint: POST /issuing/controls/control-groups.

Lua path
app.integrations.checkout_com.create_control_group
Full name
checkout-com.checkout_com_create_control_group
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_control_group_by_target Read

Retrieves a list of control groups applied to the specified target. Official Checkout.com endpoint: GET /issuing/controls/control-groups.

Lua path
app.integrations.checkout_com.get_control_group_by_target
Full name
checkout-com.checkout_com_get_control_group_by_target
ParameterTypeRequiredDescription
target_id string yes target_id
get_control_group Read

Retrieves the details of a control group you created previously. Official Checkout.com endpoint: GET /issuing/controls/control-groups/{controlGroupId}.

Lua path
app.integrations.checkout_com.get_control_group
Full name
checkout-com.checkout_com_get_control_group
ParameterTypeRequiredDescription
control_group_id string yes controlGroupId
delete_control_group Write

Removes the control group and all the controls it contains. If you want to reapply an equivalent control group to the card, you'll need to create a new control group. Official Checkout.com endpoint: DELETE /issuing/controls/control-groups/{controlGroupId}.

Lua path
app.integrations.checkout_com.delete_control_group
Full name
checkout-com.checkout_com_delete_control_group
ParameterTypeRequiredDescription
control_group_id string yes controlGroupId
create_control_profile Write

Creates a control profile. Official Checkout.com endpoint: POST /issuing/controls/control-profiles.

Lua path
app.integrations.checkout_com.create_control_profile
Full name
checkout-com.checkout_com_create_control_profile
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_control_profiles_by_target Read

Retrieves a list of control profiles for the currently authenticated client, or for a specific card if a card ID is provided. Official Checkout.com endpoint: GET /issuing/controls/control-profiles.

Lua path
app.integrations.checkout_com.get_control_profiles_by_target
Full name
checkout-com.checkout_com_get_control_profiles_by_target
ParameterTypeRequiredDescription
target_id string no target_id
get_control_profile Read

Retrieves the details of an existing control profile. Official Checkout.com endpoint: GET /issuing/controls/control-profiles/{controlProfileId}.

Lua path
app.integrations.checkout_com.get_control_profile
Full name
checkout-com.checkout_com_get_control_profile
ParameterTypeRequiredDescription
control_profile_id string yes controlProfileId
update_control_profile Write

Update the control profile Official Checkout.com endpoint: PATCH /issuing/controls/control-profiles/{controlProfileId}.

Lua path
app.integrations.checkout_com.update_control_profile
Full name
checkout-com.checkout_com_update_control_profile
ParameterTypeRequiredDescription
control_profile_id string yes controlProfileId
body object yes Request body matching the official Checkout.com OpenAPI schema.
delete_control_profile Write

Removes the control profile. A control profile cannot be removed if it is used by a control. Official Checkout.com endpoint: DELETE /issuing/controls/control-profiles/{controlProfileId}.

Lua path
app.integrations.checkout_com.delete_control_profile
Full name
checkout-com.checkout_com_delete_control_profile
ParameterTypeRequiredDescription
control_profile_id string yes controlProfileId
add_target_control_profile Write

Adds a target to an existing control profile. Official Checkout.com endpoint: POST /issuing/controls/control-profiles/{controlProfileId}/add/{targetId}.

Lua path
app.integrations.checkout_com.add_target_control_profile
Full name
checkout-com.checkout_com_add_target_to_control_profile
ParameterTypeRequiredDescription
control_profile_id string yes controlProfileId
target_id string yes targetId
body object no Request body matching the official Checkout.com OpenAPI schema.
remove_target_from_control_profile Write

Removes a target from an existing control profile. Official Checkout.com endpoint: POST /issuing/controls/control-profiles/{controlProfileId}/remove/{targetId}.

Lua path
app.integrations.checkout_com.remove_target_from_control_profile
Full name
checkout-com.checkout_com_remove_target_from_control_profile
ParameterTypeRequiredDescription
control_profile_id string yes controlProfileId
target_id string yes targetId
body object no Request body matching the official Checkout.com OpenAPI schema.
get_digital_card Read

Retrieves the details for a digital card. Official Checkout.com endpoint: GET /issuing/digital-cards/{digitalCardId}.

Lua path
app.integrations.checkout_com.get_digital_card
Full name
checkout-com.checkout_com_get_digital_card
ParameterTypeRequiredDescription
digital_card_id string yes digitalCardId
create_dispute Write

Beta Create a dispute for an Issuing transaction. For full guidance, see [Manage Issuing disputes](https://www.checkout.com/docs/card-issuing/manage-cardholder-transactions/manage-issuing-disputes). The transaction must already be cleared and not refunded. For the card scheme to process the chargeback, you must submit the dispute using this endpoint. Official Checkout.com endpoint: POST /issuing/disputes.

Lua path
app.integrations.checkout_com.create_dispute
Full name
checkout-com.checkout_com_create_dispute
ParameterTypeRequiredDescription
cko_idempotency_key string yes An idempotency key for safely retrying requests.
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_dispute Read

Beta Retrieve the details of an [Issuing dispute](https://www.checkout.com/docs/card-issuing/manage-cardholder-transactions/manage-issuing-disputes). Official Checkout.com endpoint: GET /issuing/disputes/{disputeId}.

Lua path
app.integrations.checkout_com.get_dispute
Full name
checkout-com.checkout_com_get_dispute
ParameterTypeRequiredDescription
dispute_id string yes disputeId
cancel_dispute Write

Beta Cancel an [Issuing dispute](https://www.checkout.com/docs/card-issuing/manage-cardholder-transactions/manage-issuing-disputes). If you decide not to proceed with a dispute, you can cancel it either: * Before you submit it * While the dispute `status` is `processing` and `status_reason` is `chargeback_pending` or `chargeback_processed` For more information, see Cancel a dispute. Official Checkout.com endpoint: POST /issuing/disputes/{disputeId}/cancel.

Lua path
app.integrations.checkout_com.cancel_dispute
Full name
checkout-com.checkout_com_cancel_dispute
ParameterTypeRequiredDescription
cko_idempotency_key string yes An idempotency key for safely retrying requests.
dispute_id string yes disputeId
body object no Request body matching the official Checkout.com OpenAPI schema.
escalate_dispute Read

Beta Escalate an [Issuing dispute](https://www.checkout.com/docs/card-issuing/manage-cardholder-transactions/manage-issuing-disputes) to pre-arbitration or arbitration. Official Checkout.com endpoint: POST /issuing/disputes/{disputeId}/escalate.

Lua path
app.integrations.checkout_com.escalate_dispute
Full name
checkout-com.checkout_com_escalate_dispute
ParameterTypeRequiredDescription
cko_idempotency_key string yes An idempotency key for safely retrying requests.
dispute_id string yes disputeId
body object no Request body matching the official Checkout.com OpenAPI schema.
simulate_authorization Read

Simulate an authorization request with a card you issued previously. Official Checkout.com endpoint: POST /issuing/simulate/authorizations.

Lua path
app.integrations.checkout_com.simulate_authorization
Full name
checkout-com.checkout_com_simulate_authorization
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
simulate_incremental_authorization Read

Simulate an incremental authorization request for an existing approved transaction. Incremental authorizations increase the total authorized amount of the transaction. For example, adding a restaurant bill to an existing hotel booking. Official Checkout.com endpoint: POST /issuing/simulate/authorizations/{id}/authorizations.

Lua path
app.integrations.checkout_com.simulate_incremental_authorization
Full name
checkout-com.checkout_com_simulate_incremental_authorization
ParameterTypeRequiredDescription
id string yes id
body object yes Request body matching the official Checkout.com OpenAPI schema.
simulate_presentment Read

Simulate the clearing of an existing approved authorization. Official Checkout.com endpoint: POST /issuing/simulate/authorizations/{id}/presentments.

Lua path
app.integrations.checkout_com.simulate_presentment
Full name
checkout-com.checkout_com_simulate_presentment
ParameterTypeRequiredDescription
id string yes id
body object yes Request body matching the official Checkout.com OpenAPI schema.
simulate_refund Read

Simulate the refund of an existing approved authorization, after it has been cleared. Official Checkout.com endpoint: POST /issuing/simulate/authorizations/{id}/refunds.

Lua path
app.integrations.checkout_com.simulate_refund
Full name
checkout-com.checkout_com_simulate_refund
ParameterTypeRequiredDescription
id string yes id
body object yes Request body matching the official Checkout.com OpenAPI schema.
simulate_reversal Read

Simulate the reversal of an existing approved authorization. Official Checkout.com endpoint: POST /issuing/simulate/authorizations/{id}/reversals.

Lua path
app.integrations.checkout_com.simulate_reversal
Full name
checkout-com.checkout_com_simulate_reversal
ParameterTypeRequiredDescription
id string yes id
body object yes Request body matching the official Checkout.com OpenAPI schema.
simulate_oob_authentication Read

Simulate a request to your back-end from an out-of-band (OOB) authentication provider. Official Checkout.com endpoint: POST /issuing/simulate/oob/authentication.

Lua path
app.integrations.checkout_com.simulate_oob_authentication
Full name
checkout-com.checkout_com_simulate_oob_authentication
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
get_transactions Read

Beta Returns a list of transactions based on the matching input parameters in reverse chronological order, with the most recent transactions shown first. Official Checkout.com endpoint: GET /issuing/transactions.

Lua path
app.integrations.checkout_com.get_transactions
Full name
checkout-com.checkout_com_get_transactions
ParameterTypeRequiredDescription
limit number no The maximum number of transactions returned (between 10-100). The default is 10.
skip number no The number of transactions to skip. The default is 0.
cardholder_id string no cardholder_id
card_id string no card_id
entity_id string no entity_id
status string no An optional filter for the transaction lifecycle status.
from string no An optional start date filter for transactions, in ISO 8601 format.
to string no An optional end date filter for transactions, in ISO 8601 format.
get_transaction_by_id Read

Beta Get the details of a transaction using its ID. Official Checkout.com endpoint: GET /issuing/transactions/{transactionId}.

Lua path
app.integrations.checkout_com.get_transaction_by_id
Full name
checkout-com.checkout_com_get_transaction_by_id
ParameterTypeRequiredDescription
transaction_id string yes transactionId
request_card_metadata Read

Beta Returns a single metadata record for the card specified by the Primary Account Number (PAN), Bank Identification Number (BIN), token, or instrument supplied. Official Checkout.com endpoint: POST /metadata/card.

Lua path
app.integrations.checkout_com.request_card_metadata
Full name
checkout-com.checkout_com_request_card_metadata
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
provision_network_token Read

Beta Provisions a network token synchronously. If the merchant stores their cards with Checkout.com, then source ID can be used to request a network token for the given card. If the merchant does not store their cards with Checkout.com, then card details have to be provided. Official Checkout.com endpoint: POST /network-tokens.

Lua path
app.integrations.checkout_com.provision_network_token
Full name
checkout-com.checkout_com_provision_network_token
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
get_network_token Read

Beta Given network token ID, this endpoint returns network token details: DPAN, expiry date, state, TRID and also card details like last four and expiry date. Official Checkout.com endpoint: GET /network-tokens/{network_token_id}.

Lua path
app.integrations.checkout_com.get_network_token
Full name
checkout-com.checkout_com_get_network_token
ParameterTypeRequiredDescription
network_token_id string yes Unique token ID assigned by Checkout.com for each token
provision_cryptogram Read

Beta Using network token ID as an input, this endpoint returns token cryptogram. Official Checkout.com endpoint: POST /network-tokens/{network_token_id}/cryptograms.

Lua path
app.integrations.checkout_com.provision_cryptogram
Full name
checkout-com.checkout_com_provision_cryptogram
ParameterTypeRequiredDescription
network_token_id string yes Unique token ID assigned by Checkout.com for each token
body object no Request body matching the official Checkout.com OpenAPI schema.
delete_network_token Write

Beta This endpoint is for permanently deleting a network token. A network token should be deleted when a payment instrument it is associated with is removed from file or if the security of the token has been compromised. Official Checkout.com endpoint: PATCH /network-tokens/{network_token_id}/delete.

Lua path
app.integrations.checkout_com.delete_network_token
Full name
checkout-com.checkout_com_delete_network_token
ParameterTypeRequiredDescription
network_token_id string yes Unique token ID assigned by Checkout.com for each token
body object no Request body matching the official Checkout.com OpenAPI schema.
request_payment_context Read

Send a Payment Context request.Note: Successful Payment Context requests will always return a 201 response. Official Checkout.com endpoint: POST /payment-contexts.

Lua path
app.integrations.checkout_com.request_payment_context
Full name
checkout-com.checkout_com_request_a_payment_context
ParameterTypeRequiredDescription
cko_idempotency_key string no An optional idempotency key for safely retrying payment requests
body object no Request body matching the official Checkout.com OpenAPI schema.
get_payment_context Read

Returns all the Payment Context details. Official Checkout.com endpoint: GET /payment-contexts/{id}.

Lua path
app.integrations.checkout_com.get_payment_context
Full name
checkout-com.checkout_com_get_payment_context
ParameterTypeRequiredDescription
id string yes id
get_payment_methods Read

Beta Get a list of all available payment methods for a specific Processing Channel ID. Official Checkout.com endpoint: GET /payment-methods.

Lua path
app.integrations.checkout_com.get_payment_methods
Full name
checkout-com.checkout_com_get_payment_methods
ParameterTypeRequiredDescription
processing_channel_id string yes processing_channel_id
create_payment_session Write

Creates a payment session. The values you provide in the request will be used to determine the payment methods available to Flow. Some payment methods may require you to provide specific values for certain fields. Refer to our documentation for more information. You must supply the unmodified response body when you initialize Flow. Official Checkout.com endpoint: POST /payment-sessions.

Lua path
app.integrations.checkout_com.create_payment_session
Full name
checkout-com.checkout_com_create_payment_session
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
submit_payment_session Write

Submit a payment attempt for a payment session. This request works with the Flow handleSubmit callback, where you can perform a customized payment submission. You must send the unmodified response body as the response of the `handleSubmit` callback. Official Checkout.com endpoint: POST /payment-sessions/{id}/submit.

Lua path
app.integrations.checkout_com.submit_payment_session
Full name
checkout-com.checkout_com_submit_payment_session
ParameterTypeRequiredDescription
id string yes The Payment Sessions unique identifier
body object no Request body matching the official Checkout.com OpenAPI schema.
create_and_submit_payment_session Write

Request a Payment Session with Payment Official Checkout.com endpoint: POST /payment-sessions/complete.

Lua path
app.integrations.checkout_com.create_and_submit_payment_session
Full name
checkout-com.checkout_com_create_and_submit_payment_session
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
request_payment_or_payout Read

Send a payment or payout.Note: successful payout requests will always return a 202 response. Official Checkout.com endpoint: POST /payments.

Lua path
app.integrations.checkout_com.request_payment_or_payout
Full name
checkout-com.checkout_com_request_a_payment_or_payout
ParameterTypeRequiredDescription
cko_idempotency_key string no An optional idempotency key for safely retrying payment requests
body object no Request body matching the official Checkout.com OpenAPI schema.
get_payments_list Read

Beta Returns a list of your business' payments that match the specified reference. Results are returned in reverse chronological order, with the most recent payments shown first. This will only return payments initiated from June 2022 onwards. Payments initiated before this date may return a `404` error code if you attempt to retrieve them. Official Checkout.com endpoint: GET /payments.

Lua path
app.integrations.checkout_com.get_payments_list
Full name
checkout-com.checkout_com_get_payments_list
ParameterTypeRequiredDescription
limit number no The numbers of results to retrieve
skip number no The number of results to skip
reference string yes A reference, such as an order ID, that can be used to identify the payment
get_payment_details Read

Returns the details of the payment with the specified identifier string. If the payment method requires a redirection to a third party (e.g., 3D Secure), the redirect URL back to your site will include a `cko-session-id` query parameter containing a payment session ID that can be used to obtain the details of the payment, for example: https://example.com/success?cko-session-id=sid_ubfj2q76miwundwlk72vxt2i7q. Official Checkout.com endpoint: GET /payments/{id}.

Lua path
app.integrations.checkout_com.get_payment_details
Full name
checkout-com.checkout_com_get_payment_details
ParameterTypeRequiredDescription
id string yes The payment or payment session identifier
get_payment_actions Read

Returns all the actions associated with a payment ordered by processing date in descending order (latest first). Official Checkout.com endpoint: GET /payments/{id}/actions.

Lua path
app.integrations.checkout_com.get_payment_actions
Full name
checkout-com.checkout_com_get_payment_actions
ParameterTypeRequiredDescription
id string yes The payment identifier
increment_payment_authorization Read

Request an incremental authorization to increase the authorization amount or extend the authorization's validity period. Official Checkout.com endpoint: POST /payments/{id}/authorizations.

Lua path
app.integrations.checkout_com.increment_payment_authorization
Full name
checkout-com.checkout_com_increment_payment_authorization
ParameterTypeRequiredDescription
cko_idempotency_key string no An optional idempotency key for safely retrying payment requests
id string yes The payment identifier
body object no Request body matching the official Checkout.com OpenAPI schema.
cancel_payment Write

Cancels an upcoming retry, if there is one scheduled Cancellation requests are processed asynchronously. You can use [workflows](#tag/Workflows) to be notified if the cancellation is successful. Official Checkout.com endpoint: POST /payments/{id}/cancellations.

Lua path
app.integrations.checkout_com.cancel_payment
Full name
checkout-com.checkout_com_cancel_a_payment
ParameterTypeRequiredDescription
cko_idempotency_key string no An optional idempotency key for safely retrying payment requests
id string yes The unique payment identifier.
body object no Request body matching the official Checkout.com OpenAPI schema.
capture_payment Read

Captures a payment if supported by the payment method. For card payments, capture requests are processed asynchronously. You can use [workflows](#tag/Workflows) to be notified if the capture is successful. Official Checkout.com endpoint: POST /payments/{id}/captures.

Lua path
app.integrations.checkout_com.capture_payment
Full name
checkout-com.checkout_com_capture_a_payment
ParameterTypeRequiredDescription
cko_idempotency_key string no An optional idempotency key for safely retrying payment requests
id string yes The payment identifier
body object no Request body matching the official Checkout.com OpenAPI schema.
refund_payment Read

Refunds a payment if supported by the payment method. For card payments, refund requests are processed asynchronously. You can use [workflows](#tag/Workflows) to be notified if the refund is successful. Official Checkout.com endpoint: POST /payments/{id}/refunds.

Lua path
app.integrations.checkout_com.refund_payment
Full name
checkout-com.checkout_com_refund_a_payment
ParameterTypeRequiredDescription
cko_idempotency_key string no An optional idempotency key for safely retrying payment requests
id string yes The payment identifier
body object no Request body matching the official Checkout.com OpenAPI schema.
reverse_payment Read

Returns funds back to the customer by automatically performing the appropriate payment action depending on the payment's status. For more information, see Reverse a payment. Official Checkout.com endpoint: POST /payments/{id}/reversals.

Lua path
app.integrations.checkout_com.reverse_payment
Full name
checkout-com.checkout_com_reverse_payment
ParameterTypeRequiredDescription
cko_idempotency_key string no An optional idempotency key for safely retrying payment requests
id string yes The unique identifier for the payment.
body object no Request body matching the official Checkout.com OpenAPI schema.
void_payment Read

Voids a payment if supported by the payment method. For card payments, void requests are processed asynchronously. You can use [workflows](#tag/Workflows) to be notified if the void is successful. Official Checkout.com endpoint: POST /payments/{id}/voids.

Lua path
app.integrations.checkout_com.void_payment
Full name
checkout-com.checkout_com_void_a_payment
ParameterTypeRequiredDescription
cko_idempotency_key string no An optional idempotency key for safely retrying payment requests
id string yes The payment identifier
body object no Request body matching the official Checkout.com OpenAPI schema.
create_payment_setup Write

Beta Creates a Payment Setup. To maximize the information available to the payment setup, create a Payment Setup as early as possible in the customer's journey. For example, create it the first time they land on the basket page. Official Checkout.com endpoint: POST /payments/setups.

Lua path
app.integrations.checkout_com.create_payment_setup
Full name
checkout-com.checkout_com_create_a_payment_setup
ParameterTypeRequiredDescription
body object yes Request body matching the official Checkout.com OpenAPI schema.
update_payment_setup Write

Beta Updates a Payment Setup. Update the Payment Setup whenever there are significant changes in the data relevant to the customer's transaction. For example, when the customer makes a change that impacts the total payment amount. Official Checkout.com endpoint: PUT /payments/setups/{id}.

Lua path
app.integrations.checkout_com.update_payment_setup
Full name
checkout-com.checkout_com_update_a_payment_setup
ParameterTypeRequiredDescription
id string yes The unique identifier of the Payment Setup to update.
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_payment_setup Read

Beta Retrieves a Payment Setup by its unique identifier. Official Checkout.com endpoint: GET /payments/setups/{id}.

Lua path
app.integrations.checkout_com.get_payment_setup
Full name
checkout-com.checkout_com_get_a_payment_setup
ParameterTypeRequiredDescription
id string yes The unique identifier of the Payment Setup to retrieve.
confirm_payment_setup Read

Beta Confirm a Payment Setup to begin processing the payment request with your chosen payment method. Official Checkout.com endpoint: POST /payments/setups/{id}/confirm/{payment_method_name}.

Lua path
app.integrations.checkout_com.confirm_payment_setup
Full name
checkout-com.checkout_com_confirm_a_payment_setup
ParameterTypeRequiredDescription
id string yes The unique identifier of the Payment Setup.
payment_method_name string yes The name of the payment method to process the payment with (For example, `tabby`, `klarna`, `card`).
body object no Request body matching the official Checkout.com OpenAPI schema.
get_reports Read

Returns the list of reports and their details. Official Checkout.com endpoint: GET /reports.

Lua path
app.integrations.checkout_com.get_reports
Full name
checkout-com.checkout_com_get_reports
ParameterTypeRequiredDescription
created_after string no Filters reports to those created on or after the specified timestamp, in UTC. <br/>Format – ISO 8601 code
created_before string no Filters reports to those created before the specified timestamp, in UTC. <br/>Format – ISO 8601 code
entity_id string no Filters reports to those created for the specified entity. <br/>Sub-entity IDs are not supported.
limit number no The number of results you want to include per page. </br> For example, if there are 50 results and you set limit=10, you receive 5 pages each containing 10 results.
pagination_token string no A token used to paginate multiple pages of results.
get_report_details Read

Use this endpoint to retrieve a specific report using its ID. Official Checkout.com endpoint: GET /reports/{id}.

Lua path
app.integrations.checkout_com.get_report_details
Full name
checkout-com.checkout_com_get_report_details
ParameterTypeRequiredDescription
id string yes The ID of the report to retrieve.
get_report_file Read

Use this endpoint to retrieve a specific file from a given report using their respective IDs. Official Checkout.com endpoint: GET /reports/{id}/files/{fileId}.

Lua path
app.integrations.checkout_com.get_report_file
Full name
checkout-com.checkout_com_get_report_file
ParameterTypeRequiredDescription
id string yes The ID of the report that the file belongs to.
file_id string yes The ID of the file to retrieve.
create_session Write

Create a payment session to authenticate a cardholder before requesting a payment. Payment sessions can be linked to one or more payments (in the case of recurring and other merchant-initiated payments). The `next_actions` object in the response tells you which actions can be performed next. Official Checkout.com endpoint: POST /sessions.

Lua path
app.integrations.checkout_com.create_session
Full name
checkout-com.checkout_com_create_session
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
get_session Read

Returns the details of the session with the specified identifier string. Official Checkout.com endpoint: GET /sessions/{id}.

Lua path
app.integrations.checkout_com.get_session
Full name
checkout-com.checkout_com_get_session
ParameterTypeRequiredDescription
id string yes Session ID
channel string no Optionally provide the type of channnel so you only get the relevant actions
update_session Write

Update a session by providing information about the environment. Official Checkout.com endpoint: PUT /sessions/{id}/collect-data.

Lua path
app.integrations.checkout_com.update_session
Full name
checkout-com.checkout_com_update_session
ParameterTypeRequiredDescription
id string yes Session ID
body object yes Request body matching the official Checkout.com OpenAPI schema.
complete_session Read

Complete a session Official Checkout.com endpoint: POST /sessions/{id}/complete.

Lua path
app.integrations.checkout_com.complete_session
Full name
checkout-com.checkout_com_complete_session
ParameterTypeRequiredDescription
id string yes Session ID
body object no Request body matching the official Checkout.com OpenAPI schema.
update_session_three_ds_method_completion Write

Update the session's 3DS Method completion indicator based on the result of accessing the 3DS Method URL. Official Checkout.com endpoint: PUT /sessions/{id}/issuer-fingerprint.

Lua path
app.integrations.checkout_com.update_session_three_ds_method_completion
Full name
checkout-com.checkout_com_update_session_three_ds_method_completion
ParameterTypeRequiredDescription
id string yes Session ID
body object yes Request body matching the official Checkout.com OpenAPI schema.
request_token Read

Exchange card details for a reference token that can be used later to request a card payment. Tokens are single use and expire after 15 minutes. To create a token, please authenticate using your public key. **Please note:** You should only use the `card` type for testing purposes. Official Checkout.com endpoint: POST /tokens.

Lua path
app.integrations.checkout_com.request_token
Full name
checkout-com.checkout_com_request_a_token
ParameterTypeRequiredDescription
body object no Request body matching the official Checkout.com OpenAPI schema.
create_transfer Write

Initiate a transfer of funds from source entity to destination entity. Official Checkout.com endpoint: POST /transfers.

Lua path
app.integrations.checkout_com.create_transfer
Full name
checkout-com.checkout_com_create_transfer
ParameterTypeRequiredDescription
cko_idempotency_key string yes An idempotency key for safely retrying transfer requests
body object yes Request body matching the official Checkout.com OpenAPI schema.
get_transfer_details Read

Retrieve transfer details using the transfer identifier. Official Checkout.com endpoint: GET /transfers/{id}.

Lua path
app.integrations.checkout_com.get_transfer_details
Full name
checkout-com.checkout_com_get_transfer_details
ParameterTypeRequiredDescription
id string yes The transfer identifier
get_bank_account_fields Read

Returns the bank account field formatting required to create bank account instruments or perform payouts for the specified country and currency. Official Checkout.com endpoint: GET /validation/bank-accounts/{country}/{currency}.

Lua path
app.integrations.checkout_com.get_bank_account_fields
Full name
checkout-com.checkout_com_get_bank_account_fields
ParameterTypeRequiredDescription
country string yes The two-letter <a href="https://www.checkout.com/docs/resources/codes/country-codes" target="_blank">ISO country code</a>
currency string yes The three-letter <a href="https://www.checkout.com/docs/resources/codes/currency-codes" target="_blank">ISO currency code</a>
account_holder_type string no The type of account holder that will be used to filter the fields returned
payment_network string no The banking network that will be used to filter the fields returned