<!-- x-generated: Generated by the Hyperscale artifact pipeline; do not edit by hand -->

# Escrow Marketplace Sandbox

> The frozen Escrow Marketplace Sandbox Product Build, version 1.

- Composition id: `escrow_marketplace_sandbox`
- Version: 1
- Digest: `052a56f7cc96e5fb21a24d72797d9f6ceadccd6ce285f5f321b7cd27afd0c222`
- Currencies: `SAR`
- Webhook events: 48

## Instruments

| Instrument | Title | States | Actions |
| --- | --- | --- | --- |
| [`deposit_hold`](../instruments/deposit_hold.md) | Deposit hold | 6 | claim, create, fund |
| [`escrow_order`](../instruments/escrow_order.md) | Escrow order | 9 | cancel, collect_penalty, create, dispute, fund, quote, refund, release, resume |
| [`listing`](../instruments/listing.md) | Listing | 5 | create, publish, reopen, reserve, sell, withdraw |
| [`order`](../instruments/order.md) | Order | 5 | cancel, confirm, create, fulfill |
| [`trade_settlement`](../instruments/trade_settlement.md) | Trade settlement | 7 | abandon, cancel, create, dispute, fund, release |

## Journeys

### Cancel an unfunded escrow

- Journey id: `unfunded_escrow_canceled`
- Steps: 11

1. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
2. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- customer.customerAccessId
3. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- customer.customerId
4. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
5. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- buyer_customer.customerAccessId
6. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- buyer_customer.customerId
7. `subject_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/subjects`, scopes product:write, idempotency required, receipt yes
   - Body: attributes, declaredValue, kind, kindVersion, productId
   - Path: none
   - Query: none
   - Expect: subjectId, tenantId, productId, kind, kindVersion, attributes, declaredValue, createdAt, metadata
   - Bindings: none
8. `listing_create`
   - Actor: product
   - Action: `listing.create`
   - Route: `POST /v1/listings`, scopes listing:write, idempotency required, receipt yes
   - Body: askingPrice, currency, description, expiresAt, headline, imageUrl, productId, sellerAccountId, subject
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: sellerAccountId <- seller.accountId, subject <- subject.subjectId
9. `listing_publish`
   - Actor: product
   - Action: `listing.publish`
   - Route: `POST /v1/listings/{listingId}/publish`, scopes listing:write, idempotency required, receipt yes
   - Body: none
   - Path: listingId
   - Query: none
   - Expect: none
   - Bindings: listingId <- listing.listingId
10. `escrow_order_create`
   - Actor: product
   - Action: `escrow_order.create`
   - Route: `POST /v1/escrow-orders`, scopes escrow_order:write, idempotency required, receipt yes
   - Body: buyerAccountId, fundBy, listingId, memo, productId, subject
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: buyerAccountId <- buyer.accountId, listingId <- listing.listingId, subject <- subject.subjectId
11. `escrow_order_cancel`
   - Actor: product
   - Action: `escrow_order.cancel`
   - Route: `POST /v1/escrow-orders/{escrowOrderId}/cancel`, scopes escrow_order:write, idempotency required, receipt yes
   - Body: none
   - Path: escrowOrderId
   - Query: none
   - Expect: none
   - Bindings: escrowOrderId <- escrow.escrowOrderId

### Withdraw a draft listing

- Journey id: `withdraw_draft_listing`
- Steps: 6

1. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
2. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- customer.customerAccessId
3. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- customer.customerId
4. `subject_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/subjects`, scopes product:write, idempotency required, receipt yes
   - Body: attributes, declaredValue, kind, kindVersion, productId
   - Path: none
   - Query: none
   - Expect: subjectId, tenantId, productId, kind, kindVersion, attributes, declaredValue, createdAt, metadata
   - Bindings: none
5. `listing_create`
   - Actor: product
   - Action: `listing.create`
   - Route: `POST /v1/listings`, scopes listing:write, idempotency required, receipt yes
   - Body: askingPrice, currency, description, expiresAt, headline, imageUrl, productId, sellerAccountId, subject
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: sellerAccountId <- seller_account.accountId, subject <- subject.subjectId
6. `listing_withdraw`
   - Actor: product
   - Action: `listing.withdraw`
   - Route: `POST /v1/listings/{listingId}/withdraw`, scopes listing:write, idempotency required, receipt yes
   - Body: none
   - Path: listingId
   - Query: none
   - Expect: none
   - Bindings: listingId <- listing.listingId

