Conekta::OrderCheckoutRequest

July 21, 2026 ยท View on GitHub

Properties

NameTypeDescriptionNotes
allowed_payment_methodsArray<String>Are the payment methods available for this link. For subscriptions, only 'card' is allowed due to the recurring nature of the payments. This field is mutually exclusive with excluded_payment_methods.[optional]
excluded_payment_methodsArray<String>Payment methods to be excluded from the checkout. This field is mutually exclusive with allowed_payment_methods.[optional]
exclude_card_networksArray<String>List of card networks to exclude from the checkout. This field is only applicable for card payments.[optional]
plan_idsArray<String>List of plan IDs that will be available for subscription. This field is required for subscription payments.[optional]
expires_atIntegerIt is the time when the link will expire. It is expressed in seconds since the Unix epoch. The valid range is from 5 minutes to 365 days from the creation date.[optional]
failure_urlStringRedirection url back to the site in case of failed payment, applies only to HostedPayment.[optional]
force_save_cardBooleanIndicates whether the card used for the payment should be saved for future purchases. This field is only applicable for card payments.[optional]
monthly_installments_enabledBoolean[optional]
monthly_installments_optionsArray<Integer>[optional]
max_failed_retriesIntegerNumber of retries allowed before the checkout is marked as failed[optional]
nameStringReason for payment[optional]
on_demand_enabledBoolean[optional]
redirection_timeIntegernumber of seconds to wait before redirecting to the success_url[optional]
success_urlStringRedirection url back to the site in case of successful payment, applies only to HostedPayment[optional]
typeStringRequired. This field represents the type of checkout, which determines the user experience during the payment process. 'HostedPayment' will redirect the customer to a Conekta-hosted page to complete the payment, while 'Integration' allows the payment process to be handled entirely on your site using Conekta's APIs and SDKs.[optional]

Example

require 'conekta'

instance = Conekta::OrderCheckoutRequest.new(
  allowed_payment_methods: [cash, card, bank_transfer, bnpl, pay_by_bank, apple, google],
  excluded_payment_methods: [cash, bank_transfer],
  exclude_card_networks: [visa, amex],
  plan_ids: [plan_123, plan_456],
  expires_at: null,
  failure_url: https://www.mysite.com/failure,
  force_save_card: false,
  monthly_installments_enabled: false,
  monthly_installments_options: [3, 6, 12],
  max_failed_retries: 3,
  name: null,
  on_demand_enabled: true,
  redirection_time: 10,
  success_url: https://www.mysite.com/success,
  type: null
)