> ## 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.

# SDKs

> Find the Payrails SDK for each job: checkout SDKs for web, iOS, Android and React Native, the web fraud SDK, and the card tokenization and display SDKs.

Each card links to the SDK's setup guide.

## Payment Orchestration

To choose between Drop-in, Elements and Secure Fields, see [Checkout SDKs](https://docs.payrails.com/docs/orchestration/checkout-sdks.md). For classes, methods, events and options, see the API reference for the [web](https://docs.payrails.com/docs/orchestration/checkout-sdks/web/references/payrails-api-reference.md), [iOS](https://docs.payrails.com/docs/orchestration/checkout-sdks/ios/sdk-api-reference.md), [Android](https://docs.payrails.com/docs/orchestration/checkout-sdks/android/api-reference.md) and [React Native](https://docs.payrails.com/docs/orchestration/checkout-sdks/react-native/api-references.md) SDKs.

**language**

Web SDK

Install the web SDK and mount a checkout on your page.

[Open](https://docs.payrails.com/docs/orchestration/checkout-sdks/web.md)

**phone-iphone**

iOS SDK

Add the iOS SDK with Swift Package Manager and render a card payment screen.

[Open](https://docs.payrails.com/docs/orchestration/checkout-sdks/ios.md)

**android**

Android SDK

Add the Android SDK to a Jetpack Compose app and build a card payment form.

[Open](https://docs.payrails.com/docs/orchestration/checkout-sdks/android.md)

**devices**

React Native SDK

Add prebuilt payment components to a React Native app.

[Open](https://docs.payrails.com/docs/orchestration/checkout-sdks/react-native.md)

## Fraud Management

**shield-person**

Web Fraud SDK

Collect device signals for your fraud providers through one interface.

[Open](https://docs.payrails.com/docs/orchestration/checkout-sdks/payrails-web-fraud-sdk.md)

## Token Vault

Their guides are in the Guides tab, with the rest of Token Vault.

**encrypted**

Tokenize cards

Store cards in the Payrails vault with Secure Fields or client-side encryption.

[Open](https://docs.payrails.com/docs/token-vault/tokenize-payment-instruments.md)

**credit-card**

Display cards

Show tokenized card data in your frontend without it touching your servers.

[Open](https://docs.payrails.com/docs/token-vault/display-sdk.md)


## Related topics

- [Getting Started](https://docs.payrails.com/docs/orchestration/getting-started.md)
- [Getting Started](https://docs.payrails.com/docs/token-vault/getting-started.md)
- [Connections](https://docs.payrails.com/docs/connections.md)


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