### Cancel an unfunded order

- Journey id: `cancel_unfunded_order`
- Steps: 10

1. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
2. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- customer.customerAccessId
3. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- customer.customerId
4. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- customer.customerId
5. `subject_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/subjects`, scopes product:write, idempotency required, receipt yes
   - Body: attributes, declaredValue, kind, kindVersion, productId
   - Path: none
   - Query: none
   - Expect: subjectId, tenantId, productId, kind, kindVersion, attributes, declaredValue, createdAt, metadata
   - Bindings: none
6. `listing_create`
   - Actor: product
   - Action: `listing.create`
   - Route: `POST /v1/listings`, scopes listing:write, idempotency required, receipt yes
   - Body: askingPrice, currency, description, expiresAt, headline, imageUrl, productId, sellerAccountId, subject
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: sellerAccountId <- seller_account.accountId, subject <- subject.subjectId
7. `listing_publish`
   - Actor: product
   - Action: `listing.publish`
   - Route: `POST /v1/listings/{listingId}/publish`, scopes listing:write, idempotency required, receipt yes
   - Body: none
   - Path: listingId
   - Query: none
   - Expect: none
   - Bindings: listingId <- listing.listingId
8. `escrow_order_create`
   - Actor: product
   - Action: `escrow_order.create`
   - Route: `POST /v1/escrow-orders`, scopes escrow_order:write, idempotency required, receipt yes
   - Body: buyerAccountId, fundBy, listingId, memo, productId, subject
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: buyerAccountId <- buyer_account.accountId, listingId <- listing.listingId, subject <- subject.subjectId
9. `order_create`
   - Actor: product
   - Action: `order.create`
   - Route: `POST /v1/orders`, scopes order:write, idempotency required, receipt yes
   - Body: confirmBy, escrowOrderId, listingId, memo, productId, subject
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: escrowOrderId <- escrow.escrowOrderId, listingId <- listing.listingId, subject <- subject.subjectId
10. `order_cancel`
   - Actor: product
   - Action: `order.cancel`
   - Route: `POST /v1/orders/{orderId}/cancel`, scopes order:write, idempotency required, receipt yes
   - Body: none
   - Path: orderId
   - Query: none
   - Expect: none
   - Bindings: orderId <- order.orderId

### Cancel an unfunded deposit

- Journey id: `unfunded_deposit_canceled`
- Steps: 8

1. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
2. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- customer.customerAccessId
3. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- customer.customerId
4. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
5. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- holder_customer.customerAccessId
6. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- holder_customer.customerId
7. `deposit_hold_create`
   - Actor: product
   - Action: `deposit_hold.create`
   - Route: `POST /v1/deposit-holds`, scopes deposit_hold:write, idempotency required, receipt yes
   - Body: amount, currency, expiresAt, holderAccountId, memo, payerAccountId, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: holderAccountId <- holder.accountId, payerAccountId <- payer.accountId
8. `deposit_hold_cancel`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/deposit-holds/{depositHoldId}/cancel`, scopes deposit_hold:write, idempotency required, receipt yes
   - Body: none
   - Path: depositHoldId
   - Query: none
   - Expect: none
   - Bindings: depositHoldId <- hold.depositHoldId

### Abandon a trade settlement

- Journey id: `abandon_trade_settlement`
- Steps: 7

1. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
2. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- customer.customerAccessId
3. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- customer.customerId
4. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- customer.customerId
5. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- customer.customerId
6. `trade_settlement_create`
   - Actor: product
   - Action: `trade_settlement.create`
   - Route: `POST /v1/trade-settlements`, scopes trade_settlement:write, idempotency required, receipt yes
   - Body: currency, platformAccountId, productId, sideAAccountId, sideAAmount, sideAServiceFeeAmount, sideBAccountId, sideBAmount, sideBServiceFeeAmount
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: platformAccountId <- platform_account.accountId, sideAAccountId <- side_a_account.accountId, sideBAccountId <- side_b_account.accountId
7. `trade_settlement_abandon`
   - Actor: product
   - Action: `trade_settlement.abandon`
   - Route: `POST /v1/trade-settlements/{tradeSettlementId}/abandon`, scopes trade_settlement:write, idempotency required, receipt yes
   - Body: none
   - Path: tradeSettlementId
   - Query: none
   - Expect: none
   - Bindings: tradeSettlementId <- trade.tradeSettlementId

### Sell a listing

- Journey id: `escrow_marketplace_listing_sale`
- Steps: 15

1. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
2. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- seller.customerAccessId
3. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- seller.customerId
4. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
5. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- buyer.customerAccessId
6. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- buyer.customerId
7. `sandbox_account_fund`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/account-funding`, scopes transfer:write, idempotency required, receipt yes
   - Body: amount, currency, destinationAccountId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: destinationAccountId <- buyer_account.accountId
