Skip to main content

Payments from your own page

The merchant's own webshop or page drives the checkout. The user adds products to a basket on the merchant's site, scans the OpenApp widget to pay, and completes the purchase in the OpenApp app. OpenApp calls the merchant's API to retrieve and confirm the basket, and the merchant's system receives the final order.

Required endpoints

EndpointDirectionPurpose
Basket retrievalOpenApp → MerchantOpenApp fetches the basket the user built on the merchant's page
Basket recalculateOpenApp → MerchantRe-validates the basket when the user changes quantity or applies a coupon
Order placementOpenApp → MerchantSubmits the confirmed order with user details and selected delivery method
Order statusMerchant → OpenAppNotifies OpenApp as the order progresses (confirmed, shipped, delivered)

Optional endpoints

EndpointDirectionPurpose
Basket change callbackMerchant → OpenAppMerchant notifies OpenApp if the basket changes on the merchant's side (e.g. price update, stock change)
RefundsMerchant → OpenAppInitiates a refund for a completed order