BillingCashoutRequestedPayload billing.cashout.requested@1
Generated at from
openvibe-contracts v0.33.0 and
openvibe-sdk v0.5.0.
- Version
- 1.0.0
- Owner
- billing
- Visibility
- first-party
- Status
- active
- Compatibility
- backward
- Decision
- ADR-012
- Schema
https://openvibe.network/contracts/events/payloads/billing.cashout.requested.v1.json
billing.cashout.requested v1 (OpenVibe.Billing server/ops/cashouts.js request). A creator asked to cash out payable bits; they are held in escrow. Envelope: subject { type: cashout, id: co_… }, visibility internal, priority important, actor service:billing.
Fields
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
cashout | object | yes |
| |
cashout.id | string | yes |
| |
cashout.subject | identity.subject-ref | yes | ||
cashout.amount_bits | integer | yes |
| |
cashout.value_cents | integer | yes | ||
cashout.status | const | yes |
| |
cashout.payout_method | object | yes | The payout method's kind only; the address (e.g. a PayPal email) stays in Billing and never travels on the event stream. |
|
cashout.payout_method.type | string | null | yes | ||
cashout.escrow_until | string | yes | ||
cashout.request_txn | string | yes |
| |
cashout.settle_txn | string | null | yes |
| |
cashout.payout_provider | string | null | yes | ||
cashout.payout_reference | string | null | yes | ||
cashout.reason | string | null | yes | ||
cashout.created_at | string | yes | ||
cashout.updated_at | string | yes | ||
transaction_id | string | yes | The cashout_request transaction. |
|
Examples
From the contract's own test fixtures: valid ones validate, rejected ones must fail.
Valid: paypal
{
"cashout": {
"id": "co_01JAB3C4D5E6F7G8H9J0K1MNQ5",
"subject": {
"type": "user",
"id": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ"
},
"amount_bits": 5000,
"value_cents": 5000,
"status": "requested",
"payout_method": {
"type": "paypal"
},
"escrow_until": "2026-09-30T10:00:00.000Z",
"request_txn": "txn_01JAB3C4D5E6F7G8H9J0K1MNQ6",
"settle_txn": null,
"payout_provider": null,
"payout_reference": null,
"reason": null,
"created_at": "2026-09-23T10:00:00.000Z",
"updated_at": "2026-09-23T10:00:00.000Z"
},
"transaction_id": "txn_01JAB3C4D5E6F7G8H9J0K1MNQ6"
}Rejected: payout-address
{
"cashout": {
"id": "co_01JAB3C4D5E6F7G8H9J0K1MNQ5",
"subject": {
"type": "user",
"id": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ"
},
"amount_bits": 5000,
"value_cents": 5000,
"status": "requested",
"payout_method": {
"type": "paypal",
"address": "[email protected]"
},
"escrow_until": "2026-09-30T10:00:00.000Z",
"request_txn": "txn_01JAB3C4D5E6F7G8H9J0K1MNQ6",
"settle_txn": null,
"payout_provider": null,
"payout_reference": null,
"reason": null,
"created_at": "2026-09-23T10:00:00.000Z",
"updated_at": "2026-09-23T10:00:00.000Z"
},
"transaction_id": "txn_01JAB3C4D5E6F7G8H9J0K1MNQ6"
}Rejected: wrong-status
{
"cashout": {
"id": "co_01JAB3C4D5E6F7G8H9J0K1MNQ5",
"subject": {
"type": "user",
"id": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ"
},
"amount_bits": 5000,
"value_cents": 5000,
"status": "paid",
"payout_method": {
"type": "paypal"
},
"escrow_until": "2026-09-30T10:00:00.000Z",
"request_txn": "txn_01JAB3C4D5E6F7G8H9J0K1MNQ6",
"settle_txn": null,
"payout_provider": null,
"payout_reference": null,
"reason": null,
"created_at": "2026-09-23T10:00:00.000Z",
"updated_at": "2026-09-23T10:00:00.000Z"
},
"transaction_id": "txn_01JAB3C4D5E6F7G8H9J0K1MNQ6"
}Validate
const contracts = require('openvibe-contracts');
contracts.validate('billing.cashout.requested@1', value); // { valid, errors: [{ path, message }] }