Activate payment
PaymentsAPI REFERENCE
Activate payment
POST
/v1/payments/{paymentId}/activatePublic endpoint — no API key required.
Activate a payment (public, customer-facing)
Example request
A minimal request you can copy and run.
curl -X POST https://api.suward.com/v1/payments/<payment_id>/activatePath Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| paymentId | string | yes | Payment ID |
Response
| Name | Type | Required | Description |
|---|---|---|---|
| activatedAt | integer | no | Unix-milliseconds timestamp when the payment was activated. Null before activation. |
| activationFlowSeconds | integer | no | Activation grace period in seconds before the payment window starts counting. Null when not configured. |
| address | string | no | On-chain deposit address the customer must send funds to. Null until the payment is activated and an address is assigned. |
| amount | string | no | Integer string in the asset's smallest unit. |
| amountReceived | string | no | Integer string in the asset's smallest unit. |
| asset | no | Asset the payment is denominated in, as an asset id-string (see GET /v1/assets). Null until an asset is selected. | |
| createdAt | integer | no | Unix-milliseconds timestamp when the payment was created. |
| expiresAt | integer | no | Unix-milliseconds timestamp when the payment window closes; the payment expires if unpaid by then. |
| id | string | no | Unique Suward identifier of the payment. |
| paymentWindowSeconds | integer | no | Length of the payment window in seconds — how long the payment stays open for funding once activated. |
| redirect | no | Resolved "return to store" redirect (base URL plus the query parameters to append) used to send the customer back after payment. Null when none was configured. | |
| status | no | Main payment lifecycle status. See the status enum for the full meaning of each value. | |
| subStatus | no | Fine-grained payment sub-status. See the sub-status enum for the full meaning of each value. | |
| underpaymentTolerance | string | no | Integer string in the asset's smallest unit. |
| updatedAt | integer | no | Unix-milliseconds timestamp when the payment was last updated. |
| paymentPageUrl | string | no | Absolute URL of the Suward-hosted checkout page where the customer pays this payment. |
Response · JSON
{ "activatedAt": 0, "activationFlowSeconds": 3600, "address": "0xabc…def", "amount": "100000000", "amountReceived": "100000000", "asset": "USDT_ETHEREUM", "createdAt": 0, "expiresAt": 0, "id": "obj_abc123", "paymentWindowSeconds": 3600, "redirect": {}, "status": "pending", "subStatus": "created", "underpaymentTolerance": "0", "updatedAt": 0, "paymentPageUrl": "string"}