Help Center/Admin Operations/Store or rotate a gateway credential in the vault
Admin Operations•Last updated: 2026-10-20•4 min read

Store or rotate a gateway credential in the vault

The credential vault on each gateway card stores secrets (API key, secret, webhook secret and so on) encrypted. "Rotate" replaces the value for one purpose.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Open the vault area

On "Payments Console" go to the gateway card; the line "Credential vault" lists what is stored (for example "stored: api_key") or "nothing stored".

2

Choose the purpose

Open the first selector ("purpose…") and pick one of api_key, secret, hmac_secret, rpc_url, webhook_secret, provider_key or private_key.

3

Enter the value

Type the new secret in the password box "new secret value".

4

Click "Rotate"

The banner reads "<purpose> stored encrypted for <code> (<masked value>)." and the box is cleared.

5

Verify

Click "Test" on the same card to confirm the gateway still works with the new value.

Expected Operational Outcome

The credential for that purpose is stored encrypted and replaces the earlier value; only a masked version is shown back.

Troubleshooting & Failure Modes

Symptom: "Choose a purpose and enter a value first."
Likely Cause: The purpose selector or the value box is empty.
Resolution: Select a purpose and type the secret before clicking "Rotate".

Was this guide helpful?

Help us refine our platform documentation