🏅FAPI 1.0 Advanced ConformantKSA FAPI Profile · View results →

FAPI 1.0 Advanced
developer sandbox.

A testing ground for KSA fintech developers and license applicants. Build, test, and validate your FAPI 1.0 security stack — mTLS, JWT keys, and JWKS — before going live.

No credit card required · Free tier includes 3 certs + 2 keys.

KSA FAPI Profile

FAPI 1.0 in Saudi Arabia

FAPI 1.0 Advanced is the security profile mandated by SAMA for account information, payment initiation, and confirmation of funds APIs. This sandbox lets you build and validate your implementation before connecting to a live environment.

🏦

Account Information Services

AIS — Live Now

TPPs can access account balances, transaction history, and statements with customer consent. Currently live under the KSA open finance framework.

💸

Payment Initiation Services

PIS — Coming Soon

TPPs will be able to initiate payments directly from customer accounts, bypassing card networks for faster settlements.

Confirmation of Funds

CAF — Planned

Real-time confirmation that a customer has sufficient funds for a transaction — critical for e-commerce and lending.

FAPI 1.0 Advanced · KSA Profile

Security Requirements

The KSA FAPI profile mandates strong client authentication, signed request objects, and mTLS for every API call. WRVault covers the full stack — PKI infrastructure and a conformant OIDC authorization server.

mTLS Client Authentication

Supported

Every API call between a TPP and the bank must be authenticated with a mutual TLS certificate. WRVault generates and manages these for you.

JWT Signing Keys & JWKS

Supported

Request objects must be signed with RSA or ECDSA keys. WRVault hosts your public JWKS endpoint automatically.

Hybrid Flow — code id_token

Conformant

FAPI 1.0 Advanced requires response_type=code id_token (hybrid flow). The auth server returns a detached ID token with c_hash, s_hash, and nonce alongside the authorization code.

PAR + PKCE S256

Conformant

Authorization requests must be pushed (PAR) before the browser redirect. PKCE S256 is mandatory — plain method is rejected.

🏅
OpenID Foundation · Conformance Suite

FAPI 1.0 Advanced Conformant

Our authorization server passes all OpenID Foundation conformance tests for the FAPI 1.0 Advanced profile under the KSA plain response configuration. Certification pending fee payment.

mTLS sender-constrained tokens · Pushed Authorization Requests (PAR) · PKCE S256 · Hybrid flow (code + id_token)

View Conformance Results →

Plan ID: cQpf0JfvNRzoE · certification.openid.net

Fintech Onboarding

Get started in 6 steps

From zero to a working FAPI 1.0 Advanced flow in your sandbox. Follow these steps before submitting your open finance license application.

01

Create a WRVault account

Sign up at wrvault.com — free tier included. No credit card required.

Sign up →
02

Generate your mTLS certificate

From your WRVault dashboard, issue an X.509 mTLS certificate. Note the Subject DN (e.g. CN=my-app,O=MyFintech,C=SA) — you will pass it as tls_client_auth_subject_dn in DCR. Alternatively, omit it to use TOFU: your cert is pinned automatically on your first authenticated call.

03

Create a JWT signing key pair

Generate an RSA or ECDSA key pair in WRVault. Your public JWKS endpoint is hosted automatically — copy its URL for the jwks_uri field in DCR.

04

Register your TPP via DCR

POST to /connect/register with your client_name, redirect_uris, jwks_uri, tls_client_auth_subject_dn (from step 2), and contact_email. Leave profile as OB_KSA (default) for the FAPI 1.0 flow.

See DCR endpoint →
05

Wait for approval email

Your registration starts as PENDING. Once an admin approves it, you receive an email at the contact_email you provided. Your client_id is then active.

06

Test the full OIDC flow

Push an authorization request (PAR) with response_type=code id_token, complete the PSU consent flow, exchange the code for an access token using PKCE code_verifier, and call the AIS endpoints.

View API reference →
Sandbox Only

Test PSU Accounts

Use these credentials at the authorize step — when the browser redirects to auth.wrvault.com/login. Each user has pre-seeded accounts, balances, and transactions.

James Harrison

GB-TEST-001

2 accounts

Usernamejames.harrison
PasswordTest@1234
Current Account12,450.75 SAR
SA0380000000608010167519
Savings Account45,000.00 SAR
SA4420000001234567891234

Emily Carter

GB-TEST-002

1 account

Usernameemily.carter
PasswordTest@1234
Current Account8,320.50 SAR
SA5560000000123456780123

Michael Brooks

GB-TEST-003

2 accounts

Usernamemichael.brooks
PasswordTest@1234
Current Account31,100.00 SAR
SA7890000000987654321098
Savings Account120,500.00 SAR
SA2310000002468013579135

These are synthetic test accounts. Passwords and data are reset on each deployment. Do not use real personal data in the sandbox.

API Reference

Endpoints

Base URL: https://auth.wrvault.com

Showing KSA · FAPI 1.0 Advanced — endpoints marked FAPI 2.0 differ from the KSA profile.

mTLS endpoints — pass your certificate and key via --cert client.crt --key client.key in curl, or configure Postman Settings → Certificates for auth.wrvault.com.

Developer Sandbox

Test before you go live

WRVault gives KSA fintech developers a ready-made environment to build and validate their FAPI 1.0 security stack before submitting a license application.

🔐

Generate Test mTLS Certificates

Issue X.509 certificates for your sandbox TPP identity. Test mutual TLS handshakes against FAPI 1.0 endpoints before going live.

🔑

JWT Signing & Verification

Create RSA/ECDSA key pairs, sign request objects, and verify JWT assertions — exactly as required by the KSA FAPI profile.

🌐

JWKS Endpoint

Each organization gets a hosted public JWKS URL. Register it during your license application to prove key management compliance.

♻️

Key Rotation

Rotate signing keys on a schedule without downtime. Your JWKS endpoint updates instantly — no re-registration required.

⚙️

API Access

Pull certificates and keys programmatically via REST API or GitHub Actions. Automate your FAPI 1.0 sandbox testing pipeline.

🔔

Expiry Alerts

Get notified before sandbox or production certificates expire. Never fail a compliance check due to an expired cert.

Roadmap

We're building the complete FAPI 1.0 security stack in phases — aligned with the rollout of KSA open finance AIS, PIS, and CAF services.

Phase 1Live Now

PKI Infrastructure

AIS Ready

  • mTLS certificate generation & renewal
  • JWT signing key management
  • Hosted JWKS endpoint per organization
  • Key rotation with expiry alerts
  • REST API + GitHub Actions integration
Phase 2Live Now

Authorization Server

FAPI 1.0 Advanced

  • FAPI 1.0 Advanced conformant OIDC server
  • Pushed Authorization Requests (PAR)
  • PKCE S256 enforcement
  • Sender-constrained tokens (mTLS)
  • Consent management & revocation
Phase 3Planned

TPP Onboarding Portal

Full Stack

  • Self-service TPP sandbox registration
  • License application support
  • AIS & PIS API simulation
  • Consent dashboard & audit trail
  • Compliance reporting

Ready to start testing?

Sign up for free and start building your FAPI security stack today — KSA FAPI 1.0 or Canada FDX FAPI 2.0. No credit card, no commitment.

No credit card required · Free tier forever

WRVault

Independent developer sandbox. Not affiliated with or endorsed by SAMA, FDX, the Bank of Canada, or any official open finance body.

© 2026 WRVault. All rights reserved.