Api ReferenceFiablePay ApiCheckoutExpire Checkout

Expire Checkout

To expire a checkout session, use the following endpoint:

  • Endpoint: POST https://service-sandbox.fiablepay.com/v3/checkout/{id}/expire
  • Description: This API allows you to mark a checkout session as expired.

Path Parameters

ParameterTypeRequiredDescription
idstringYesThe unique ID of the checkout session to expire

Response

FieldTypeDescription
idstringUnique ID of the checkout session
invoice_currencystringCurrency of the invoice
amountintegerTotal amount for the checkout (default: 0)
amount_paidintegerAmount already paid (default: 0)
customer_detailsobjectCustomer information
success_urlstringURL to redirect to after successful payment
cancel_urlstringURL to redirect to if payment is canceled
webhook_urlstringWebhook URL for payment updates
payment_methodsarray of stringsSupported payment methods
transaction_descriptionstringDescription of the transaction
expires_atstringTimestamp of when the session expired
statusstringCurrent status of the checkout session
payment_statusstringPayment status (e.g., unpaid, expired)
urlstringURL for the checkout session

Example Response

{
  "status": "success",
  "message": "CHECKOUT.EXPIRE.SUCCESS",
  "data": {
    "id": "chk_ctj2hirigj2jdsminhi0",
    "invoice_currency": "USD",
    "amount": 100,
    "amount_paid": 0,
    "customer_details": {
      "customer": "cus_ctgp0rq2lprdpl0d6upg",
      "billing_details": null,
      "shipping_details": null
    },
    "success_url": "https://example.com/success",
    "cancel_url": "https://example.com/cancel",
    "webhook_url": "https://example.com/webhook",
    "payment_methods": ["card"],
    "transaction_description": "Order #12345",
    "expires_at": "2024-12-21T10:00:00Z",
    "status": "expired",
    "payment_status": "unpaid",
    "url": "https://checkout-sandbox.fiablepay.com/transaction/vXeBpzkOhVB2ncwIF0gAp80yQlO2FImyHbFRQJT6WBk="
  }
}