Prices, Fees and Totals

​

Intro

​

The calls, in checkout order

​

Hows

​

Keep four things the same

1. One currency everywhere. Send the customer’s chosen code to Get Product, Preview Payment and the intent.
2. Same body for preview and intent. Preview Payment takes exactly the body you’ll send to Create Product Payment Intent, so build it once and send it twice.
3. Show the fee when the customer pays it. When customer_pays_fees is true, show the transaction fee as its own line. See Fees.
4. The intent is the charge. The breakdown and preview are for display. What the customer pays is the intent’s amount.

​

Example: review step, then pay

// Built once from the customer's cart and details.
const body = {
  product_type: "digital",
  cart: [{ product_id: 3046, quantity: 1, price: 5000, product_image: imageUrl }],
  email: "jane@example.com",
  first_name: "Jane",
  last_name: "Doe",
  currency: "GBP",
};

// Review step: exact numbers, nothing created.
const { data: preview } = await khaime.post("/cart-payment/preview", body);
showSummary({
  subtotal: preview.cart_total_before_fees,
  fee: preview.customer_pays_fees ? preview.total_fees_amount : null,
  total: preview.customer_pays_total,
});

// Customer presses Pay: same body.
const { data: intent } = await khaime.post("/product-payment/intent", body);

​

Why nots

• Don’t compute fees or totals yourself. Fees depend on currency, gateway, country and the merchant’s settings, and they change. Read them from Khaime.
• Preview Payment needs the full cart. It validates everything the intent does, including required custom fields, so call it on your review step, once those are filled in. Before that, show the product price.
• Charging an amount, not catalog products? Use preview: true on Create Payment Intent instead.
• A preview isn’t a reservation. Rates can move between preview and payment. If the customer waits a long time, preview again.