---
title: "Read the current native payment source snapshot"
method: POST
path: "/v1/commerce/payments/snapshot"
---

# Read the current native payment source snapshot

`POST /v1/commerce/payments/snapshot`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/commerce/payments/snapshot`
- Auth: HTTP bearer

Default off. Current ordinary workspace API key with decision:read and decision:write; no runtime-key scope expansion. Fixed managed Business Central reader checks current connection/grant/assignment and exact native context, preserving the native observation time. Beneficiary verification remains unverified. Unsupported, stale, changing or locked source fails closed. No payment execution.

## Request body

- CommercePaymentSnapshotRequest
  - `version` 'commerce-payment-snapshot-request-v1', required
  - `native_context` object, required
    - `version` 'commerce-native-context-v1', required
    - `org_id` string, uuid, required
    - `workspace_environment` 'sandbox' | 'production', required
    - `connection_id` string, uuid, required
    - `expected_revision` integer, required
    - `environment_name` string, required
    - `company_id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `journal_id` string, uuid, required

## Response `200`

Bound result. A grant, when one is bound, is a single-use permit for one exact payment line; Core executes nothing.

- CommercePaymentSnapshotResponse
  - `version` 'commerce-payment-snapshot-response-v1', required
  - `workspace` object, required
    - `org_id` string, required
    - `workspace_id` string, required
    - `environment` 'sandbox' | 'production', required
    - `source_org_id` string, uuid, required
  - `snapshot` object, required
    - `version` 'commerce-payment-snapshot-v1', required
    - `tenant_id` string, uuid, required
    - `native_context` object, required
      - `version` 'commerce-native-context-v1', required
      - `org_id` string, uuid, required
      - `workspace_environment` 'sandbox' | 'production', required
      - `connection_id` string, uuid, required
      - `expected_revision` integer, required
      - `environment_name` string, required
      - `company_id` string, uuid, required
    - `payment` object, required
      - `payment_id` string, required
      - `vendor_id` string, required
      - `invoice_id` string
      - `amount` number, required
      - `currency` string, required
      - `due_at` string, date-time
      - `rail` 'ach' | 'wire' | 'card' | 'stablecoin' | 'other'
    - `facts` object, required
      - `observed_at` string, date-time, required
      - `payment` object, required
        - `prior_payment_count` integer, required
      - `treasury` object, required
        - `cash_position` number, required
        - `run_total` number, required
      - `beneficiary` object, required
        - `changed_at` string, date-time, nullable, required
        - `verification` 'unverified', required
    - `payment_evidence` object, required
      - `version` 'commerce-payment-evidence-v1', required
      - `method` 'ledger_cash_same_currency_single_payment_v1', required
      - `source` object
        - `sandbox` boolean, required
        - `evaluation_company` boolean, required
      - `journal_id` string, uuid, required
      - `journal_revision` string, required
      - `batch_id` string, uuid, required
      - `batch_revision` string, required
      - `invoice_entry_id` string, uuid, required
      - `invoice_revision` string, required
      - `invoice_remaining_amount` number, required
      - `funding_bank_id` string, uuid, required
      - `funding_bank_revision` string, required
      - `beneficiary_bank_id` string, uuid, required
      - `beneficiary_bank_revision` string, required
      - `source_revisions` object, required
        - `run` string, required
        - `invoice` string, required
        - `treasury` string, required
      - `snapshot_sha256` string, required

## Other responses

- `400`: Bounded refusal or unavailable dependency; no payment execution.
- `401`: Bounded refusal or unavailable dependency; no payment execution.
- `402`: Bounded refusal or unavailable dependency; no payment execution.
- `403`: Bounded refusal or unavailable dependency; no payment execution.
- `404`: Bounded refusal or unavailable dependency; no payment execution.
- `409`: Bounded refusal or unavailable dependency; no payment execution.
- `413`: Bounded refusal or unavailable dependency; no payment execution.
- `429`: Bounded refusal or unavailable dependency; no payment execution.
- `503`: Bounded refusal or unavailable dependency; no payment execution.

---

[API](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/revisions/357f5e459d0c?raw)