Create Payment
Creates a payment. External ID must be unique per node.
Authentication: Bearer token required.
Endpoint: POST /api/v1/payments
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| external_id | string | Yes | Unique per node |
| node_id | string | Yes | Node UUID |
| chain_id | string | No | Chain UUID |
| network_id | string | Yes | Network UUID |
| wallet_id | string | No | Wallet UUID |
| member_id | string | No | Member UUID |
| member | object | No | Inline member data (external_id, name, surname, email, etc.) |
| currency_id | string | Yes | Currency UUID |
| price | float64 | Yes | Price |
| paid_price | float64 | Yes | Paid price |
| payment_method | string | Yes | web3, credit_card, or bank_transfer |
| payment_group | string | Yes | product or listing_or_subscription |
| payment_address | string | Yes | Payment address (min 10 chars) |
| items | array | No | Payment items (name, price, external_id) |
| metadata | string | No | Metadata |
| expires_at | string | Yes | RFC3339 datetime |
| retry | bool | No | Retry flag |
| retry_count | int | No | Retry count |
| client_ip | string | No | Client IP (IPv4) |
Response — 201 Created
Returns PaymentResponse with access_token for the payment widget.
| Status | Description |
|---|---|
| 404 | Node or currency not found |
| 409 | External ID already exists for node |