Payments Public API
Public payment endpoints for customer payment links and payment-provider return handling.
Generated from the Celerp 2.5.0 OpenAPI schema, 21 September 2026.
GET /pay/{token}
Open Customer Payment Link
Open the public payment flow associated with a Celerp payment link.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
token | path | yes | string | Opaque public token identifying the shared or payment resource. |
Responses
| Status | Description | Body |
|---|---|---|
200 | Redirects to the payment page for the document. | -- |
422 | The request failed validation. The response lists each invalid field and why. | HTTPValidationError |
Example
curl -X GET http://localhost:8000/pay/:token \
-H "Authorization: Bearer $TOKEN"GET /pay/{token}/return
Handle Payment Provider Return
Handle the customer's return from the payment provider, reconcile the payment result, and show the related Celerp document.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
token | path | yes | string | Opaque public token identifying the shared or payment resource. |
session_id | query | -- | string | Identifier of the bank reconciliation session. |
Responses
| Status | Description | Body |
|---|---|---|
200 | Redirects back to the shared document once the payment result is recorded. | -- |
422 | The request failed validation. The response lists each invalid field and why. | HTTPValidationError |
Example
curl -X GET http://localhost:8000/pay/:token/return \
-H "Authorization: Bearer $TOKEN"