{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-Docs/Get-started/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Core Concepts"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"core-concepts","__idx":0},"children":["Core Concepts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before making your first API call, it helps to understand the key objects in Talli and how they relate to each other. This page explains the core entities, distributions, beneficiaries and payouts and how they fit together across a typical payout lifecycle."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"distributions","__idx":1},"children":["Distributions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A distribution represents a fund disbursement event, a single payout programme sent to a group of beneficiaries. It is the top level object in Talli. Every payout instruction and report belongs to a distribution."," ","When you create a distribution you define the funding source, the allowed payout methods, and the beneficiaries who will receive funds. From there, Talli manages the notification and redemption flow for each individual beneficiary."," ","Each beneficiary within a distribution has their own payout instruction, which tracks their individual journey from the moment it is loaded onto the platform through to fulfilment"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"beneficiaries","__idx":2},"children":["Beneficiaries"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A beneficiary is enrolled within a distribution to receive a payout. In Talli, beneficiaries are represented as payout instructions, there is no separate beneficiary object. Each beneficiary has their own payout instruction which tracks their individual journey from notification through to payout fulfilment"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payouts","__idx":3},"children":["Payouts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In Talli, there is no standalone payout object. A payout is the outcome of a payout instruction, once a beneficiary selects their preferred payout method and submits their details, the payout instruction tracks the payout through to fulfilment."," ","Talli supports multiple payout methods within a single distribution: ACH transfer, PayPal, Venmo, prepaid card, gift card, and paper check. Each method captures different information from the beneficiary at redemption time. The payout instruction reflects the status of that payout at every stage, from method selection through to fulfilment."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"entity-relationship-diagram","__idx":4},"children":["Entity Relationship Diagram"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","align":"center","width":"60%","diagramType":"mermaid","diagramSource":"flowchart TD\n A[\"Distribution\"] --\"contains\"--> B[\"Beneficiaries\"]\n B --\"receive\"--> C[\"Payouts\"]\n","diagramHtml":"

contains

receive

Distribution

Beneficiaries

Payouts

","diagramHtmlDark":"

contains

receive

Distribution

Beneficiaries

Payouts

"},"children":["flowchart TD\n A[\"Distribution\"] --\"contains\"--> B[\"Beneficiaries\"]\n B --\"receive\"--> C[\"Payouts\"]\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["How distribution, beneficiaries and payouts connect across a typical payout lifecycle"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"next-steps","__idx":5},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/get-started/first-call-guide"},"children":["Your first API call"]}," — make your first request to the Talli API"]}]}]},"headings":[{"value":"Core Concepts","id":"core-concepts","depth":2},{"value":"Distributions","id":"distributions","depth":3},{"value":"Beneficiaries","id":"beneficiaries","depth":3},{"value":"Payouts","id":"payouts","depth":3},{"value":"Entity Relationship Diagram","id":"entity-relationship-diagram","depth":3},{"value":"Next steps","id":"next-steps","depth":3}],"frontmatter":{"seo":{"title":"Core Concepts"}},"lastModified":"2026-06-17T12:09:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/get-started/core-concepts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}