---
title: "Get Checkout Settings"
method: GET
path: "/commerce/settings/checkout"
tags: ["CheckoutSettings"]
---

# Get Checkout Settings

`GET /commerce/settings/checkout`

Retrieves all checkout settings defined for the site: Payment settings, such as the payment gateway ID and credentials,supported credit cards,Customer Checkout settings whether login is required and any custom attributes; and Order Processing settings, such as when payment is authorized and captured, and any custom attributes.

## Query parameters

- `responseFields` string

## Response `200`

OK

- CheckoutSettings — Checkout and payment settings defined for this site. Can set which payment gateway to use, whether a shopper is required to login to place an order, when credit cards are authorized and charged (when the order is placed or shipped), and, in the future, whether the checkout page displays an option for shoppers to receive your email marketing campaigns.
  - `customerCheckoutSettings` CustomerCheckoutSettings — Checkout requirements for customers, for example, whether they must login before purchasing from your store. Other customized checkout requirements can be defined.
    - `auditInfo` AdminUserAuditInfo
      - `createBy` string, nullable
      - `createDate` string, date-time, nullable
      - `updateBy` string, nullable
      - `updateDate` string, date-time, nullable
    - `customerCheckoutType` string, nullable — Checkout login setting. Value can be either "LoginOptional," where shoppers are prompted to sign in but are not required to do so, or "LoginRequired," where shopppers must login before purchasing.
  - `orderProcessingSettings` OrderProcessingSettings — Order processing (credit card payment authorization) setting defined for this site. Can choose when the shopper’s credit card is authorized and charged. Possibilities include, "authorize and charge the shopper's credit card for the full order amount when the order is placed," "authorize the shopper's credit card for the full amount when the order is placed and charge the credit card when the order is shipped," or "authorize and charge the shopper's credit card for the full amount when the order is shipped."
    - `abandonedOrderThresholdInMinutes` integer, nullable — Abandoned Order Threshold in minutes indicates the number of minutes until a pending order is considered abandoned.
    - `auditInfo` AdminUserAuditInfo
      - `createBy` string, nullable
      - `createDate` string, date-time, nullable
      - `updateBy` string, nullable
      - `updateDate` string, date-time, nullable
    - `giftCardProcessingType` string, nullable — Gift card payment authorization setting. Options can be authorize and charge the shopper's credit card when the order is placed, "AuthorizeAndCaptureOnOrderPlacement," authorize the shopper's gift card when the order is placed and charge the gift card when it is shipped, "AuthorizeOnOrderPlacementAndCaptureOnOrderShipment," or authorize and charge the shopper's gift card for the full amount when the order is shipped, "AuthorizeAndCaptureOnOrderShipment."
    - `giftCardRefundCreditProcessingType` string, nullable — GiftCrd Refund/Credit flow, wither to existing or new giftcard
    - `paymentProcessingFlowType` string, nullable — Credit card payment authorization setting. Options can be authorize and charge the shopper's credit card when the order is placed, "AuthorizeAndCaptureOnOrderPlacement," authorize the shopper's credit card when the order is placed and charge the credit card when the shipped, "AuthorizeOnOrderPlacementAndCaptureOnOrderShipment," or authorize and charge the shopper's credit card for the full amount when the order is shipped, "AuthorizeAndCaptureOnOrderShipment."
    - `thirdPartyPaymentSettings` ThirdPartyPaymentSetting[], nullable — Order processing settings for Third party payments Ex- ApplePay using AuthorizeOnOrderPlacementAndCaptureOnOrderShipment for processing orders
      - `paymentProcessingFlowType` string, nullable
      - `type` string, nullable
    - `useOverridePriceToCalculateDiscounts` boolean — Use the override price on products to calculate discounts
  - `paymentSettings` PaymentSettings — Payment gateway settings defined for this site. A payment gateway is an e-commerce application service provider that authorizes payments for e-businesses and online retailers. You can define multiple payment gateway settings but only one is active at a time. Authorize.net is the only payment gateway supported currently.
    - `auditInfo` AdminUserAuditInfo
      - `createBy` string, nullable
      - `createDate` string, date-time, nullable
      - `updateBy` string, nullable
      - `updateDate` string, date-time, nullable
    - `externalPaymentWorkflowDefinitions` ExternalPaymentWorkflowDefinition[], nullable
      - `credentials` ThirdPartyCredentialField[], nullable
        - `apiName` string, nullable — The name of this credential that should be used for web requests.
        - `displayName` string, nullable — The displayable name of this credential field
        - `inputType` string, nullable — The input field type for the value.
        - `isSensitive` boolean, nullable — the value holds sensitive information.
        - `value` string, nullable — The value for this credential that should be used for web requests.
        - `vocabularyValues` VocabularyValue[], nullable
          - `contents` LocalizedContent[], nullable
            - `localeCode` string, nullable
            - `value` string, nullable
          - `key` string, nullable
      - `description` string, nullable — Information about this definition for display purposes in the 'Payment and Checkout Settings' admin ui. This field may contain valid html tags
      - `fullyQualifiedName` string, nullable
      - `isEnabled` boolean
      - `isLegacy` boolean, nullable — Indicates if this is a legacy implementation using ARC only or using the new extensible implementation.
      - `name` string, nullable — Should be one of Contracts.Constants.ThirdPartyWorkflowNames.
      - `namespace` string, nullable
    - `gateways` Gateway[], nullable
      - `areGatewayCredentialFieldsSet` boolean — Returns true if Gateway CredentialsField is set. For security purposes, Gateway subresource CredentialFields will not be returned.
      - `gatewayAccount` GatewayAccount
        - `binPatterns` string[], nullable
        - `countryCode` string, nullable
        - `credentialFields` GatewayCredentialFieldValue[], nullable
          - `isValueSet` boolean
          - `name` string, nullable
          - `value` string, nullable
        - `gatewayDefinitionId` string, nullable
        - `id` string, nullable
        - `isActive` boolean
        - `name` string, nullable
      - `gatewayDefinition` GatewayDefinition
        - `administationUi` object[], nullable
        - `countryCode` string, nullable
        - `credentialDefinitions` GatewayCredentialFieldDefinition[], nullable
          - `adminDisplayOrder` integer
          - `displayName` string, nullable
          - `isPublic` boolean
          - `name` string, nullable
        - `features` string[], nullable
        - `id` string, nullable
        - `integrationImplTypeName` string, nullable
        - `name` string, nullable
        - `preAuthorizeDefinition` PreAuthorizeDefinition
          - `id` integer
          - `preAuthorizeProdUrl` string, nullable
          - `preAuthorizeTestUrl` string, nullable
          - `type` PreAuthorizeTransactionTypeDataContract
            - `description` string, nullable
            - `id` integer
            - `type` string, nullable
        - `prodServiceURL` string, nullable
        - `supportedCards` SupportedCard[], nullable
          - `friendlyName` string, nullable
          - `paymentType` string, nullable
          - `type` string, nullable
        - `testServiceURL` string, nullable
      - `siteGatewaySupportedCards` SiteGatewaySupportedCard[], nullable — Which credit cards the Merchant supports
        - `cardTypeId` string, nullable
        - `gatewayAccountId` string, nullable
        - `paymentType` string, nullable
        - `processingGatewayAccountId` string, nullable
      - `supportedCards` string[], nullable — Which credit cards the Merchant supports
    - `jobSettings` OrderJobSettings — Contains settings for the auto-capture payment feature.
      - `autoCaptureJob` AutoCaptureJob — Contains settings for the auto-capture payment feature.
        - `flexibleCapture` FlexibleCapture — Contains settings specifying whether the auto-capture payment feature should consider pre-fulfilled shipments.
          - `bopisFlow` FlexibleCaptureFlow — Specifies a pre-fulfilled shipment state that is eligible for capture.
            - `captureBy` string, nullable — Look at the `ShipmentState` or the `ShipmentWorkflow`.
            - `captureOn` string[], nullable — Which shipment states or workflow statuses are considered eligible for capture.
          - `deliveryFlow` FlexibleCaptureFlow — Specifies a pre-fulfilled shipment state that is eligible for capture.
            - `captureBy` string, nullable — Look at the `ShipmentState` or the `ShipmentWorkflow`.
            - `captureOn` string[], nullable — Which shipment states or workflow statuses are considered eligible for capture.
          - `sthFlow` FlexibleCaptureFlow — Specifies a pre-fulfilled shipment state that is eligible for capture.
            - `captureBy` string, nullable — Look at the `ShipmentState` or the `ShipmentWorkflow`.
            - `captureOn` string[], nullable — Which shipment states or workflow statuses are considered eligible for capture.
        - `forceCaptureOnFirstCapture` boolean — Specifies whether all available funds should be collected once any shipment is ready for capture.
        - `interval` integer — How often this job should run in minutes.
        - `isEnabled` boolean — Specifies whether this job should run.
      - `forceCaptureJob` ForceCaptureJob — Contains settings for when payments should be auto-captured regardless of shipment status.
        - `captureAfterDays` integer
        - `interval` integer — How often this job should run in minutes.
        - `isEnabled` boolean — Specifies whether this job should run.
    - `payByMail` boolean
    - `paymentRanking` string, nullable
    - `purchaseOrder` PurchaseOrderPaymentDefinition
      - `allowSplitPayment` boolean — Indicates whether another payment can be used with the purchase order
      - `customFields` SiteSettingsPurchaseOrderCustomField[], nullable
        - `code` string, nullable — Unique code/name for memo field
        - `isEnabled` boolean — Whether this memo field is enabled
        - `isRequired` boolean — Whether this memo field is mandatory to be filled in when placing an order
        - `label` string, nullable — Memo field label that appers on the store front
        - `sequenceNumber` integer — Sequence Number
      - `isEnabled` boolean — Is purchase order payment enabled
      - `paymentTerms` SiteSettingsPurchaseOrderPaymentTerm[], nullable — Allowed net terms
        - `code` string, nullable — A unique code for purchase order payment term
        - `description` string, nullable — Value of the net term
        - `sequenceNumber` integer — Sequence Number
    - `refundRanking` string, nullable

---

[API](https://skmtc.net/kibocommerce/apis/customer.md) · [All operations](https://skmtc.net/kibocommerce/apis/customer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kibocommerce/customer/versions/47c0cf7b75ab/schema)