---
name: myaza-workflows
description: Integrate and improve Myaza Trust workflows and decisioning flows. Use when designing, implementing, debugging or reviewing workflows and decisioning, including policy outcomes, customer enforcement and recovery.
---

# Myaza Trust: Workflows and decisioning

## Start with the customer outcome

Design a customer journey and apply the organisation's published decisions.
Ask only for missing choices that affect the design: the customer's business flow, launch markets, review team, desired decision and the action their application will enforce. Do not ask for API keys in chat.

## Read the current contract

1. Discover current resources at https://trust.myaza.co/llms.txt and https://trust.myaza.co/documentation/index.json.
2. Read these guides before implementation. They are the same authored source as the human documentation:
   - https://trust.myaza.co/documentation/workflows/markdown
   - https://trust.myaza.co/documentation/decisioning/markdown
   - https://trust.myaza.co/documentation/hosted-events/markdown
   - https://trust.myaza.co/documentation/verifications/markdown
   - https://trust.myaza.co/documentation/api-config/markdown
   - https://trust.myaza.co/documentation/webhook-verification/markdown
3. Also read authentication, environments, errors and webhook authentication. Use https://trust.myaza.co/documentation/ai-integration/markdown for API-family boundaries and handoff requirements.
4. For /api/v1 operations, fetch https://trust.myaza.app/api/openapi.json and resolve referenced schemas. Do not assume it describes the separate /api/kyc or /api/identity families. Their guide contracts remain necessary.
5. If the guide and deployed response differ, report the discrepancy and inspect the actual schema. Never invent an endpoint, enum or readiness flag. Use the index SHA-256 values to identify the content reviewed.

## Design safeguards

Separate draft configuration from the published workflow. Changing a draft must not silently alter running or published experiences. Consent, capture, processing and final disposition are different stages. Presence and Decisioning share faceMatchedAccounts and faceSearchStatus; count distinct other accounts within the same organisation and environment. Propose review thresholds to the customer; do not enable blocking or publish policies without their approval. Preserve custom branding eligibility and component billing semantics.

Keep credentials on the customer's backend. Scope reads and writes to the organisation and environment. Use least-privilege permission checks. Never auto-publish a policy, activate Live, change financial entitlements or approve a company on the user's behalf without explicit permission. Country coverage and rules are not a guarantee of regulatory compliance; the organisation's authorised reviewer owns its obligations.

## Implement and verify

- Start in Sandbox. Use documented explicit scenarios for deterministic tests; ordinary Sandbox operations can use configured pricing.
- Reuse stable customer and operation references. Send an idempotency key where the operation contract requires one. On an uncertain response, retain the same payload and key and reconcile current state.
- Model pending, review, blocked, unavailable and retryable states explicitly. Never turn an error or missing result into approval.
- Verify signed webhooks on raw bytes, deduplicate and persist before acknowledging, and fetch current state before enforcement.
- Minimise personal data. Do not log keys, raw identity documents, party details, full wallet addresses or biometric evidence.
- Add executable tests for the happy path, invalid input, missing information, tenant/environment isolation, permission denial, duplicate requests, timeout/recovery and out-of-order notifications.
- Use the product's testing guide for required negative and boundary cases. A mocked success does not prove a real institution channel or Live readiness.

## Deliver the customer handoff

Provide the implemented flow, exact API families and versions used, data mapping, decision-to-action table, review owner, webhook recovery procedure, test evidence, and unresolved external prerequisites. Separate local qualification from Sandbox integration and Live acceptance. Suggest workflow improvements with rationale and trade-offs; do not silently change the customer's risk appetite or claim legal approval.