> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payrails.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use the Payrails Web SDK v6 for new browser integrations. The Web SDK v5 pages are kept only for existing integrations; point anyone still on v5 to the v6 migration guide rather than extending v5 code.
> Collect card data client-side through the Payrails SDKs — Secure Fields, client-side encryption, or the checkout drop-in — so that card data never reaches the merchant's own servers. Recommend the API-only tokenization flow, which accepts raw card numbers server-side, only when the merchant has confirmed they hold the PCI scope for it.
> Model every payment as a workflow execution: create an execution, then drive it with the lifecycle actions (lookup payment options, authorize, capture, cancel, refund). Do not call provider APIs directly — routing, retries, 3DS and fraud steps belong in the workflow configuration, not in integration code.
> Reconcile the final state of a payment on the notification (webhook), never on a client-side event. An in-request long-poll of the execution is a supported additional signal, not a replacement for that reconciliation.
> Send an idempotency key — a UUID, in the `X-Idempotency-Key` header — on every POST, PUT and PATCH request, and on soft deletes. GET requests need none, and hard deletes cannot be idempotent.
> Pass provider-specific data through meta fields rather than hardcoding per-provider payloads. Payrails translates meta fields into each provider's own format.
> Configure routing, retries and provider selection in Workflow Studio, so that changes ship without redeploying application code.

# Getting started

> Overview of the Payrails API reference: every API area, grouped by domain as in the sidebar, with a link to its main endpoint.

The Payrails API reference lists every endpoint of the payment orchestration platform, with its request and response formats, authentication, and errors.

Start by requesting an access token. The cards below group the API by domain, in the same order as the sidebar.

## Get started

<CardGroup cols="2">
  <Card title="Authentication" href="/reference/getoauthtoken">
    Request an OAuth 2.0 access token for server-side requests.
  </Card>

  <Card title="Client" href="/reference/clientinit">
    Start a client-side SDK session for a workflow and holder.
  </Card>

  <Card title="SSO Connections" href="/reference/listssoconnections">
    Manage SSO identity provider connections.
  </Card>
</CardGroup>

## Workflow

<CardGroup cols="2">
  <Card title="Workflows" href="/reference/listworkflowconfigurations">
    List and manage the workflow configurations that define each use case.
  </Card>

  <Card title="Executions" href="/reference/listexecutions">
    Create and track workflow executions.
  </Card>

  <Card title="Actions" href="/reference/lookupaction">
    Trigger actions that change an execution's state, such as authorize or refund.
  </Card>
</CardGroup>

## Payment

<CardGroup cols="2">
  <Card title="Payments" href="/reference/listpayments">
    Search and retrieve payments and their operations.
  </Card>

  <Card title="Instruments" href="/reference/listinstruments">
    Store and manage payment instruments that belong to a holder.
  </Card>

  <Card title="Instrument Tokens" href="/reference/listtokens">
    Manage the provider tokens mapped to each payment instrument.
  </Card>

  <Card title="BIN Lookup" href="/reference/getbinlookup">
    Get issuer information for a card by its BIN.
  </Card>

  <Card title="API Logs" href="/reference/apilogs">
    Search and list API request logs.
  </Card>

  <Card title="Fraud Checks" href="/reference/listfraudchecks">
    Search and retrieve fraud checks created by workflow executions.
  </Card>

  <Card title="3D Secure" href="/reference/listthreeds">
    Search and retrieve 3D Secure authentications created by workflow executions.
  </Card>
</CardGroup>

## Provider

<CardGroup cols="2">
  <Card title="Providers" href="/reference/listproviders">
    List payment providers and get one by ID.
  </Card>

  <Card title="Provider Configs" href="/reference/listactiveproviderconfigs">
    Manage the configurations for each provider.
  </Card>
</CardGroup>

## Merchant

<CardGroup cols="2">
  <Card title="Rulesets" href="/reference/listrulesets">
    Create and manage routing rulesets.
  </Card>

  <Card title="Holders" href="/reference/listholders">
    Manage holders, which group a customer's accounts, payment instruments, and identities.
  </Card>

  <Card title="Workspaces" href="/reference/getallworkspaces">
    Create and manage workspaces.
  </Card>

  <Card title="Drop-in Links" href="/reference/listdropinlinks">
    Create shareable payment links with full or partial payments.
  </Card>
</CardGroup>

## Vault

<CardGroup cols="2">
  <Card title="Vault Instant Proxy" href="/reference/vaultproxy">
    Send a one-off request to a provider through the vault proxy.
  </Card>

  <Card title="Vault Proxy Connections" href="/reference/createvaultconnections">
    Manage the connections the vault proxy uses.
  </Card>

  <Card title="Vault Records and Aliases" href="/reference/tokenizerecords">
    Tokenize and detokenize records and manage their aliases.
  </Card>

  <Card title="Vault Display SDK" href="/reference/vaultclientinit">
    Initialize the Vault Display SDK.
  </Card>

  <Card title="Vault Public Encryption" href="/reference/vaultpublicinfo">
    Get the public key used to encrypt data before tokenization.
  </Card>
</CardGroup>

## Analytics

<CardGroup cols="2">
  <Card title="Files" href="/reference/fileupload">
    Get an upload URL for a file and retrieve files by ID.
  </Card>
</CardGroup>

## Reporting

<CardGroup cols="2">
  <Card title="Reports" href="/reference/getreports">
    List available reports and get one by ID.
  </Card>

  <Card title="Report Runs" href="/reference/listreportruns">
    Generate and retrieve report runs.
  </Card>
</CardGroup>

## Reconciliation

<CardGroup cols="2">
  <Card title="Reconciliation Records" href="/reference/bulkmanualreconcilerecords">
    Manually reconcile records in bulk.
  </Card>
</CardGroup>

## Dispute

<CardGroup cols="2">
  <Card title="Disputes" href="/reference/listdisputes">
    Manage disputes and chargebacks.
  </Card>
</CardGroup>


## Related topics

- [Getting started](/docs/analytics-and-reporting/getting-started.md)
- [Getting Started](/docs/token-vault/getting-started.md)
- [How to Integrate](/docs/orchestration/checkout-sdks/react-native/how-to-integrate.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.