Skip to main content
The Nuvera REST API provides partner organizations with server-to-server access to customers, beneficiaries, documents, payment reference data, payments, screening reads, and support workflows. Only partner organizations can use the REST API layer. Customer-platform users do not receive API applications or API keys. Nuvera admins can manage partner API applications only for support, emergency disablement, permission correction, and partner-assisted key rotation.

Base URL

https://api.nuvera.global

Authentication

Every REST request must include both headers:
x-api-key: <your-api-key>
Authorization: Bearer <signed-request-jwt>
The API key identifies the API application. The signed JWT proves possession of the partner-held RSA private key and binds the request method, exact path and query string, short expiration, replay nonce, and request body hash. Endpoint security schemes are generated from the Nest REST decorators when the API dev server starts. Do not hand-edit docs/api-reference/openapi.json; use the guide pages for human signing and rotation instructions, and use the generated endpoint pages for request and response schemas.

Create API Application

Set up the application, public signing key, permissions, and first one-time API key.

Request Signing

Build the RS256 JWT required for each REST API call.

Key Rotation

Replace API keys and signing keys without exposing old secrets.

Resources

Customers

Create and manage business customers with KYB verification.

Beneficiaries

Add payment recipients with bank account details.

Payments

Initiate and track cross-border payments.

Documents

Upload and manage compliance documents.