8. `subject_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/subjects`, scopes product:write, idempotency required, receipt yes
   - Body: attributes, declaredValue, kind, kindVersion, productId
   - Path: none
   - Query: none
   - Expect: subjectId, tenantId, productId, kind, kindVersion, attributes, declaredValue, createdAt, metadata
   - Bindings: none
9. `listing_create`
   - Actor: product
   - Action: `listing.create`
   - Route: `POST /v1/listings`, scopes listing:write, idempotency required, receipt yes
   - Body: askingPrice, currency, description, expiresAt, headline, imageUrl, productId, sellerAccountId, subject
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: sellerAccountId <- seller_account.accountId, subject <- subject.subjectId
10. `listing_publish`
   - Actor: product
   - Action: `listing.publish`
   - Route: `POST /v1/listings/{listingId}/publish`, scopes listing:write, idempotency required, receipt yes
   - Body: none
   - Path: listingId
   - Query: none
   - Expect: none
   - Bindings: listingId <- listing.listingId
11. `escrow_order_create`
   - Actor: product
   - Action: `escrow_order.create`
   - Route: `POST /v1/escrow-orders`, scopes escrow_order:write, idempotency required, receipt yes
   - Body: buyerAccountId, fundBy, listingId, memo, productId, subject
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: buyerAccountId <- buyer_account.accountId, listingId <- listing.listingId, subject <- subject.subjectId
12. `escrow_order_fund`
   - Actor: product
   - Action: `escrow_order.fund`
   - Route: `POST /v1/escrow-orders/{escrowOrderId}/fund`, scopes escrow_order:write, transfer:write, idempotency required, receipt yes
   - Body: none
   - Path: escrowOrderId
   - Query: none
   - Expect: none
   - Bindings: escrowOrderId <- escrow.escrowOrderId
13. `listing_reserve`
   - Actor: product
   - Action: `listing.reserve`
   - Route: `POST /v1/listings/{listingId}/reserve`, scopes listing:write, idempotency required, receipt yes
   - Body: escrowOrderId
   - Path: listingId
   - Query: none
   - Expect: none
   - Bindings: listingId <- listing.listingId, escrowOrderId <- escrow.escrowOrderId
14. `escrow_order_release`
   - Actor: product
   - Action: `escrow_order.release`
   - Route: `POST /v1/escrow-orders/{escrowOrderId}/release`, scopes escrow_order:write, transfer:write, idempotency required, receipt yes
   - Body: none
   - Path: escrowOrderId
   - Query: none
   - Expect: none
   - Bindings: escrowOrderId <- escrow.escrowOrderId
15. `listing_sell`
   - Actor: product
   - Action: `listing.sell`
   - Route: `POST /v1/listings/{listingId}/sell`, scopes listing:write, idempotency required, receipt yes
   - Body: none
   - Path: listingId
   - Query: none
   - Expect: none
   - Bindings: listingId <- listing.listingId

### Claim part of a deposit hold

- Journey id: `escrow_marketplace_deposit_hold_claim`
- Steps: 10

1. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
2. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- payer.customerAccessId
3. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- payer.customerId
4. `sandbox_account_fund`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/account-funding`, scopes transfer:write, idempotency required, receipt yes
   - Body: amount, currency, destinationAccountId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: destinationAccountId <- payer_account.accountId
5. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
6. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- holder.customerAccessId
7. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- holder.customerId
8. `deposit_hold_create`
   - Actor: product
   - Action: `deposit_hold.create`
   - Route: `POST /v1/deposit-holds`, scopes deposit_hold:write, idempotency required, receipt yes
   - Body: amount, currency, expiresAt, holderAccountId, memo, payerAccountId, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: payerAccountId <- payer_account.accountId, holderAccountId <- holder_account.accountId
9. `deposit_hold_fund`
   - Actor: product
   - Action: `deposit_hold.fund`
   - Route: `POST /v1/deposit-holds/{depositHoldId}/fund`, scopes deposit_hold:write, transfer:write, idempotency required, receipt yes
   - Body: none
   - Path: depositHoldId
   - Query: none
   - Expect: none
   - Bindings: depositHoldId <- hold.depositHoldId
10. `deposit_hold_claim`
   - Actor: product
   - Action: `deposit_hold.claim`
   - Route: `POST /v1/deposit-holds/{depositHoldId}/claim`, scopes deposit_hold:write, transfer:write, idempotency required, receipt yes
   - Body: actorAccountId, assessmentNote, claimAmount
   - Path: depositHoldId
   - Query: none
   - Expect: none
   - Bindings: actorAccountId <- holder_account.accountId, depositHoldId <- hold.depositHoldId

### Settle an escrow order

- Journey id: `escrow_marketplace_escrow_settlement`
- Steps: 14

1. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
2. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- seller.customerAccessId
3. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- seller.customerId
4. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
5. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- buyer.customerAccessId
6. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- buyer.customerId
7. `sandbox_account_fund`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/account-funding`, scopes transfer:write, idempotency required, receipt yes
   - Body: amount, currency, destinationAccountId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: destinationAccountId <- buyer_account.accountId
8. `subject_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/subjects`, scopes product:write, idempotency required, receipt yes
   - Body: attributes, declaredValue, kind, kindVersion, productId
   - Path: none
   - Query: none
   - Expect: subjectId, tenantId, productId, kind, kindVersion, attributes, declaredValue, createdAt, metadata
   - Bindings: none
9. `listing_create`
   - Actor: product
   - Action: `listing.create`
   - Route: `POST /v1/listings`, scopes listing:write, idempotency required, receipt yes
   - Body: askingPrice, currency, description, expiresAt, headline, imageUrl, productId, sellerAccountId, subject
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: sellerAccountId <- seller_account.accountId, subject <- subject.subjectId
10. `listing_publish`
   - Actor: product
   - Action: `listing.publish`
   - Route: `POST /v1/listings/{listingId}/publish`, scopes listing:write, idempotency required, receipt yes
   - Body: none
   - Path: listingId
   - Query: none
   - Expect: none
   - Bindings: listingId <- listing.listingId
11. `escrow_order_create`
   - Actor: product
   - Action: `escrow_order.create`
   - Route: `POST /v1/escrow-orders`, scopes escrow_order:write, idempotency required, receipt yes
   - Body: buyerAccountId, fundBy, listingId, memo, productId, subject
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: buyerAccountId <- buyer_account.accountId, listingId <- listing.listingId, subject <- subject.subjectId
12. `escrow_order_fund`
   - Actor: product
   - Action: `escrow_order.fund`
   - Route: `POST /v1/escrow-orders/{escrowOrderId}/fund`, scopes escrow_order:write, transfer:write, idempotency required, receipt yes
   - Body: none
   - Path: escrowOrderId
   - Query: none
   - Expect: none
   - Bindings: escrowOrderId <- escrow.escrowOrderId
13. `listing_reserve`
   - Actor: product
   - Action: `listing.reserve`
   - Route: `POST /v1/listings/{listingId}/reserve`, scopes listing:write, idempotency required, receipt yes
   - Body: escrowOrderId
   - Path: listingId
   - Query: none
   - Expect: none
   - Bindings: listingId <- listing.listingId, escrowOrderId <- escrow.escrowOrderId
14. `escrow_order_release`
   - Actor: product
   - Action: `escrow_order.release`
   - Route: `POST /v1/escrow-orders/{escrowOrderId}/release`, scopes escrow_order:write, transfer:write, idempotency required, receipt yes
   - Body: none
   - Path: escrowOrderId
   - Query: none
   - Expect: none
   - Bindings: escrowOrderId <- escrow.escrowOrderId

