Register your certificate
You register the certificate once, in the Partner Portal. Ryno creates a machine client for your organisation and shows you its client ID.
Your partner account must be approved, and an operating model assigned, before you can register. If the page reports that your account is not eligible, contact support.
Open API Credentials
Sign in to the Partner Portal and choose API Credentials in the sidebar.
| Environment | Partner Portal |
|---|---|
| Sandbox | https://partners.sandbox.rynopay.io |
| Production | https://partner.rynopay.io |
Paste your certificate
Paste the full contents of ryno-partner.crt, including the BEGIN CERTIFICATE and END CERTIFICATE lines, then choose Register certificate.
Wait for Active
Ryno provisions the client in the background. The page refreshes the status until it reads Active.
Copy your client ID
Copy the Client ID shown under Current credential. You need it for every token request.
Your client ID
Ryno generates the client ID. You cannot choose it.
It is your business name in lower case with hyphens, shortened to 30 characters, followed by your partner ID without dashes. For example, acme-ltd-d82dc280d10340eca66ad11bc2c3295e. It never changes, even if your business name does.
Credential statuses
| Status in the portal | Meaning |
|---|---|
| Queued for provisioning | Certificate accepted, waiting to be provisioned. |
| Provisioning | Being set up now. |
| Provisioned, not yet active | Set up, waiting to be switched on. |
| Active | Ready. You can request tokens. |
| Provisioning failed | Setup did not complete. Contact support. |
| Suspension requested, Suspending, Suspended | Ryno has suspended API access. Token requests fail. |
| Suspension failed | Contact support. |
You can only request tokens while the status is Active.
Registration rules
- One credential per partner. Each partner account has one machine client and one certificate.
- Registering the same certificate again is safe. It returns the existing credential.
- A different certificate is rejected. Replacing a certificate goes through support. See Certificate rotation.
- Your entitlement profile is assigned by Ryno. Self-registered clients get
STANDARD. See Scopes.
If registration fails
| Message | Fix |
|---|---|
| The certificate is invalid | Check it against the requirements. EC keys, CA certificates and missing key usage are the usual causes. |
| The certificate expires too soon | Issue one with more than 30 days of validity left. |
| A different registration already exists | A certificate is already registered. Contact support to rotate it. |
| Not eligible | Your partner onboarding is not approved yet, or has no operating model. Contact support. |