{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/payments-odl/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"API credentials","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com/products/custody","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"api-credentials","__idx":0},"children":["API credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripple Payments"," API calls require Bearer authentication tokens that you retrieve from the authentication operation using API credentials. This topic explains how to create and rotate an API credential."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/api-credentials.2426e30a7675154c70e0c710e572d682418127810cb5f5a6ed6c1d668cf93efb.6ae46ae6.png","alt":"API Credentials page"},"children":[]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each environment can have up to three credentials."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your user needs to have permissions to view and edit API credentials.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," To check your ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["API Credentials"]}," permissions, select ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/user-profile-icon.d857744aea8986c76415ec263b247105919106554fa9482e2b40dfba5d69d4c7.6ae46ae6.png","alt":"User profile icon"},"children":[]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Profile"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-new-credential","__idx":2},"children":["Create new credential"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["To create an API credential"]}," consisting of a client ID and client secret (credential):"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Log in to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://home.ripple.com"},"children":["Ripple Payments"]}," as described in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/payments-odl/user-interface/login"},"children":["Login"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the top right of the page, click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," gear icon."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integration"]},", select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Credentials"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the top right of the page, next to the ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/question-mark-icon.d62b51381c1ca5824ce7a576e8b6aa93ee0869616e9241a7fd634aed2342834f.00aefa6e.png","alt":"Question mark icon"},"children":[]}," icon, select the access environment for which you want to create API credentials. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"For example, to provision credentials for the UAT environment, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["UAT"]}," from the dropdown list."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New Credential"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Credential name"]}," field, enter a name for the credential."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/api-credential-new.850bf554c317d7f38de21886af46c0da7d49beaf30f38c49f27ae6ea0bce4f37.6ae46ae6.png","alt":"API credential dialog box"},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save & Generate Key"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ","Ripple Payments UI"," presents a dialog box with the client ID and audience that you’ll use with the credential, together with the credential itself."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Security"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The credential is displayed only once and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["you won’t be able to view it again after exiting the page"]},". Copy and store the client secret (credential) securely and share it with authorized individuals in accordance with your organization's security policy."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/api-credential-details.b3f4b27b5f445d35ea6aedaeba249f9508181b2138ba9ecc96c30aa2e9be27f4.6ae46ae6.png","alt":"API credential details"},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To finish credential creation, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Close."]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can now use the client ID and client secret to generate access tokens using the authentication operation. For more information, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/payments-odl/api-docs/ripplenet/best-practices/authentication#fetch-an-access-token"},"children":["Authentication"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend rotating your API credentials at regular intervals in accordance with your organization's security policy."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rotate-credential","__idx":3},"children":["Rotate credential"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Rotating credentials is the process of changing your password and replacing your cryptographic key for accessing RippleNet."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["To rotate your RippleNet credential:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rotate Credential"]}," from the dropdown menu in the credential card and confirm your choice."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/api-credential-rotate.896dc176025e481ecb9b21631b8206fe42ed00418d89bf66fd620e4dfd7b1983.6ae46ae6.png","alt":"API credential details"},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rotate Credential"]}," button to confirm."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/api-credential-rotate-dialog.e732a21891920b11e811e93245acbbfe2c5177c25ae7bb687b4a134601faf3c6.6ae46ae6.png","alt":"API credential details"},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Once again, copy the credential and store it in a secure location because you won’t be able to view it later."]}]}]},"headings":[{"value":"API credentials","id":"api-credentials","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Create new credential","id":"create-new-credential","depth":2},{"value":"Rotate credential","id":"rotate-credential","depth":2}],"frontmatter":{"seo":{"title":"API credentials"}},"lastModified":"2026-02-25T03:20:04.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/payments-odl/user-interface/settings/api-credentials","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}