{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/api-docs/getting-started/","matchPath":"","result":{"data":{"markdownRemark":{"html":"<h1 style=\"position:relative;\"><a href=\"#getting-started\" aria-label=\"getting started permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"getting-started\"></div>Getting started</h1>\n<p>Before you start the process of integrating with the Ripple Payments Direct 2.0 API, you need to address the following items:</p>\n<ul>\n<li>\n<a href=\"#github-repository\">GitHub Repository</a>\n</li>\n<li>\n<a href=\"#tooling\">Tooling</a>\n</li>\n<li>\n<a href=\"#user-creation\">User creation</a>\n</li>\n<li>\n<a href=\"#api-credentials\">API credentials</a>\n</li>\n</ul>\n<h2 style=\"position:relative;\"><a href=\"#github-repository\" aria-label=\"github repository permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"github-repository\"></div>GitHub repository</h2>\n<p>The official <a href=\"https://github.com/ripple/payments-direct\">Payments Direct 2.0 GitHub repository</a> is the single source of truth for everything you need to integrate with Payments Direct 2.0:</p>\n<ul>\n<li>\n<strong><a href=\"https://github.com/ripple/payments-direct/blob/main/openapi_spec/rpd2_spec.yml\">OpenAPI Specification:</a></strong>\n The canonical definition of the Payments Direct 2.0 API. \n</li>\n<li>\n<strong><a href=\"https://github.com/ripple/payments-direct/tree/main/sdks\">SDKs:</a></strong>\n Client libraries in multiple languages, available in the repository and through standard package managers.\n</li>\n<li>\n<strong><a href=\"https://github.com/ripple/payments-direct/tree/main/examples\">Examples:</a></strong>\n End-to-end sample code for common payment flows (create a quote, submit a payment, check status).\n</li>\n<li>\n<strong><a href=\"https://github.com/ripple/payments-direct/tags\">Releases:</a></strong>\n Tagged versions that align the spec, SDKs, and examples with specific API releases.\n</li>\n</ul>\n<p>See the repository <a href=\"https://github.com/ripple/payments-direct#readme\">README</a> for installation instructions and usage examples.</p>\n<h2 style=\"position:relative;\"><a href=\"#tooling\" aria-label=\"tooling permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"tooling\"></div>Tooling</h2>\n<p>To prepare for integrating with the Ripple Payments Direct 2.0 API:</p>\n<ul>\n<li>\nInstall \n<a href=\"https://www.postman.com/downloads/\">Postman</a>\n (as an alternative, \n<a href=\"https://curl.se\">curl</a>\n examples are provided in documentation).\n</li>\n<li>\nUse Postman to generate a collection from the Payments Direct 2.0 API specification. For guidance on how to do this, see \n<a href=\"https://learning.postman.com/docs/design-apis/specifications/generate-collections/\">Generate collections from you API specification</a>\n.\n</li>\n<li>\nSet up a password manager for API keys.\n</li>\n<li>\nConfirm with your Ripple liaison that your test instance is ready.\n</li>\n</ul>\n<h2 style=\"position:relative;\"><a href=\"#user-creation\" aria-label=\"user creation permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"user-creation\"></div>User creation</h2>\n<p>To set up accounts for developers, your organization administrator must:</p>\n<ol>\n<li>\nAccess the \n<a href=\"https://home.ripple.com/\">Ripple Payments UI</a>\n.\n</li>\n<li>\nNavigate to \n<strong>Settings</strong>\n and then select \n<strong>Users</strong>\n.\n</li>\n<li>\nSelect \n<strong>New User</strong>\n.\n</li>\n<li>\nCheck \n<strong>Can Read</strong>\n API Credentials permission.\n</li>\n<li>\nCheck \n<strong>Can Edit</strong>\n API Credentials permission.\n</li>\n<li>\nSave the user and repeat the process for each developer on the team.\n</li>\n</ol>\n<h2 style=\"position:relative;\"><a href=\"#api-credentials\" aria-label=\"api credentials permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"api-credentials\"></div>API credentials</h2>\n<p>To set up API credentials, each developer must:</p>\n<ol>\n<li>\nAccess the \n<a href=\"https://home.ripple.com/\">Ripple Payments UI</a>\n, click \n<strong>Settings</strong>\n, and then click \n<strong>API Credentials</strong>\n in the Integration section.\n</li>\n<li>\nClick \n<strong>New Credential</strong>\n.\n</li>\n<li>\nEnter a name for your new credential.\n</li>\n<li>\nClick \n<strong>Save &#x26; Generate Key</strong>\n.\n</li>\n<li>\nCopy the credential and store it in a secure location to use for API calls.\n</li>\n<li>\nTo finish credential creation, click \n<strong>Close</strong>\n.\n</li>\n</ol>","headings":[{"value":"Getting started","depth":1},{"value":"GitHub repository","depth":2},{"value":"Tooling","depth":2},{"value":"User creation","depth":2},{"value":"API credentials","depth":2}]},"contentItem":{"data":{"lastModified":"2025-11-13T00:24:58.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":true,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"b4c4b464-d12c-590e-8b87-8d48fad4c6be__redocly content/api-docs/getting-started/","seo":{"title":"Getting started","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api-docs/getting-started.md","pageBaseUrl":"/api-docs/getting-started","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Getting started","id":"getting-started"},{"depth":2,"value":"GitHub repository","id":"github-repository"},{"depth":2,"value":"Tooling","id":"tooling"},{"depth":2,"value":"User creation","id":"user-creation"},{"depth":2,"value":"API credentials","id":"api-credentials"}]},"data":{"title":""},"catalogInfo":null,"link":"/api-docs/getting-started/","sidebarName":"__root-sidebar__-data-69308394-sidebars.yaml","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}