Banking as a Service (BaaS)

Create bank accounts, process transfers, and manage entity onboarding through a unified API

Yuno BaaS provides a unified API for creating bank accounts, processing transfers, and managing entity onboarding across multiple banking providers in the US, UK, Australia, and EU regions.

How BaaS Relates to Payments

BaaS and Yuno’s core payments platform share infrastructure but serve different purposes:

• Same authentication. BaaS uses the same API authentication as payments. Send public-api-key and private-secret-key as HTTP headers, and your account_id inside body fields that take it. See Authentication.
• Payout integration. BaaS entities can receive payouts from payment splits via their recipient IDs. This enables marketplace and platform flows where payment funds are split and disbursed to BaaS-managed accounts.
• Regional availability. BaaS is currently available in Brazil and Mexico, with expansion planned to additional markets.
• Separate endpoints. BaaS endpoints are under /v1/baas/ and are separate from /v1/payments/. They have their own resource models, statuses, and webhook events.

Integration flow

1. Create an entity. Register an individual or business using the Create Entity endpoint
2. Onboard the entity. Submit KYC/KYB documentation through Create Entity Onboarding
3. Wait for approval. Monitor status via Get Onboarding Status or webhook events
4. Create a bank account. Open an account using Create Account after onboarding succeeds
5. Initiate transfers. Send funds using Initiate Transfer

Entity types

Type	Description	Required information
INDIVIDUAL	Natural person	Name, DOB, tax ID (SSN/ITIN), identity documents
ENTITY	Business or organization	Business name, type, tax ID (EIN), beneficial owners

Onboarding types

Type	Description
ONE_STEP	Submits all information, declarations, and documents simultaneously for provider processing
PREVIOUSLY_ONBOARDED	Generates internal Yuno ID without contacting provider. Use when the entity was onboarded externally

Onboarding statuses

Status	Description	Terminal
CREATED	Record created	No
PENDING	Submitted to provider, awaiting review	No
PENDING_ADDITIONAL_DOCUMENTATION	Provider requires more documents	No
UNDER_REVIEW	Provider reviewing submission	No
SUCCEEDED	Approved. Entity can open accounts	Yes
FAILED	Failed due to errors	Yes
DECLINED	Provider declined entity	Yes
CANCELLED	Cancelled by merchant	Yes
EXPIRED	Expired before completion	Yes

Payment rails by region

Region	Rails	Speed
US	ACH_STANDARD	1 to 3 business days
	ACH_SAME_DAY	Same day
	WIRE	Same day
	RTP	Instant
UK	FPS	Near-instant
	CHAPS	Same day (high-value)
	BACS	3 business days
Australia	NPP	Near-instant
	PAYTO	Near-instant
	BPAY	1 to 2 business days

Instant payment rails (RTP, FPS, NPP) skip the PROCESSING status and move directly from PENDING to a terminal state.

Account identifiers by region

Region	Identifiers
US	account_number, routing_number
UK	account_number, sort_code, iban
Australia	account_number, bsb
EU	iban, swift

Transfer statuses

Status	Description	Terminal
PENDING	Created, awaiting processing	No
PROCESSING	Submitted to payment network	No
COMPLETED	Funds successfully delivered	Yes
FAILED	Transfer failed	Yes
CANCELLED	Cancelled before processing	Yes
REVERSED	Completed transfer reversed (e.g., ACH return)	Yes

Documentation types

BaaS onboarding supports these document categories:

Type	Examples
IDENTITY_DOCUMENT	Passport, driver’s license, national ID
PROOF_OF_ADDRESS	Utility bill, bank statement, lease agreement
BANK_STATEMENT	Statement with period and account details
BUSINESS_DOCUMENT	Articles of incorporation, business license, EIN confirmation
TAX_INFORMATION	W-9, 1099, tax return, SSN card, ITIN letter, VAT certificate
FINANCIAL_DOCUMENT	Balance sheet, P&L statement, cash flow, audit report
BIOMETRIC_VERIFICATION	Facial recognition, fingerprint, voice, iris scan
EMPLOYMENT_INFORMATION	Employment status, employer, occupation, income

All file uploads use base64 encoding with file_name, content_type, and content fields.

Webhook events

Entity events

• baas.entity.created
• baas.entity.updated
• baas.entity.deleted

Onboarding events

• baas.onboarding.created
• baas.onboarding.updated
• baas.onboarding.pending_documentation
• baas.onboarding.succeeded
• baas.onboarding.failed
• baas.onboarding.declined
• baas.onboarding.cancelled
• baas.onboarding.expired

Account events

• baas.account.created
• baas.account.updated
• baas.account.closed

Transfer events (outgoing)

• baas.transfer.created
• baas.transfer.processing
• baas.transfer.completed
• baas.transfer.failed
• baas.transfer.cancelled

Transfer events (incoming)

• baas.transfer.received
• baas.transfer.reversed

Your webhook endpoint must return a 200 OK status with {"received": true} in the response body. Yuno retries on 5xx responses and timeouts with exponential backoff.

Next steps

Create Entity

Register an individual or business entity.

Create Onboarding

Submit KYC/KYB documentation for approval.

Create Account

Open a bank account after onboarding.

Initiate Transfer

Send funds between entities.