invoice-checkout

/invoice-checkout — Fawaterak hosted invoice

Algorithm

1. Collect the cart: each item needs name, price and quantity. Compute cartTotal — it must equal the sum of the line items or Fawaterak rejects the invoice.
2. Collect customer details (first name, last name, email, phone) and the three redirect URLs: successUrl, failUrl, and optionally pendingUrl.
3. Call create_invoice_link with cartTotal (a string), cartItems, successUrl, failUrl, and optionally currency (defaults to EGP) and pendingUrl. It returns an invoice id and a hosted checkout URL that offers every enabled method.
4. Send the customer the URL.
5. Call get_invoice_data with the invoice_id to read status, paid amount, payment_method and transaction_id.
6. Fawry payments are not instant — a customer gets a reference code and pays at a kiosk. An invoice sitting in unpaid for hours is normal for Fawry; do not call it failed.

Response format

## Fawaterak invoice

**Invoice**: 88214
**Total**: 450 EGP
**Status**: unpaid → paid
**Method**: fawry
**Transaction**: FWR-99182736
**Customer**: Mona Hassan / mona@example.com

Checkout link: https://app.fawaterk.com/invoice/...

Notes

• cartTotal is a string; it must match the line items exactly.
• Use get_payment_methods first if the user wants to know which rails are actually enabled on this account before quoting options to a customer.
• There is no webhook tool here — status comes from polling get_invoice_data.

Examples

/invoice-checkout 450 "Mona Hassan" mona@example.com 01012345678
/invoice-checkout 1200 "Ahmed Ali" ahmed@example.com 01198765432