Conekta::OrderCheckoutRequest
July 21, 2026 ยท View on GitHub
Properties
| Name | Type | Description | Notes |
|---|---|---|---|
| allowed_payment_methods | Array<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_methods | Array<String> | Payment methods to be excluded from the checkout. This field is mutually exclusive with allowed_payment_methods. | [optional] |
| exclude_card_networks | Array<String> | List of card networks to exclude from the checkout. This field is only applicable for card payments. | [optional] |
| plan_ids | Array<String> | List of plan IDs that will be available for subscription. This field is required for subscription payments. | [optional] |
| expires_at | Integer | It 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_url | String | Redirection url back to the site in case of failed payment, applies only to HostedPayment. | [optional] |
| force_save_card | Boolean | Indicates whether the card used for the payment should be saved for future purchases. This field is only applicable for card payments. | [optional] |
| monthly_installments_enabled | Boolean | [optional] | |
| monthly_installments_options | Array<Integer> | [optional] | |
| max_failed_retries | Integer | Number of retries allowed before the checkout is marked as failed | [optional] |
| name | String | Reason for payment | [optional] |
| on_demand_enabled | Boolean | [optional] | |
| redirection_time | Integer | number of seconds to wait before redirecting to the success_url | [optional] |
| success_url | String | Redirection url back to the site in case of successful payment, applies only to HostedPayment | [optional] |
| type | String | Required. 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
)