Μενού τεκμηρίωσης: Overview

Tallio docs

Docs

Everything you need to send documents through Tallio: a short path through the sandbox, then the API reference.

Σε αυτή τη σελίδα

From sandbox key to webhook
Your first call
API reference

Σημείωση

Tallio is in early access. The sandbox is live and stands in for the provider and AADE, so nothing you send there is issued. Get early access for a sandbox key.

From sandbox key to webhook #

Get a sandbox key
Early access comes with a test key (sk_test_…). Send it as a Bearer token on every request.
Preview a document
Create a merchant for the business, then preview a document: Tallio validates and classifies it and returns any warnings, without issuing it.
Issue it
Create the document with an idempotency key. A retry with the same key returns the first document.
Receive the webhook
When the document is issued, Tallio sends a signed webhook with the result. Check the signature before you trust it.

Your first call #

Preview a document from a shell: set TALLIO_API_URL and TALLIO_API_KEY (your sandbox key), and put the document in document.json. Nothing is issued.

POST /api/v1/documents/preview

curl "$TALLIO_API_URL/api/v1/documents/preview" \
  -H "Authorization: Bearer $TALLIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d @document.json