Create a test project
Open RAINA Cloud and create a project. Test projects are free and separate from production.
RAINAOpen CloudRAINA DEVELOPERSBuild with RAINA.
Build with RAINA.
Start in test mode.
Connect your own product to RAINA account data, payments and signed events. Create a test project first, then request production access when your integration is ready.
QUICKSTARTFour steps from idea
Four steps from idea
to a working connection.
Create a scoped key
Choose only the access your app needs. The full key is shown once.
Call the account API
Use your key as a Bearer token to read the account snapshot available to that project.
Add a webhook
Production projects can receive signed payment updates at an HTTPS endpoint.
AUTHENTICATION
Use a project key.
Send the key in the Authorization header. Keep production keys on your server, never inside public browser code.
Authorization: Bearer rnk_...
KEY CONTROL
Give each key one job.
Available scopes include account reads, payment reads, order reads, support reads and webhook management. Revoke a key at any time from Cloud.
ENVIRONMENTSTest safely.
Test safely.
Go live deliberately.
Build before you pay
Create projects and keys, connect your app and check responses without production access.
Free test workspaceLive access is reviewed
A paid Cloud plan and production approval are required before a project can issue live credentials and receive live payment webhooks.
Separate activationWEBHOOKS
Receive payment updates.
Production projects can register an HTTPS endpoint for payment.status_changed. RAINA returns a signing secret once when you create the webhook.
SECURITY
Keys are not wallets.
Cloud keys do not expose a seed phrase or private key. Money-moving actions remain behind the product and wallet rules that apply to that action.
CURRENT APIStart with what is
Start with what is
actually available.
/api/cloud/v1/accountReturns the account snapshot allowed by the project key.
payment.status_changedSigned payment status updates for approved production webhooks.
read · payments:read · orders:readScope every credential to the smallest access your app needs.
/api/raina/names/resolve?name=name.rainaResolve active .raina payment records without a Cloud key. Names docs →
/sdk/raina-names.jsBrowser-ready public resolver helpers for wallets, dApps and checkout integrations.
/.well-known/raina-names.jsonMachine-readable resolver, SDK and supported-network metadata.
RAINA CLOUD + DEVELOPERS