check_order_paid
Read-onlyIdempotent
Check if an order is paid and safe to fulfil using your reference ID. Returns paid true only for Complete or Delivered statuses, so verify before sending downloads or shipping copies.
Instructions
Answer whether an order is paid and safe to fulfil, from your reference ID.
Returns `paid: true` only for statuses Complete or Delivered. Wayl documents the
names of its eight link statuses and nothing else, so this server treats only
those two as settled. Check this before sending a download link or shipping a
copy — a link in status Created or Pending means the buyer has not paid yet.
`paid` and `safeToFulfil` are not the same thing. While this server is in test
mode, a settled payment is a sandbox simulation that moved no real money, so
`safeToFulfil` stays false even when `paid` is true. Act on `safeToFulfil`.
Read-only, so poll it as often as you need. When a webhook delivery arrives use
`parse_webhook` instead — it authenticates the payload and reads the webhook's
separate `paymentStatus` vocabulary. For the full link record use
`get_payment_link`; to reconcile many orders use `get_payment_links_batch`.
The returned `total` is a string, as Wayl sends it. Parse it before arithmetic.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reference_id | Yes | Your own order ID — the referenceId used when the link was created. Not Wayl's internal link ID and not the checkout `code`. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||