# rodoslay-toka/tokapay-integration-starter architecture

> Architecture diagram of the GitHub repository rodoslay-toka/tokapay-integration-starter, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rodoslay-toka/tokapay-integration-starter
- Repository: https://github.com/rodoslay-toka/tokapay-integration-starter

## Overview

Tokapay Integration Starter is a partner-developer template for calling Tokapay acquiring APIs. Developers run language-specific examples, which construct signed requests and call Tokapay; the API response is the result to inspect, with payment inquiry and refund inquiry supporting follow-up status checks. The graph also preserves the README’s other API capabilities, Postman scaffolding, and integration guidance. Signing implementations and example relationships are shown where excerpts or the README support them; unsampled example internals are not inferred.

Main entry points: [`lib/node/signing.ts`](https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/lib/node/signing.ts) (Node signing), [`examples/node`](https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node) (Payment inquiry), [`lib/java/SigningUtil.java`](https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/lib/java/SigningUtil.java) (Java signing), [`postman/Tokapay_Collection.json`](https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/postman/Tokapay_Collection.json) (Postman collection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_examples["API examples"]
  node_qr["Dynamic QR"]
  node_payment["Payment orders"]
  node_payment_status["Payment inquiry"]
  node_payment_close["Payment close"]
  node_refund["Refund apply"]
  node_refund_status["Refund inquiry"]
  node_recon["Reconciliation"]
  node_user_merchant["User and merchant info"]
end

subgraph group_signing["Signing helpers"]
  node_node_signing["Node signing<br/>[signing.ts]"]
  node_python_signing["Python signing<br/>[signing.py]"]
  node_java_signing["Java signing<br/>[SigningUtil.java]"]
  node_signing_payload["Signing payload"]
  node_signing_error["Signing exception"]
  node_dotnet_signing[".NET signing<br/>[Signing.cs]"]
end

subgraph group_resources["Integration resources"]
  node_postman["Postman collection"]
  node_docs["Integration docs"]
end

node_developer(("Partner developer"))
node_api{{"Tokapay API"}}

node_developer -->|"runs example"| node_qr
node_developer -->|"runs example"| node_payment
node_developer -->|"checks status"| node_payment_status
node_developer -->|"runs example"| node_payment_close
node_developer -->|"runs example"| node_refund
node_developer -->|"checks status"| node_refund_status
node_developer -->|"fetches links"| node_recon
node_developer -->|"runs example"| node_user_merchant
node_qr -.->|"signs request"| node_node_signing
node_payment -.->|"signs request"| node_node_signing
node_payment_status -.->|"signs request"| node_node_signing
node_payment_close -.->|"signs request"| node_node_signing
node_refund -.->|"signs request"| node_node_signing
node_refund_status -.->|"signs request"| node_node_signing
node_recon -.->|"signs request"| node_node_signing
node_user_merchant -.->|"signs request"| node_node_signing
node_qr -->|"calls endpoint"| node_api
node_payment -->|"calls endpoint"| node_api
node_payment_status -->|"calls endpoint"| node_api
node_payment_close -->|"calls endpoint"| node_api
node_refund -->|"calls endpoint"| node_api
node_refund_status -->|"calls endpoint"| node_api
node_recon -->|"calls endpoint"| node_api
node_user_merchant -->|"calls endpoint"| node_api
node_api -->|"returns status"| node_payment_status
node_api -->|"returns status"| node_refund_status
node_java_signing -->|"accepts payload"| node_signing_payload
node_java_signing -->|"throws on failure"| node_signing_error
node_postman -->|"scaffolds requests"| node_api
node_developer -->|"consults guidance"| node_docs

click node_qr "https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node"
click node_payment "https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node"
click node_payment_status "https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node"
click node_payment_close "https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node"
click node_refund "https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node"
click node_refund_status "https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node"
click node_recon "https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node"
click node_user_merchant "https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node"
click node_node_signing "https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/lib/node/signing.ts"
click node_python_signing "https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/lib/python/signing.py"
click node_java_signing "https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/lib/java/SigningUtil.java"
click node_signing_payload "https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/lib/java/model/SigningPayload.java"
click node_signing_error "https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/lib/java/SigningException.java"
click node_dotnet_signing "https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/lib/dotnet/Signing.cs"
click node_postman "https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/postman/Tokapay_Collection.json"
click node_docs "https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/docs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_qr,node_payment,node_payment_status,node_payment_close,node_refund,node_refund_status,node_recon,node_user_merchant toneBlue
class node_node_signing,node_python_signing,node_java_signing,node_signing_payload,node_signing_error,node_dotnet_signing toneAmber
class node_postman,node_docs,node_api toneMint
class node_developer toneIndigo
```

## Components

### API examples

- [Dynamic QR](https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node): `examples/node`
- [Payment orders](https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node): `examples/node`
- [Payment inquiry](https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node): `examples/node`
- [Payment close](https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node): `examples/node`
- [Refund apply](https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node): `examples/node`
- [Refund inquiry](https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node): `examples/node`
- [Reconciliation](https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node): `examples/node`
- [User and merchant info](https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/examples/node): `examples/node`

### Signing helpers

- [Node signing](https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/lib/node/signing.ts): `lib/node/signing.ts`
- [Python signing](https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/lib/python/signing.py): `lib/python/signing.py`
- [Java signing](https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/lib/java/SigningUtil.java): `lib/java/SigningUtil.java`
- [Signing payload](https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/lib/java/model/SigningPayload.java): `lib/java/model/SigningPayload.java`
- [Signing exception](https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/lib/java/SigningException.java): `lib/java/SigningException.java`
- [.NET signing](https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/lib/dotnet/Signing.cs): `lib/dotnet/Signing.cs`

### Integration resources

- [Postman collection](https://github.com/rodoslay-toka/tokapay-integration-starter/blob/main/postman/Tokapay_Collection.json): `postman/Tokapay_Collection.json`
- [Integration docs](https://github.com/rodoslay-toka/tokapay-integration-starter/tree/main/docs): `docs`

### Other components

- **Partner developer**
- **Tokapay API**

## Connections

- Partner developer → Dynamic QR: runs example (evidence: `README.md`)
- Partner developer → Payment orders: runs example (evidence: `README.md`)
- Partner developer → Payment inquiry: checks status (evidence: `README.md`)
- Partner developer → Payment close: runs example (evidence: `README.md`)
- Partner developer → Refund apply: runs example (evidence: `README.md`)
- Partner developer → Refund inquiry: checks status (evidence: `README.md`)
- Partner developer → Reconciliation: fetches links (evidence: `README.md`)
- Partner developer → User and merchant info: runs example (evidence: `README.md`)
- Dynamic QR → Node signing: signs request
- Payment orders → Node signing: signs request
- Payment inquiry → Node signing: signs request
- Payment close → Node signing: signs request
- Refund apply → Node signing: signs request
- Refund inquiry → Node signing: signs request
- Reconciliation → Node signing: signs request
- User and merchant info → Node signing: signs request
- Dynamic QR → Tokapay API: calls endpoint (evidence: `README.md`)
- Payment orders → Tokapay API: calls endpoint (evidence: `README.md`)
- Payment inquiry → Tokapay API: calls endpoint (evidence: `README.md`)
- Payment close → Tokapay API: calls endpoint (evidence: `README.md`)
- Refund apply → Tokapay API: calls endpoint (evidence: `README.md`)
- Refund inquiry → Tokapay API: calls endpoint (evidence: `README.md`)
- Reconciliation → Tokapay API: calls endpoint (evidence: `README.md`)
- User and merchant info → Tokapay API: calls endpoint (evidence: `README.md`)
- Tokapay API → Payment inquiry: returns status (evidence: `README.md`)
- Tokapay API → Refund inquiry: returns status (evidence: `README.md`)
- Java signing → Signing payload: accepts payload (evidence: `lib/java/SigningUtil.java`)
- Java signing → Signing exception: throws on failure (evidence: `lib/java/SigningUtil.java`)
- Postman collection → Tokapay API: scaffolds requests (evidence: `README.md`)
- Partner developer → Integration docs: consults guidance (evidence: `README.md`)
