In-app shopping
The user browses the merchant's product catalogue directly in the OpenApp app, selects products, and builds a basket there. OpenApp initiates the basket in the merchant system, after which the checkout continues as in the own-page flow.
This scenario requires two prerequisites:
- Catalogue polling integrated so OpenApp has an up-to-date copy of the merchant's products.
- The in-app catalogue display capability enabled in the OpenApp control panel.
Required endpoints
| Endpoint | Direction | Purpose |
|---|---|---|
| Catalogue polling | OpenApp → Merchant | OpenApp periodically syncs the product catalogue for display in the app |
| Basket initiation | OpenApp → Merchant | OpenApp creates the basket in the merchant system from the products the user selected in the app; replaces basket retrieval in this scenario |
| Basket recalculate | OpenApp → Merchant | Re-validates the basket when the user changes quantity or applies a coupon |
| Order placement | OpenApp → Merchant | Submits the confirmed order with user details and selected delivery method |
| Order status | Merchant → OpenApp | Notifies OpenApp as the order progresses (confirmed, shipped, delivered) |
Optional endpoints
| Endpoint | Direction | Purpose |
|---|---|---|
| Basket change callback | Merchant → OpenApp | Merchant notifies OpenApp if the basket changes on the merchant's side (e.g. price update, stock change) |
| Refunds | Merchant → OpenApp | Initiates a refund for a completed order |
tip
This scenario can coexist with payments from your own page. Once catalogue polling is in place, both flows share the same recalculate and order placement endpoints.