> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.runpayments.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.runpayments.io/_mcp/server.

# Setup

## Request Development Account

Send an email to [integrations@runpayments.io](mailto:integrations@runpayments.io?subject=Run%20Developer%20Account%20Request\&body=Hello%2C%0D%0A%0D%0AI%20would%20like%20to%20request%20a%20Run%20Developer%20Account%3A%0D%0A%0D%0A-%20Name%3A%20%0D%0A-%20Email%3A%20%0D%0A-%20Company%3A%20) including your name, email, and company. You will be assigned an Integration Delivery lead who will set you up with the following:

* **UAT Merchant ID**
* **Payment API Credentials** including an `api_key`, `refresh_token`, and `public_key` delivered via a secure link.
* **Run Merchant User Account** for viewing transactions during development and testing.

## Generate API credentials

Once you have logged into your Run Merchant account, you can also use the Settings page to generate Payments and Reporting API credentials on your own.

> **Warning**
>
> Generating new *Reporting API* credentials will invalidate any existing *Reporting API* credentials you have and issue a new client id and secret.

## Postman Collection

The Postman Collection for the Payments and Reporting APIs can be found at the link below:

* [**Fork or import collection from Postman**](https://app.getpostman.com/run-collection/34147350-fd69d8c8-4179-4b2a-90d7-3ef37721f854?action=collection%2Ffork\&source=rip_markdown\&collection-url=entityId%3D34147350-fd69d8c8-4179-4b2a-90d7-3ef37721f854%26entityType%3Dcollection%26workspaceId%3D3a98b43c-5c4e-41ac-8d33-c53586f10e7d#?env%5BStaging%5D=W3sia2V5IjoicGF5X3VybCIsInZhbHVlIjoiaHR0cHM6Ly9zdGFnaW5nLWphdmVsaW4ucnVucGF5bWVudHMuaW8iLCJlbmFibGVkIjp0cnVlLCJ0eXBlIjoiZGVmYXVsdCIsInNlc3Npb25WYWx1ZSI6Imh0dHBzOi8vc3RhZ2luZy1qYXZlbGluLnJ1bnBheW1lbnRzLmlvIiwic2Vzc2lvbkluZGV4IjowfSx7ImtleSI6Im1pZCIsInZhbHVlIjoiIiwiZW5hYmxlZCI6dHJ1ZSwidHlwZSI6ImRlZmF1bHQiLCJzZXNzaW9uVmFsdWUiOiIiLCJzZXNzaW9uSW5kZXgiOjF9LHsia2V5IjoicGF5X3Rva2VuIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlLCJ0eXBlIjoic2VjcmV0Iiwic2Vzc2lvblZhbHVlIjoiIiwic2Vzc2lvbkluZGV4IjoyfSx7ImtleSI6InJlcG9ydGluZ191cmwiLCJ2YWx1ZSI6Imh0dHBzOi8vYXBwcy5ydW5wYXltZW50cy5pby9vcmRzL3NwcmludCIsImVuYWJsZWQiOnRydWUsInR5cGUiOiJkZWZhdWx0Iiwic2Vzc2lvblZhbHVlIjoiaHR0cHM6Ly9hcHBzLnJ1bnBheW1lbnRzLmlvL29yZHMvc3ByaW50Iiwic2Vzc2lvbkluZGV4IjozfSx7ImtleSI6InJlcG9ydGluZ19jbGllbnRfaWQiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWUsInR5cGUiOiJkZWZhdWx0Iiwic2Vzc2lvblZhbHVlIjoiIiwic2Vzc2lvbkluZGV4Ijo0fSx7ImtleSI6InJlcG9ydGluZ19zZWNyZXQiLCJ2YWx1ZSI6IiIsImVuYWJsZWQiOnRydWUsInR5cGUiOiJzZWNyZXQiLCJzZXNzaW9uVmFsdWUiOiIiLCJzZXNzaW9uSW5kZXgiOjV9XQ==)

Once you have forked or imported the collection, navigate to the *Environments* tab to enter your API key and ensure you have the correct environment variables set:

| **Variable**        | **Type** | **Initial Value**                                                                  |
| ------------------- | -------- | ---------------------------------------------------------------------------------- |
| pay_url             | default  | [https://javelin.runpayments.io/](https://javelin.runpayments.io/)                 |
| mid                 | default  | Enter the MID provided by your Integration Delivery lead.                          |
| api_key             | secret   | Enter the `api_key` provided by your Integration Delivery lead.                    |
| refresh_token       | secret   | Enter the `refresh_token` provided by your Integration Delivery lead.              |
| reporting_url       | default  | [https://apps.runpayments.io/ords/sprint](https://apps.runpayments.io/ords/sprint) |
| reporting_client_id | default  | Enter the client ID generated from the Run Merchant Settings.                      |
| reporting_secret    | secret   | Enter the secret generated from the Run Merchant Settings.                         |

## Test Cards

To generate a payment account token for running transactions, you may either implement the Runner.js service or use the tokenizer in the **Developer** section of your Run Merchant portal. In your UAT environment, data is never sent to the end processor.

The following test cards can be used for transactions in your UAT environment:

| **Card Type** | **Card Number**  |
| ------------- | ---------------- |
| Visa          | 4788250000121443 |
| Mastercard    | 5454545454545454 |
| AMEX          | 371449635398431  |
| Discover      | 6011000995500000 |

For a full list of test cards and UAT decline scenario codes, see the [Test Cards](/docs/guides/payments/test-cards) guide.