### Open buyer funding address

- Journey id: `escrow_marketplace_financial_address`
- Steps: 4

1. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
2. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- buyer.customerAccessId
3. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- buyer.customerId
4. `financial_address_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/financial-addresses`, scopes account:write, idempotency required, receipt yes
   - Body: accountId, productId, purpose
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: accountId <- buyer_account.accountId

### Move escrow funds

- Journey id: `escrow_marketplace_money_movement`
- Steps: 9

1. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
2. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- source.customerAccessId
3. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- source.customerId
4. `sandbox_account_fund`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/account-funding`, scopes transfer:write, idempotency required, receipt yes
   - Body: amount, currency, destinationAccountId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: destinationAccountId <- source_account.accountId
5. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
6. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- destination.customerAccessId
7. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- destination.customerId
8. `internal_transfer_reserve`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/internal-transfers/reserve`, scopes transfer:write, idempotency required, receipt yes
   - Body: amount, currency, destinationAccountId, memo, sourceAccountId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: sourceAccountId <- source_account.accountId, destinationAccountId <- destination_account.accountId
9. `internal_transfer_post`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/internal-transfers/{transferId}/post`, scopes transfer:write, idempotency required, receipt yes
   - Body: none
   - Path: transferId
   - Query: none
   - Expect: none
   - Bindings: transferId <- transfer.transferId

### Cancel escrow reserve

- Journey id: `escrow_marketplace_money_movement_cancel`
- Steps: 9

1. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
2. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- source.customerAccessId
3. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- source.customerId
4. `sandbox_account_fund`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/account-funding`, scopes transfer:write, idempotency required, receipt yes
   - Body: amount, currency, destinationAccountId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: destinationAccountId <- source_account.accountId
5. `sandbox_customer_onboard`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-onboarding`, scopes customer:write, idempotency required, receipt yes
   - Body: displayName, productId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: none
6. `sandbox_customer_access_activate`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/sandbox/customer-access/{customerAccessId}/activate`, scopes customer:write, idempotency required, receipt yes
   - Body: none
   - Path: customerAccessId
   - Query: none
   - Expect: none
   - Bindings: customerAccessId <- destination.customerAccessId
7. `account_create`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/accounts`, scopes account:write, idempotency required, receipt yes
   - Body: currency, owner, role
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: owner.id <- destination.customerId
8. `internal_transfer_reserve`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/internal-transfers/reserve`, scopes transfer:write, idempotency required, receipt yes
   - Body: amount, currency, destinationAccountId, memo, sourceAccountId
   - Path: none
   - Query: none
   - Expect: none
   - Bindings: sourceAccountId <- source_account.accountId, destinationAccountId <- destination_account.accountId
9. `internal_transfer_void`
   - Actor: product
   - Action: platform write
   - Route: `POST /v1/internal-transfers/{transferId}/void`, scopes transfer:write, idempotency required, receipt yes
   - Body: reason
   - Path: transferId
   - Query: none
   - Expect: none
   - Bindings: transferId <- transfer.transferId

## Cost

Cost table version 2026-09-02.1. Flat amounts are multiplied by the action count; basis points price the meter's moved amount, which an action count does not determine.

