{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/partner-api/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Jiko Data Model","description":"Jiko Technologies' external APIs for integrators.","lang":"en-US","siteUrl":"https://docs.jiko.io","projectTitle":"Jiko Technologies API Documentation","jsonLd":{"@context":"https://schema.org","@type":"Organization","name":"Jiko Technologies","url":"https://docs.jiko.io","logo":"https://docs.jiko.io/static/jiko-logo-blue.svg"},"llmstxt":{"hide":false,"title":"Jiko Technologies API Documentation","description":"External APIs for integrators","sections":[{"title":"Customer API","includeFiles":["products/customer-api/**/*.md"],"excludeFiles":[]},{"title":"Partner API","includeFiles":["products/partner-api/**/*.md"],"excludeFiles":[]}],"excludeFiles":[]},"meta":[{"name":"robots","content":"index,follow,max-image-preview:large"}]},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"jiko-data-model","__idx":0},"children":["Jiko Data Model"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before making your first API call, it is important to understand how data is structured within your Jiko integration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your entire integration exists within a securely isolated ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Partner Tenant"]}," (your overarching platform environment):"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/datamodel2.9e3b0e204296310f1808b798a4dc4801abe5195a7a4e294eda82dc2d78f6289e.9c1bb791.png","alt":"Pockets Diagram"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-customers-end-users","__idx":1},"children":["1. Customers (End Users)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once an individual or business successfully completes the KYC or KYB onboarding process, they become a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Customer is the verified legal entity that owns the underlying assets. Your Partner Tenant can manage many Customers."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Physical and virtual ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["debit cards"]}," are also issued at this level and are directly tied to a specific customer."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-pockets-the-financial-engine","__idx":2},"children":["2. Pockets (The Financial Engine)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Customer does not have a single balance. Instead, they have one or more ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pockets"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Pocket is the core construct of the Jiko platform. It combines:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A bank account for cash movement"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A brokerage account for T-Bill exposure"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A single Customer can have multiple Pockets, for example:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Operating Capital"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Payroll"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-portals","__idx":3},"children":["3. Portals"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To move money in and out of the Jiko ecosystem, a Pocket requires an access point."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Portal"]}," generates a unique routing number and account number tied to a specific Pocket. Multiple Portals can be created per Pocket, for example:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["One for receiving wires"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["One for payroll deposits"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each pocket comes with one portal already instantiated, but you can create more as required."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"summary","__idx":4},"children":["Summary"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["1 Partner Tenant → Many Customers"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["1 Customer → Many Pockets and Cards"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["1 Pocket → Many Portals"]}]}]},"headings":[{"value":"Jiko Data Model","id":"jiko-data-model","depth":2},{"value":"1. Customers (End Users)","id":"1-customers-end-users","depth":3},{"value":"2. Pockets (The Financial Engine)","id":"2-pockets-the-financial-engine","depth":3},{"value":"3. Portals","id":"3-portals","depth":3},{"value":"Summary","id":"summary","depth":2}],"frontmatter":{"seo":{"title":"Jiko Data Model"}},"lastModified":"2026-06-11T20:08:46.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/partner-api/guides/building/data-model","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}