Payments

Forwards a payment request to the configured payment service and stores a pending order row.

POST /payment
X-Tenant-ID: tenant-uuid

{
  "orderId": "ORDER-94",
  "amount": 10000,
  "currency": "ZAR",
  "userId": "41",
  "customer": { "email": "user@example.com" }
}

{
  "data": {
    "paymentId": 87,
    "status": "pending"
  }
}

• Register the webhook URL as /payment/webhook.

Receives provider status changes and updates the matching order row to succeeded or failed.

POST /payment/webhook

{
  "event": "charge.success",
  "data": {
    "status": "success",
    "metadata": { "orderId": "ORDER-94", "paymentId": "87" }
  }
}

{
  "received": true
}