| Instrument | Action | Effect | Meter | Flat per action | Rate on meter | 1,000 per month | 100,000 per month | 10,000,000 per month |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `deposit_hold` | `claim` | `decides.tenant_port` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `deposit_hold` | `claim` | `moves.transfer.internal` | `transfer.internal.volume_sar` | 0.75 SAR | 11 bps | 750.00 SAR | 75,000.00 SAR | 7,500,000.00 SAR |
| `deposit_hold` | `claim` | `schedules.deadline` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `deposit_hold` | `create` | `schedules.deadline` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `deposit_hold` | `expire` | `moves.transfer.internal` | `transfer.internal.volume_sar` | 0.75 SAR | 11 bps | 750.00 SAR | 75,000.00 SAR | 7,500,000.00 SAR |
| `deposit_hold` | `expire` | `schedules.due` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `deposit_hold` | `fund` | `holds.reserve` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `deposit_hold` | `fund` | `moves.transfer.internal` | `transfer.internal.volume_sar` | 0.75 SAR | 11 bps | 750.00 SAR | 75,000.00 SAR | 7,500,000.00 SAR |
| `deposit_hold` | `fund` | `schedules.deadline` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `deposit_hold` | `return` | `decides.tenant_port` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `deposit_hold` | `return` | `moves.transfer.internal` | `transfer.internal.volume_sar` | 0.75 SAR | 11 bps | 750.00 SAR | 75,000.00 SAR | 7,500,000.00 SAR |
| `deposit_hold` | `return` | `schedules.deadline` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `escrow_order` | `collect_penalty` | `moves.transfer.internal` | `transfer.internal.volume_sar` | 0.75 SAR | 11 bps | 750.00 SAR | 75,000.00 SAR | 7,500,000.00 SAR |
| `escrow_order` | `create` | `reads.requires_refs` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `escrow_order` | `expire` | `schedules.due` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `escrow_order` | `fund` | `moves.collection.pay_in` | `collection.pay_in.volume_sar` | 2.50 SAR | 16 bps | 2,500.00 SAR | 250,000.00 SAR | 25,000,000.00 SAR |
| `escrow_order` | `fund` | `reads.requires_refs` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `escrow_order` | `quote` | `holds.quote` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `escrow_order` | `quote` | `schedules.expiry` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `escrow_order` | `refund` | `moves.transfer.internal` | `transfer.internal.volume_sar` | 0.75 SAR | 11 bps | 750.00 SAR | 75,000.00 SAR | 7,500,000.00 SAR |
| `escrow_order` | `release` | `moves.transfer.internal` | `transfer.internal.volume_sar` | 0.75 SAR | 11 bps | 750.00 SAR | 75,000.00 SAR | 7,500,000.00 SAR |
| `escrow_order` | `release` | `reads.requires_refs` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `listing` | `expire` | `schedules.due` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `listing` | `reopen` | `reads.requires_refs` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `listing` | `reserve` | `reads.requires_refs` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `listing` | `sell` | `reads.requires_refs` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `order` | `cancel` | `reads.requires_refs` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `order` | `confirm` | `reads.requires_refs` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `order` | `create` | `reads.requires_refs` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `order` | `expire` | `schedules.due` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `order` | `fulfill` | `reads.requires_refs` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `trade_settlement` | `cancel` | `moves.transfer.internal` | `transfer.internal.volume_sar` | 0.75 SAR | 11 bps | 750.00 SAR | 75,000.00 SAR | 7,500,000.00 SAR |
| `trade_settlement` | `dispute` | `decides.tenant_port` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `trade_settlement` | `dispute` | `moves.transfer.internal` | `transfer.internal.volume_sar` | 0.75 SAR | 11 bps | 750.00 SAR | 75,000.00 SAR | 7,500,000.00 SAR |
| `trade_settlement` | `dispute` | `schedules.deadline` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `trade_settlement` | `fund` | `moves.collection.pay_in` | `collection.pay_in.volume_sar` | 2.50 SAR | 16 bps | 2,500.00 SAR | 250,000.00 SAR | 25,000,000.00 SAR |
| `trade_settlement` | `fund` | `moves.transfer.internal` | `transfer.internal.volume_sar` | 0.75 SAR | 11 bps | 750.00 SAR | 75,000.00 SAR | 7,500,000.00 SAR |
| `trade_settlement` | `post` | `moves.transfer.internal` | `transfer.internal.volume_sar` | 0.75 SAR | 11 bps | 750.00 SAR | 75,000.00 SAR | 7,500,000.00 SAR |
| `trade_settlement` | `post` | `schedules.due` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `trade_settlement` | `release` | `decides.tenant_port` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `trade_settlement` | `release` | `holds.reserve` | `instrument.event.count` | 0.00 SAR | 0 bps | 0.00 SAR | 0.00 SAR | 0.00 SAR |
| `trade_settlement` | `release` | `moves.transfer.internal` | `transfer.internal.volume_sar` | 0.75 SAR | 11 bps | 750.00 SAR | 75,000.00 SAR | 7,500,000.00 SAR |
| **Total flat** | | | | | | **14,000.00 SAR** | **1,400,000.00 SAR** | **140,000,000.00 SAR** |