Register Your Public Key

Once your onboarding is approved, you can register your public key through the RynoPay Partner Portal.

Steps

1. Log in to the Partner Portal (Sandbox | Production).
2. Navigate to the API Keys section.
3. Click Create API Key.
4. Fill in the following:

Field	Description
Label	A descriptive name for this key (e.g., "Production", "Staging")
Public Key	Paste the full PEM content of your public-key.pem file
Expiry Date	(Optional) When this key should expire

5. Click Save.

After registration, the portal will display your API Key ID (UUID).

Save your API Key ID

You will need this ID as the kid (Key ID) value in your JWT header. It tells RynoPay which public key to use when verifying your assertion.

Managing multiple keys

You can create multiple API keys for different environments or purposes:

• Production -- your live integration key
• Staging -- for testing against the RynoPay sandbox
• Rotation -- register a new key before retiring the old one

Each key has its own API Key ID and can be independently expired or deleted.

Key rotation

To rotate your keys safely:

1. Generate a new ECDSA key pair.
2. Register the new public key in the Partner Portal (you will get a new API Key ID).
3. Update your application to use the new private key and API Key ID.
4. Verify the new key works by making a test token exchange.
5. Delete the old key from the Partner Portal.

warning

Do not delete the old key until your application has fully migrated to the new one.