Checkout Flow

The checkout process converts customer cart items into orders and processes payments through techrar's secure payment infrastructure.

Key Benefits

Flexible Integration - Soft mode for price calculation, hard mode for order creation

Secure Payments - Multiple payment providers with unified checkout experience

Complete Automation - Automatic order creation, invoicing, and webhook notifications

Checkout Modes

Soft checkout: Used for price calculation and validation, voucher application, and wallet redeem. It returns pricing details and available payment methods without creating an order.

Hard checkout: Used for actual order placing and completion. It creates a pending order, a payment link and optionally generates an invoice. Invoices can be generated if create_invoice was set to true.

{
    "action": "soft" | "hard",
    "create_invoice": true | false,
    ...
}

Payment URL Parameters & Callbacks

After a hard checkout, you receive a payment URL:

{
    ...
    "checkout_url": "http://api.techrar.com/order/v1/orders/checkout/728/?entity=invoice"
}

Customize the checkout experience with passing these URL parameters:

lang=en: Checkout page language

success_url: Redirect after successful payment

error_url: Redirect after failed payment

http://api.techrar.com/order/v1/orders/checkout/728/?entity=invoice&lang=ar&success_url=https://example.com/success&error_url=https://example.com/success

Checkout Examples

Quick Checkout

Quick Checkout+

eCommerce Checkout

Recurring Purchase

Bundles

This method requires you to create offerings using Items & Catalog Management.

{
  "source": "api",
  "action": "hard",
  "is_redeeming": false,
  "vouchers": [],
  "items": [
    {
      "item_id": 123,
      "qty": 1
    }
  ],
  "notes": "",
  "customer_username": "966501234567",
  "create_invoice": true # Payment link will never expire
}

Detailed Checkout Endpoint

Go to Checkout for more details

Techrar Pay

The checkout redirects customers to techrar's secure payment page supporting:

Credit/Debit Cards - Visa, Mastercard, Mada

Digital Wallets - Apple Pay, Google Pay, STC Pay

Buy Now Pay Later - Tabby, Tamara installments

Bank Transfer - Direct bank account transfers

Available Methods

Some payment methods such as Tabby, Tamara, and Bank Transfers must be activated via the portal -> Settings -> Integrations.

Webhook Notifications

After payment completion, techrar sends webhooks to notify your system:
Webhook Events. Go to Webhooks.

Checkout Custom Fields

You may use our checkout custom fields

{
    ...
    "custom_fields": {
        "account_id": 1,
        "ref_order_id": 123
    }
}

Custom fields are automatically attached to the Order, Invoice, and Transaction for complete traceability.

Checkout Config

For detailed customization options, see Checkout Settings

Checkout Flow

Checkout Flow#

Key Benefits#

Checkout Modes#

Payment URL Parameters & Callbacks#

Checkout Examples#

Techrar Pay#

Webhook Notifications#

Checkout Custom Fields#

Checkout Config#

Checkout Flow

Key Benefits

Checkout Modes

Payment URL Parameters & Callbacks

Checkout Examples

Techrar Pay

Webhook Notifications

Checkout Custom Fields

Checkout Config