markAsPaid( )
Developer Preview
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Marks an offline order as paid.
The markAsPaid()
function returns a Promise that resolves when the offline order is successfully marked as paid.
The entire order is marked as paid, even if the order's payments are recurring.
Note: Marking separate payment cycles as paid is not yet supported. Subsequent offline payments do trigger events and emails, but are not registered as additional offline payments.
Marking an offline order as paid causes the following changes:
- The order's
lastPaymentStatus
changes to"PAID"
. - The order's status changes to either
"PENDING"
or"ACTIVE"
, depending on the order'sstartDate
.
An error occurs if you attempt to:
- Mark an already-paid, offline order as paid. You cannot make an offline order as paid twice.
- Mark an online order as paid. The
markAsPaid()
function is supported for offline orders only.
Admin Method
This function requires elevated permissions and runs only on the backend and on dashboard pages.
Permission Scopes
For app development, you must have one of the following permission scopes:Manage Orders
Learn more about permission scopes.
Method Declaration
Copy
Method Parameters
_idstringRequired
Order ID.
Was this helpful?
Yes
No