MakePay Saleor

Saleor payment app scaffold for MakePay checkout.

The app exposes a Saleor manifest, transaction webhooks, a MakePay webhook endpoint, and a small status page. It is built with Next.js App Router and keeps MakePay credentials server-side.

Endpoints

• /api/manifest - Saleor app manifest.
• /api/register - receives Saleor installation token payloads.
• /api/webhooks/transaction-initialize-session - creates a MakePay checkout and returns CHARGE_ACTION_REQUIRED.
• /api/webhooks/transaction-process-session - maps MakePay status into Saleor transaction events.
• /api/webhooks/makepay - verifies MakePay webhook signatures.

Environment

NEXT_PUBLIC_APP_URL=https://makepay-saleor.example.com
APP_URL=https://makepay-saleor.example.com
MAKEPAY_API_BASE_URL=https://api.makepay.io
MAKEPAY_TOKEN=replace-with-server-side-token
MAKEPAY_WEBHOOK_SECRET=replace-with-webhook-secret

Flow

sequenceDiagram
    participant Storefront
    participant Saleor
    participant App as MakePay Saleor App
    participant MakePay

    Storefront->>Saleor: transactionInitialize
    Saleor->>App: TRANSACTION_INITIALIZE_SESSION
    App->>MakePay: Create checkout
    MakePay-->>App: checkoutUrl
    App-->>Saleor: CHARGE_ACTION_REQUIRED
    Storefront->>MakePay: Redirect customer
    MakePay-->>App: Paid webhook
    Storefront->>Saleor: transactionProcess
    Saleor->>App: TRANSACTION_PROCESS_SESSION
    App-->>Saleor: CHARGE_SUCCESS or pending action

Loading

Development

npm ci
npm run validate
npm run typecheck
npm run build

Production Notes

Persist Saleor installation tokens in durable storage. This scaffold acknowledges registration payloads but does not ship a database adapter, because deployments vary between Vercel, self-hosted Node, and container platforms.