Business Accounts — list of endpoints

Every endpoint in the Business Accounts (B2B) section of the API Reference →. Click any row to open the full reference page with payload, examples, and the Try it widget.

Tenant creation

Tenants are created by PayNovus, not by partners. Contact PayNovus to request a tenant be linked to your partner account — once it is, it shows up in GET /api/partner/me and you can operate on it through the Partner API.

Tenants

Method	Endpoint	What it does
GET	/business/accounts	Full list of every tenant linked to your partner.
GET	/business/accounts/{b2bAccountId}	Tenant details + linked debit accounts. Returns 404 if the tenant does not belong to your partner.

IBANs & settings

Method	Endpoint	What it does
GET	/business/accounts/{b2bAccountId}/ibans/for-issuing	Tenant debit accounts eligible for new card issuance.
PATCH	/business/accounts/{b2bAccountId}/iban-settings	Submit IBAN settings (name, isActive, isPrimary) for PayNovus approval. Returns 202 with taskId.

Products

Method	Endpoint	What it does
GET	/business/accounts/{b2bAccountId}/products	Tenant products. Optional ?kind=virtual|physical to narrow by card type.

Balances, logs & transactions

Method	Endpoint	What it does
GET	/business/accounts/{b2bAccountId}/balances	Live availableBalance per IBAN, fetched in parallel. Per-IBAN failures appear as status: "error".
GET	/business/accounts/{b2bAccountId}/logs/audit	Tenant audit logs (paginated). Default: page=1, limit=50.
GET	/business/accounts/{b2bAccountId}/logs/card-status-history	Tenant-wide card-status history (paginated). Default: page=1, limit=50.
GET	/business/accounts/{b2bAccountId}/transactions	Tenant transactions (paginated). Default: page=1, limit=10.

Cardholders

Method	Endpoint	What it does
GET	/business/accounts/{b2bAccountId}/cardholders	Cardholders under the tenant. Excludes self-admin rows.
POST	/business/accounts/{b2bAccountId}/cardholders	Submit a B2B cardholder for PayNovus approval. Returns 202 with status: "PENDING" and a taskId. Email conflict against the tenant returns 409.
GET	/business/cardholders/{id}	Cardholder details + resolved accounts + active cards + live balance.
GET	/business/cardholders/{id}/cards	Active cards for the cardholder.
GET	/business/cardholders/{id}/ibans/for-issuing	IBANs the cardholder is allowed to issue against — own IBANs plus any B2B-shared tenant accounts.
POST	/business/cardholders/{id}/cards/virtual	Issue a virtual card for the cardholder.
POST	/business/cardholders/{id}/cards/physical	Issue a physical card for the cardholder. Requires deliveryMethod._id from GET /fees/delivery-methods.
POST	/business/cardholders/{id}/cards/prepaid/virtual	Request a prepaid virtual card (R008) for the cardholder. The card is created in the background, in about 2-3 minutes. See the Prepaid cards guide.
POST	/business/cardholders/{id}/cards/prepaid/physical	Request a prepaid physical card (R007) for the cardholder. The fees are blocked on the main account first. The card is created in the background. See the Prepaid cards guide.
GET	/business/cardholders/{id}/cards/prepaid	List the prepaid card requests of the cardholder and where each one is.
GET	/business/cardholders/{id}/cards/prepaid/{requestId}	Where one prepaid card request is (status, isFinished, cardKey).

Pagination and full-result behavior

• Full-list endpoints (GET /business/accounts, GET /business/accounts/{id}/cardholders, GET /business/cardholders/{id}/cards) return the complete matching result set in one response with a count field. No page/limit parameters are accepted.
• Paginated endpoints (audit logs, card status history, transactions) default to page=1, limit=50 (audit/history) or limit=10 (transactions). There is currently no enforced maximum limit value.
• Async endpoints (PATCH /iban-settings, POST /cardholders) return 202 Accepted with a taskId. The partner can poll taskId to learn the approval outcome; until then the resource remains in PENDING.

Approval-gated cardholder creation

B2B cardholder creation goes through PayNovus approval before the onboarding becomes usable. The endpoint returns 202 PENDING immediately, but the onboarding is not active until the approval task completes. Direct partner-owned individuals under /individual/accounts do not have this gating — they return synchronously.