Delta Verification Setup

# Delta Verification Setup

> Connect Delta verification to Conto approval workflows and prepare an organization for testing

- Human URL: https://conto.finance/docs/guides/delta-setup
- Raw Markdown: https://conto.finance/docs/guides/delta-setup.md
- Terminal view: https://conto.finance/ai/docs/guides/delta-setup

Documentation group: Guides

# Delta Verification Setup

Delta adds an external verification step to matching payment approvals. Conto creates an approval
request, sends a signed webhook with the payment and invoice context, waits for the decision, and
then lets the payment continue or records the rejection.

Info:

  Delta is enabled through guided onboarding. To add it to an organization, contact
  [sales@conto.finance](mailto:sales@conto.finance) or your Conto contact.

## What To Provide

Prepare the following before onboarding:

- the Conto organization to connect
- the public HTTPS URL of your Delta verification webhook
- a shared HMAC secret for signing and verifying requests
- optional agent references if verification should apply only to selected agents
- a representative vendor and invoice scenario for the first test

  The webhook URL must be publicly reachable. Targets that resolve to loopback, private, or
  internal-only addresses are rejected.

## What Gets Connected

During onboarding, Conto connects three customer-visible pieces:

- an approval workflow that determines which payments require Delta verification
- a signed notification channel that delivers approval requests
- a Delta verification record that keeps the decision, proof reference, and related payment
  together for reconciliation

You do not need to create these records individually unless your onboarding contact asks you to.

## Readiness Signals

Delta is ready for a first test when:

- the **Delta** section appears in the dashboard
- a matching payment request returns `REQUIRES_APPROVAL` and an `approvalRequestId`
- your verification service receives a signed `approval.requested` event
- the Delta detail view records the decision and proof reference after the callback

If any signal is missing, check the workflow scope and webhook delivery, then contact your Conto
onboarding contact if the organization still does not appear enabled.

## Prepare A Test Payment

Before running the end-to-end test, confirm that the organization has:

- an agent included in the workflow scope
- the managed- or external-wallet payment path you intend to use
- an approved counterparty for the vendor address
- payment requests that include `context.invoice`

Continue with [Delta End-to-End Test](https://conto.finance/guides/delta-smoke-test).

## Related Docs

### Delta End-to-End Test
Link: https://conto.finance/guides/delta-smoke-test

    Verify request, decision, payment, and dashboard reconciliation

### Notification Channels
Link: https://conto.finance/integrations/notification-channels

    Review webhook signatures, delivery, and decision callbacks

### External Approvals
Link: https://conto.finance/guides/external-approvals

    Understand the general external approval contract

### Payments API
Link: https://conto.finance/sdk/payments

    Request, execute, confirm, and inspect payments