# Preczn Documentation

> Build on Preczn, the fintech operating system for vertical SaaS. Migrate merchants and stored cards, board merchants to many processors, and route payments.

## Guides: Introduction
- [Preczn overview](https://docs.preczn.com/docs/welcome.md): See what Preczn does for vertical SaaS platforms: migrate merchants, onboard them to providers, route payments, and track compliance.
- [Quick Start Guide](https://docs.preczn.com/docs/getting-started.md): Follow these steps to board your Merchants and begin processing payments.
- [Glossary](https://docs.preczn.com/docs/glossary.md): Every term and concept used across this documentation, and where to read more
- [Use Preczn Docs with AI Tools](https://docs.preczn.com/docs/ai-tools.md): Give AI coding assistants and agents the Preczn guides and API reference through llms.txt, Markdown pages, and the Preczn MCP server.

## Guides: Use Cases
- [Migrate from Another Processor](https://docs.preczn.com/docs/migrate-from-another-processor.md): Move merchants, stored cards and bank accounts, and transaction history into Preczn, then switch processors. Customers skip re-entry when your provider exports the tokens.
- [Board to Multiple Providers](https://docs.preczn.com/docs/board-to-multiple-providers.md): Collect a merchant's business, ownership, and banking data once in a hosted boarding form, then board the merchant to every provider on the form.
- [Route Payments Across Providers](https://docs.preczn.com/docs/route-payments-across-providers.md): Process each merchant's payments through more than one processor, and choose per transaction with Preczn routing rules or your own routing logic.
- [Make Payment Methods Portable](https://docs.preczn.com/docs/portable-payment-methods.md): Keep saved cards and bank accounts in the Preczn token vault, apart from any processor, and charge them through any of the merchant's connections that accept transactions.
- [Manage Merchant SAQs](https://docs.preczn.com/docs/manage-merchant-saqs.md): Platforms that keep a current PCI DSS Self-Assessment Questionnaire on file for each merchant can create, sign, store, track, and send SAQs through Preczn.

## Guides: Connections
- [Connections Overview](https://docs.preczn.com/docs/connections.md): Compare the direct, platform, lending, issuing, and service processor types that a Preczn connection can link your platform to.
- [Connection Configuration](https://docs.preczn.com/docs/connection-configuration.md): Add a connection to your platform in the Preczn Dashboard, attach it to existing merchants, and remove, reset, or change its status.
- [Supported Connections](https://docs.preczn.com/docs/supported-connections.md): Find every connection Preczn supports for payments, lending, issuing, merchant boarding and import, and token migration, with setup guide links.
  - [Adyen](https://docs.preczn.com/docs/adyen.md): Link a merchant's Adyen account, including its Live URL Prefix, to process card and ACH transactions through Preczn.
  - [Adyen for Platforms](https://docs.preczn.com/docs/adyen-for-platforms.md): Configure an Adyen for Platforms connection to board merchants and process their card and ACH transactions through Preczn.
    - [Adyen for Platforms - Merchant Onboarding](https://docs.preczn.com/docs/adyen-for-platforms-onboarding.md): Configure your Adyen for Platforms connection for boarding merchants through Preczn.
  - [Authorize.Net](https://docs.preczn.com/docs/authorizenet.md): Connect your Authorize.Net merchant account to process credit card and ACH transactions through Preczn.
  - [Affinipay](https://docs.preczn.com/docs/affinipay.md): Link a merchant's existing Affinipay account with its account ID and API secret key to process credit card transactions through Preczn.
  - [Braintree](https://docs.preczn.com/docs/braintree.md): Link a merchant's Braintree account to process credit card and ACH transactions and send dynamic descriptors through Preczn.
    - [Braintree ACH Integration](https://docs.preczn.com/docs/braintree-ach.md): Process ACH (bank account) transactions through Preczn with Braintree as your processor
  - [CardPointe](https://docs.preczn.com/docs/cardpointe.md): Connect your CardPointe merchant account to process credit card, ACH, and digital wallet transactions through Preczn.
  - [Checkout.com](https://docs.preczn.com/docs/checkoutcom.md): Link a merchant's existing Checkout.com account to process credit card transactions through Preczn.
  - [Finix](https://docs.preczn.com/docs/finix.md): Connect your merchants' Finix accounts to process card and ACH transactions through Preczn.
  - [Frame](https://docs.preczn.com/docs/frame.md): Connect your platform's Frame account to process credit card and ACH transactions through Preczn.
  - [Greensky](https://docs.preczn.com/docs/greensky.md): Board merchants to Greensky or add an existing Greensky merchant ID, then create loan tokens and run drawdowns, voids, and refunds on Greensky loans.
    - [Greensky - Merchant Onboarding](https://docs.preczn.com/docs/greensky-onboarding.md): Configure a Greensky connection and board merchants for B2B2C consumer lending.
  - [Jack Henry](https://docs.preczn.com/docs/jack-henry.md): Board merchants to Jack Henry for ACH processing, supply per-location ACH limits, and track application status.
  - [Jaris](https://docs.preczn.com/docs/jaris.md): Send anonymized merchant and transaction data to Jaris to check B2B loan eligibility, then show offers and track loans with the Jaris component.
  - [MerchantE](https://docs.preczn.com/docs/merchante.md): Connect your merchant's MerchantE account to process credit card transactions through Preczn.
  - [Nelnet](https://docs.preczn.com/docs/nelnet.md): Configure a Nelnet connection, link each merchant, and track and draw down B2B2C home improvement loans through Preczn.
  - [Nuvei](https://docs.preczn.com/docs/nuvei.md): Re-tokenize stored payment credentials into a merchant's Nuvei account during a processor migration.
  - [Payflow Pro](https://docs.preczn.com/docs/payflow-pro.md): Connect your merchant's Payflow Pro account to process card and ACH transactions through Preczn.
  - [Payrix](https://docs.preczn.com/docs/payrix.md): Configure a Payrix platform connection to board merchants, remediate RFIs, import merchants and transactions, and process card, ACH, and wallet payments.
    - [Payrix ACH Integration](https://docs.preczn.com/docs/payrix-ach.md): Process ACH transactions with Payrix including GIACT risk verification
  - [Quantum ePay](https://docs.preczn.com/docs/quantum-epay.md): Connect your merchant's Quantum ePay account to process credit card transactions through Preczn.
  - [Rainforest](https://docs.preczn.com/docs/rainforest.md): Configure a Rainforest platform connection and webhook, then board merchants to Rainforest, optionally setting a billing profile and additional underwriting data.
  - [Ramp](https://docs.preczn.com/docs/ramp.md): Configure a Ramp issuing connection and board merchants by prefilling a Ramp finance application that the merchant completes in Ramp.
  - [Stax](https://docs.preczn.com/docs/stax.md): Import your merchants and their transaction history from Stax into Preczn.
  - [Stripe](https://docs.preczn.com/docs/stripe.md): Connect a merchant's own Stripe account to process credit card transactions through Preczn.
  - [Stripe Connect](https://docs.preczn.com/docs/stripe-connect.md): Configure your Stripe Connect platform connection to board and import merchants and process their card and Apple Pay transactions.
  - [Synchrony](https://docs.preczn.com/docs/synchrony.md): Board merchants to Synchrony's consumer financing program and track each enrollment through approval.
  - [Till Payments](https://docs.preczn.com/docs/till-payments.md): Connect your merchant's Till Payments account to process credit card transactions through Preczn.

## Guides: Merchants
- [Merchants Overview](https://docs.preczn.com/docs/merchants-overview.md): Find what a Preczn merchant record holds and where to create, connect, and manage merchants in the Merchant Vault or over the API.
- [Merchants and Connections](https://docs.preczn.com/docs/merchants-and-connections.md): Give a merchant one of each connection your platform supports, and create a second merchant record when a business needs two accounts at one provider.
- [Addresses and Locations](https://docs.preczn.com/docs/addresses-and-locations.md): Set a merchant's registered business address, mailing address, and locations, and see which connections read each one.
- [Merchant Lifecycle](https://docs.preczn.com/docs/merchant-lifecycle.md): Follow a merchant through the Created, Onboarding, and Ready to Process stages, and see what moves each connection status forward.
- [Creating Merchants](https://docs.preczn.com/docs/creating-merchants.md): Add merchants one at a time in the Dashboard or over the API, or in bulk from a CSV file or a processor connection you've already configured.
- [Linking Existing Credentials](https://docs.preczn.com/docs/linking-existing-credentials.md): Connect merchants already boarded to a processor outside Preczn by linking their existing credentials, in the Dashboard or through the API.
- Onboarding
  - [Merchant Onboarding](https://docs.preczn.com/docs/merchant-onboarding.md): Plan how you create merchants, collect their data, submit them for underwriting, and track each connection's status until it reaches Active.
  - [Onboarding Data Requirements](https://docs.preczn.com/docs/onboarding-data-requirements.md): How Preczn tracks, evaluates, and reports merchant data requirements for processor onboarding
  - [Onboarding API Reference](https://docs.preczn.com/docs/onboarding-api.md): Onboard a merchant over the API: create the merchant, add owners and bank accounts, check requirements, and submit to a connection.
  - [Onboarding Troubleshooting](https://docs.preczn.com/docs/onboarding-troubleshooting.md): Diagnose and resolve common issues during merchant onboarding
- [Boarding Forms](https://docs.preczn.com/docs/boarding-forms.md): Collect merchant business, ownership, banking, and agreement data in Preczn-hosted boarding forms so sensitive data stays off your servers.
  - [Configuring Domain Names](https://docs.preczn.com/docs/configuring-domain-names.md): Set up branded URLs for your boarding forms with DNS and SSL configuration
  - [Boarding Form Templates](https://docs.preczn.com/docs/boarding-form-templates.md): Configure appearance, behavior, and branding for Preczn-hosted boarding forms
    - [Welcome Section](https://docs.preczn.com/docs/boarding-form-welcome-section.md): Add an introduction, a platform agreement, and a step that captures who is completing the application to the start of a boarding form.
  - [Creating Forms](https://docs.preczn.com/docs/creating-forms.md): Generate boarding form links for merchants and configure automatic onboarding
  - [Multi-Connection Boarding Forms](https://docs.preczn.com/docs/multi-connection-boarding-forms.md): Onboard a merchant to multiple fintech connections from a single boarding form.
  - [Boarding Forms API Reference](https://docs.preczn.com/docs/boarding-forms-api.md): API endpoints for managing boarding form templates and generating form links
- Managing Merchants
  - [Billing Group Management](https://docs.preczn.com/docs/billing-group-management.md): Assign merchants to processor billing groups on Payrix and Rainforest, and add or remove Payrix billing groups through the Preczn API.
  - [Enabling Merchants](https://docs.preczn.com/docs/enabling-merchants.md): Control when merchants can process payments by enabling or disabling them
  - [Labeling Merchants](https://docs.preczn.com/docs/labeling-merchants.md): Assign labels to merchants for easier cohort management and filtering
  - [Cloning Merchants](https://docs.preczn.com/docs/cloning-merchants.md): Create a new Merchant from an existing Merchant's data.

## Guides: Payment Transactions
- [Integrations](https://docs.preczn.com/docs/integration.md): Compare PaymentElements, PaymentFields, and direct API integration by how each collects card data and what it means for your PCI DSS SAQ.
  - [PaymentFields Integration](https://docs.preczn.com/docs/paymentfields-integration.md): Add the PaymentFields script to your payment form to tokenize card data in the browser and send a single-use token to your server.
  - [PaymentElements Integration](https://docs.preczn.com/docs/paymentelements-integration.md): Collect card and ACH credentials in Preczn-hosted iframes and exchange them for tokens, without sensitive data ever touching your web app.
  - [Direct API Integration](https://docs.preczn.com/docs/direct-api-integration.md): Send transactions from your own servers to the Preczn REST API with an x-api-key header, using raw payment data or existing tokens.
- [Tokenization](https://docs.preczn.com/docs/tokenization.md): Store card and bank account details in the Preczn token vault and use single-use or multi-use tokens in place of account data on transactions.
  - [Token Import](https://docs.preczn.com/docs/token-import.md): Import existing payment tokens from your current provider into Preczn as a Preczn CSV file or a Stripe JSON export, encrypted for transfer.
  - [Storing Billing Information](https://docs.preczn.com/docs/storing-billing-information.md): Send billing information with a transaction to store it on the multi-use token, reuse it on later charges, and read or update it.
  - [Card On File Flags](https://docs.preczn.com/docs/card-on-file-flags.md): Set tokenUsage on stored-token transactions so Preczn sends the correct card-on-file flags to each processor.
- [Transaction Types](https://docs.preczn.com/docs/payment-transactions.md): Choose among the sale, verify, auth, capture, void, and refund transaction types and build each POST /v1/transactions request.
- Payment Data
  - [Country & Currency Codes](https://docs.preczn.com/docs/country-and-currency-codes.md): Look up the alpha-3 country and currency codes to send to Preczn, which maps each code to the format your processor expects.
  - [Metadata](https://docs.preczn.com/docs/metadata.md): Attach up to 20 string key-value pairs to a transaction, which Preczn stores, returns, and forwards to processors that support metadata.
  - [Dynamic Statement Descriptors](https://docs.preczn.com/docs/dynamic-statement-descriptors.md): Send custom statement descriptors with your transactions
  - [CVV](https://docs.preczn.com/docs/cvv.md): Read the normalized CVV response codes that Preczn returns for card transactions on every connection, and what each code means.
  - [AVS](https://docs.preczn.com/docs/avs.md): Read the normalized AVS response codes that Preczn returns for card transactions on every connection, and what each code means.
  - [Level II Data](https://docs.preczn.com/docs/level-ii-data.md): Send invoice and tax data with business and corporate card transactions so they can qualify for Level II interchange rates.
  - [Level III Data](https://docs.preczn.com/docs/level-iii-data.md): Add line-item detail to Level II transactions so corporate and purchasing card payments can qualify for Level III interchange rates.
- [Transaction Import](https://docs.preczn.com/docs/transaction-import.md): Import a merchant's past or ongoing transactions from a supported connection into Preczn, one time or continuously, without processing them through Preczn.
- [Transaction Data Retrieval](https://docs.preczn.com/docs/transaction-data-retrieval.md): Pull transaction data into analytics tools with the List Transactions API, CSV Transaction Export, transaction webhooks, or logged responses.
- Routing
  - [Routing Methods](https://docs.preczn.com/docs/routing-methods.md): Choose direct, plan, or hybrid routing to send each transaction to a processor, and read the response to see how Preczn routed it.
  - [Routing Plans](https://docs.preczn.com/docs/routing-plans.md): Create a routing plan, choose the connections it spans, and activate or disable it from the plans grid.
  - [Routing Rules](https://docs.preczn.com/docs/routing-rules.md): How a plan chooses a connection for each transaction, the order rules are evaluated in, and how to configure each rule type.
  - [Assigning Merchants to Plans](https://docs.preczn.com/docs/assigning-merchants-to-plans.md): Give a merchant a routing plan from the dashboard or the API, move merchants in bulk, and schedule moves for a future date.

## Guides: PAYMENT METHODS
- [Credit Cards](https://docs.preczn.com/docs/credit-cards.md): Check credit card capabilities, the payment flow, and Preczn test cards before you accept card payments for your merchants.
- [ACH (Direct Debit)](https://docs.preczn.com/docs/ach-transactions.md): Accept bank account payments directly from your customers' checking or savings accounts
  - [ACH PaymentFields Integration](https://docs.preczn.com/docs/ach-paymentfields-integration.md): Securely collect bank account details using the client-side PaymentFields library
  - [Server-Side Bank Account Tokenization](https://docs.preczn.com/docs/server-side-bank-account-tokenization.md): Tokenize existing bank account data for recurring ACH payments
  - [ACH Verify Transaction](https://docs.preczn.com/docs/ach-verify-transaction.md): Validate bank account information before processing payments
  - [ACH Sale Transaction](https://docs.preczn.com/docs/ach-sale-transaction.md): Process ACH payments to debit funds from customer bank accounts
  - [ACH Refund Transaction](https://docs.preczn.com/docs/ach-refund-transaction.md): Return funds to customers via ACH refund transactions
  - [ACH Best Practices](https://docs.preczn.com/docs/ach-best-practices.md): Reduce ACH returns and failures by validating bank accounts, getting customer authorization, planning for settlement timing, and handling webhooks.
  - [ACH Error Reference & Troubleshooting](https://docs.preczn.com/docs/ach-error-reference.md): Error response format, status codes, and troubleshooting guide for ACH transactions
- [B2B2C Loans](https://docs.preczn.com/docs/lending.md): Store B2B2C loans as Preczn tokens, track loan status and data, and run transactions against those loans for your merchants.
  - [Tokenizing Loans](https://docs.preczn.com/docs/tokenizing-loans.md): Create a loan token for an existing B2B2C loan, let Preczn tokenize new loans automatically, and retrieve loan status and data from the token.
  - [Connections and Plans](https://docs.preczn.com/docs/lending-connections-and-plans.md): Assign a merchant to an active plan that includes its Greensky or Nelnet connection so you can run drawdowns against the merchant's loans.
  - [Loan Updates](https://docs.preczn.com/docs/loan-updates.md): Track changes to a loan's status and balance with token update webhooks or the Get Token API, a feature still in active development.
  - [Loan Transactions](https://docs.preczn.com/docs/loan-transactions.md): Create a drawdown transaction with a loan token to draw funds from a B2B2C loan originated through Greensky or Nelnet.
  - [Loan Export](https://docs.preczn.com/docs/loan-export.md): Export loans created in a date range, with their transaction IDs, to CSV from the Loan Export page in the Dashboard.
- [Apple Pay on the Web](https://docs.preczn.com/docs/apple-pay.md): Check Apple Pay on the Web capabilities and the payment flow before you verify your domain and add Apple Pay to your checkout.
  - [Apple Pay Domain Verification](https://docs.preczn.com/docs/apple-pay-domain-verification.md): Add your Apple Pay web domains in the Preczn Dashboard to complete Apple Pay domain verification for the websites where merchants offer it.
  - [Apple Pay on the Web Implementation](https://docs.preczn.com/docs/apple-pay-on-the-web.md): Add the Apple Pay button to your web checkout with the Preczn client, get a single-use token, and process an Apple Pay transaction.
- [Google Pay™ for Web](https://docs.preczn.com/docs/google-pay-for-web.md): Add the Google Pay button to your web checkout with the Preczn client, test it, and process a Google Pay transaction.

## Guides: SAQ Management
- [SAQ Management Overview](https://docs.preczn.com/docs/saq-management-overview.md): Monitor and manage PCI DSS Self-Assessment Questionnaire compliance for your merchants.
- [SAQ Integration Guide](https://docs.preczn.com/docs/saq-integration-guide.md): Build SAQ compliance workflows into your application using the Preczn API.
- [Managing SAQs in the Dashboard](https://docs.preczn.com/docs/managing-saqs-in-the-dashboard.md): View merchant compliance status, review SAQ history, and download signed documents from the Preczn Dashboard.

## Guides: Dashboard
- [Dashboard Overview](https://docs.preczn.com/docs/dashboard-overview.md): Use the Preczn Dashboard to view, search, and manage your merchants' transactions.
  - [Quick Actions](https://docs.preczn.com/docs/quick-actions.md): Access common tasks instantly from anywhere in the dashboard
- [User Management](https://docs.preczn.com/docs/user-management.md): Add, edit, disable, and delete Preczn Dashboard users, assign roles, and unlock accounts from Settings > Users.
  - [Multi-Factor Authentication (MFA) Setup Guide](https://docs.preczn.com/docs/mfa-setup.md): Set up MFA for your Preczn Dashboard login with an authenticator app, remember trusted devices, and fix common code and lockout problems.
  - [Password Policy and Guidance](https://docs.preczn.com/docs/password-policy.md): Review the password rules the Preczn Dashboard enforces, including length, complexity, the 90-day change requirement, and expiration reminders.

## Guides: Developers
- [API Keys](https://docs.preczn.com/docs/api-keys.md): Create, rotate, and deactivate public and private API keys in the Preczn Dashboard, and authenticate test and live requests with them.
- [Live vs Test Mode](https://docs.preczn.com/docs/live-vs-test-mode.md): How Preczn's Test and Live environments differ, what is isolated between them, and how to select a mode from the API or the dashboard.
- [Webhooks](https://docs.preczn.com/docs/webhooks.md): How Preczn's event notifications work, and the full catalog of subscribable events.
  - [Subscribing to Webhooks](https://docs.preczn.com/docs/subscribing-to-webhooks.md): Create and manage webhook subscriptions from the dashboard or over the API.
  - [Receiving and Verifying Webhooks](https://docs.preczn.com/docs/receiving-and-verifying-webhooks.md): Build your endpoint: the request format, HMAC signature verification, and how to respond.
  - [Delivery, Retries, and Failures](https://docs.preczn.com/docs/webhook-delivery-and-failures.md): Retry behavior, why a subscription is disabled after repeated failures, who gets notified, and how to recover.
  - [Transaction Webhook Payloads](https://docs.preczn.com/docs/transaction-webhook-payloads.md): Payload reference for transaction.approved, declined, pending, and errored, including loan drawdowns.
  - [Merchant Webhook Payloads](https://docs.preczn.com/docs/merchant-webhook-payloads.md): Payload reference for merchant.created, updated, and deleted.
  - [Loan Webhook Payloads](https://docs.preczn.com/docs/loan-webhook-payloads.md): Payload reference for loan.created and loan.updated, and how they differ from drawdown transactions.
  - [Boarding Form Webhook Payloads](https://docs.preczn.com/docs/boarding-form-webhook-payloads.md): Payload reference for the five form.* lifecycle events, from creation through completion or expiration.
- [Idempotency Key Support](https://docs.preczn.com/docs/idempotency-keys.md): Prevent duplicate transactions when network issues cause uncertain request outcomes
- [Object ID Prefixes](https://docs.preczn.com/docs/object-id-prefixes.md): Identify any Preczn object by its ID prefix, with the test and live prefix for each object type.
- [Generate a Client Library](https://docs.preczn.com/docs/client-libraries.md): Generate a typed Preczn API client in your language from the OpenAPI specification, since Preczn doesn't publish a client library.

## Guides: Resources
- [Frequently Asked Questions](https://docs.preczn.com/docs/frequently-asked-questions.md): Find answers to common questions about Preczn's fintech operations platform, PCI compliance, tokenization, and more.
- [Card Data Detection & Redaction](https://docs.preczn.com/docs/card-data-detection-and-redaction.md): See which transaction field values Preczn redacts as possible card numbers, and format order, description, and metadata values to avoid redaction.

## API Reference: Preczn API
- Payment Processing
  - [Process Transaction](https://docs.preczn.com/reference/processtransaction.md)
  - [List Transactions](https://docs.preczn.com/reference/list-transactions.md)
  - [Get Transaction](https://docs.preczn.com/reference/gettransaction.md)
- Payment Tokens
  - [Create Payment Method Token](https://docs.preczn.com/reference/createtoken.md)
  - [Get Token](https://docs.preczn.com/reference/gettoken.md)
  - [Update Token](https://docs.preczn.com/reference/updatetoken.md)
  - [List Payment Method Tokens](https://docs.preczn.com/reference/listtokens.md)
- BIN Lookup
  - [BIN Lookup](https://docs.preczn.com/reference/binlookup.md)
- Merchant Vault
  - [List Merchants](https://docs.preczn.com/reference/listmerchants.md)
  - [Get Merchant](https://docs.preczn.com/reference/getmerchant.md)
  - [Create Merchant](https://docs.preczn.com/reference/createmerchant.md)
  - [Update Merchant](https://docs.preczn.com/reference/updatemerchant.md)
  - [Delete Merchant](https://docs.preczn.com/reference/deletemerchant.md)
  - [Add Merchant Attachment](https://docs.preczn.com/reference/addmerchantattachment.md)
  - [Get Merchant Requirement](https://docs.preczn.com/reference/getmerchantrequirement.md)
  - Bank Accounts
    - [Add Merchant Bank Account](https://docs.preczn.com/reference/addmerchantbank.md)
    - [Update Bank Details](https://docs.preczn.com/reference/patchbankdetails.md)
    - [Add Banking Attachment](https://docs.preczn.com/reference/addbankingattachment.md)
    - [Update Banking Attachment](https://docs.preczn.com/reference/updatebankaccountattachment.md)
  - Owners
    - [Add Merchant Owner](https://docs.preczn.com/reference/addmerchantowner.md)
    - [Update Merchant Owner](https://docs.preczn.com/reference/updatemerchantowner.md)
    - [Add Owner Attachment](https://docs.preczn.com/reference/addownerattachment.md)
    - [Update Owner Attachment](https://docs.preczn.com/reference/updateownerattachment.md)
  - [Update Connection Details](https://docs.preczn.com/reference/patchconnectiondetails.md)
  - [Onboard Merchant to Connection](https://docs.preczn.com/reference/onboardmerchanttoconnection.md)
  - [Close Merchant Account at Connection](https://docs.preczn.com/reference/closemerchantaccountatconnection.md)
  - [Get Available Platform Connections for AFP](https://docs.preczn.com/reference/getavailableplatformconnections.md): Returns the list of Adyen for Platforms connections configured on the platform. Used to populate the platformConnectionId dropdown when linking a merchant to a specific AFP Business Unit.
  - Billing Group Management
    - [Get Merchant Connection Billing Groups](https://docs.preczn.com/reference/getmerchantconnectionbillinggroups.md)
    - [Add Billing Group to Merchant Connection](https://docs.preczn.com/reference/addbillinggroup.md): Adds a billing group (org) to a Payrix merchant connection. This endpoint updates the billing groups associated with the merchant at Payrix and stores them in the Preczn merchant record.
    - [Delete Billing Group from Merchant Connection](https://docs.preczn.com/reference/deletebillinggroup.md): Removes a billing group (org) from a Payrix merchant connection. This endpoint updates the billing groups associated with the merchant at Payrix.
  - [Set per-role contact assignments for a merchant's connection](https://docs.preczn.com/reference/putmerchantconnectioncontactroles.md): Replaces the entire role-to-contact assignment map on the connection. Inline-created contacts are deduplicated by canonical (firstName, lastName, email) per merchant. Owner refs are validated against…
  - [Get per-role contact assignments with server-side resolution status](https://docs.preczn.com/reference/getmerchantconnectioncontactroles.md): Returns the active role assignments for this connection. Each entry resolves the polymorphic ref server-side; broken refs (deleted owner / contact, or persisted data that no longer parses against the…
- Merchant Contacts
  - [Create a merchant contact (canonical-dedup)](https://docs.preczn.com/reference/createmerchantcontact.md): Creates a new contact on the merchant. The canonical key is `(firstName.trim(), lastName.trim(), email.trim().toLowerCase())`. If a contact with the same canonical key already exists on this…
  - [List all contacts for a merchant](https://docs.preczn.com/reference/listmerchantcontacts.md): Returns a flat array of contact resources. Per-role assignments live on the connection at `/connections/:connectionId/contact-roles` and are not included here.
  - [Fetch a single contact by id](https://docs.preczn.com/reference/getmerchantcontact.md): Returns the contact, or 404 if it does not exist OR belongs to a different merchant. The same 404 is returned in both cases so callers cannot probe contact ids across merchants.
  - [Update a contact (partial)](https://docs.preczn.com/reference/updatemerchantcontact.md): Updates any subset of `firstName`, `lastName`, `email`, `phone`, `title`, `notes`. If the patch would make this contact's canonical identity match another existing contact on the same merchant,…
- Merchant Locations
  - [Create a merchant location](https://docs.preczn.com/reference/createmerchantlocation.md): Creates a physical location on the merchant and appends its id to the merchant's `locations` index. `name`, `address`, `mcc` and `phone` are required and are stored exactly as supplied — a location…
  - [List locations for a merchant](https://docs.preczn.com/reference/listmerchantlocations.md): Returns one page of locations in the platform's standard list envelope — `{ locations, hasMore, lastId }` — never a bare array. Page forward by passing the previous response's `lastId`. A merchant…
  - [Fetch a single location by id](https://docs.preczn.com/reference/getmerchantlocation.md): Returns the stored location record as-is — there is no second "resolved" representation, because the stored record is already the effective value. Returns 404 if the location does not exist OR…
  - [Update a location (partial)](https://docs.preczn.com/reference/updatemerchantlocation.md): Partial update of a single location row — NOT a full-array replace. An omitted field keeps its stored value; a provided field replaces it. The core embedded fields (`name`, `address` and its…
  - [Delete a location](https://docs.preczn.com/reference/deletemerchantlocation.md): Removes the location and de-indexes it from the merchant's `locations` array. Returns 204 with an empty body on success. A location currently designated as the merchant's primary cannot be deleted —…
- Plans
  - [Get Platform Plans](https://docs.preczn.com/reference/getplans.md)
- Boarding Forms
  - [Create Form](https://docs.preczn.com/reference/createform.md)
  - [Get Merchant Form Details](https://docs.preczn.com/reference/getmerchantforms.md)
  - [Get Form](https://docs.preczn.com/reference/getform.md)
  - [Get Terms and Conditions](https://docs.preczn.com/reference/gettermsandconditions.md): Returns the terms and conditions for a specific connection on a boarding form. For multi-connection forms, pass the connectionId query parameter to specify which connection's T&C to retrieve. If…
  - [Get Connection Specific Requirements](https://docs.preczn.com/reference/getconnectionspecificrequirements.md): Returns the connection-specific requirements for a boarding form. For multi-connection forms, pass the connectionId query parameter to specify which connection's requirements to retrieve.
  - [Update Connection Specific Requirements](https://docs.preczn.com/reference/updateconnectionspecificrequirements.md): Updates the connection-specific requirements for a boarding form. For multi-connection forms, pass the connectionId query parameter to specify which connection's requirements to update.
  - [List all contacts available on the form's merchant](https://docs.preczn.com/reference/listformcontacts.md): Returns the flat list of contact resources on the form's merchant. Use this to populate a picker for the contact-roles UI when the user wants to assign an existing contact to a role slot. For the…
  - [Update a contact via the form's tokenized surface](https://docs.preczn.com/reference/patchformcontact.md): Form-scoped equivalent of PATCH /v1/merchants/:merchantId/contacts/:contactId. Resolves the merchant from the form record then delegates to ContactApiService. Returns 409 if the patch creates a…
  - [Set per-role contact assignments for the form's connection](https://docs.preczn.com/reference/putformconnectioncontactroles.md): Form-scoped equivalent of PUT /v1/merchants/:merchantId/connections/:connectionId/contact-roles. Possession of a non-expired form id authorizes this mutation — same pattern as every other mid-flow…
  - [Get per-role contact assignments for the form's connection](https://docs.preczn.com/reference/getformconnectioncontactroles.md): Form-scoped equivalent of GET /v1/merchants/:merchantId/connections/:connectionId/contact-roles. Returns active role assignments; broken refs come back as `status: "unresolved"`.
  - [Create a location on the form's merchant](https://docs.preczn.com/reference/createformlocation.md): Form-scoped equivalent of POST /v1/merchants/:merchantId/locations. Resolves the merchant from the form record then delegates to LocationApiService: `name`, `address`, `mcc` and `phone` are required…
  - [List the form's merchant's locations](https://docs.preczn.com/reference/listformlocations.md): Form-scoped equivalent of GET /v1/merchants/:merchantId/locations. Same list envelope — `{ locations, hasMore, lastId }` — and the same location representation, so ids are available to the runtime…
  - [Fetch one of the form's merchant's locations](https://docs.preczn.com/reference/getformlocation.md): Form-scoped equivalent of GET /v1/merchants/:merchantId/locations/:locationId. Returns 404 if the location does not exist OR belongs to a different merchant — the same 404 for both, so location ids…
  - [Update one of the form's merchant's locations (partial)](https://docs.preczn.com/reference/updateformlocation.md): Form-scoped equivalent of PATCH /v1/merchants/:merchantId/locations/:locationId. Provided fields replace, omitted fields are untouched. `name`, `address`, `mcc` and `phone` may not be set to null.…
  - [Delete one of the form's merchant's locations](https://docs.preczn.com/reference/deleteformlocation.md): Form-scoped equivalent of DELETE /v1/merchants/:merchantId/locations/:locationId. Removes the location and de-indexes it from the merchant's `locations` array; 204 with an empty body on success. The…
  - [Set or clear the form's merchant's primary location](https://docs.preczn.com/reference/setformprimarylocation.md): Form-scoped equivalent of the `primaryLocationId` field on PATCH /v1/merchants/:merchantId. `{ "primaryLocationId": "<id>" }` designates a location of the form's merchant as primary (404 if the id is…
- Boarding Form Templates
  - [Create Form Template](https://docs.preczn.com/reference/createformtemplate.md)
  - [Get All Form Templates](https://docs.preczn.com/reference/getallformtemplates.md)
  - [Update Form Template](https://docs.preczn.com/reference/updateformtemplate.md)
  - [Get Form Template By ID](https://docs.preczn.com/reference/getformtemplatebyid.md)
- Loans
  - [Get Loans](https://docs.preczn.com/reference/getloans.md)
  - [Get Loan](https://docs.preczn.com/reference/getloan.md)
- Requirements Template
  - [Get Connection Parameters](https://docs.preczn.com/reference/getconnectionparameters.md)
  - [List Requirement Templates](https://docs.preczn.com/reference/getplatformrequirementtemplates.md)
  - [Create Requirements Template](https://docs.preczn.com/reference/createrequirementstemplate.md)
  - [Get Requirements Template](https://docs.preczn.com/reference/getrequirementstemplate.md)
  - [Update Requirements Template](https://docs.preczn.com/reference/updaterequirementstemplate.md)
  - [Delete Requirements Template](https://docs.preczn.com/reference/deleterequirementstemplate.md)
- Boarding Domains
  - [Create Boarding Domain](https://docs.preczn.com/reference/createboardingdomain.md)
  - [Get Boarding Domains](https://docs.preczn.com/reference/getboardingdomains.md)
  - [Deactivate Boarding Domain](https://docs.preczn.com/reference/deleteboardingdomain.md)
  - [Get Boarding Domain by ID](https://docs.preczn.com/reference/getboardingdomain.md)
- Webhooks API
  - [Get Webhook](https://docs.preczn.com/reference/getwebhook.md)
  - [Delete Webhook](https://docs.preczn.com/reference/deletewebhook.md)
  - [Update Webhook](https://docs.preczn.com/reference/updatewebhook.md)
  - [Create Webhook](https://docs.preczn.com/reference/createwebhook.md)
  - [Get Webhooks](https://docs.preczn.com/reference/getwebhooks.md)
- SAQ
  - [Get SAQ](https://docs.preczn.com/reference/getsaq.md)
  - [Get merchant SAQ list](https://docs.preczn.com/reference/getmerchantsaqs.md)
  - [Create SAQ](https://docs.preczn.com/reference/createsaq.md)
  - [Update SAQ](https://docs.preczn.com/reference/updatesaq.md)
  - [Sign PDF](https://docs.preczn.com/reference/signpdf.md)
  - [Get SAQ Signed PDF](https://docs.preczn.com/reference/getsignedpdf.md)
  - [Get SAQ Draft PDF](https://docs.preczn.com/reference/getdraftpdf.md)
  - [Send Signed SAQ to Connection](https://docs.preczn.com/reference/sendsaqtoconnection.md)
  - [Upload Signed SAQ PDF](https://docs.preczn.com/reference/uploadsignedsaqpdf.md)
  - [Upload SAQ Template PDF](https://docs.preczn.com/reference/uploadsaqtemplatepdf.md)
- Session Management
  - [Create Client Session](https://docs.preczn.com/reference/createclientsession.md)

## Recipes
- [ACH PaymentFields](https://docs.preczn.com/recipes/ach-payment-fields.md)
- [Adding Labels to a Merchant](https://docs.preczn.com/recipes/adding-labels-to-a-merchant.md)
- [Apple Pay on the Web](https://docs.preczn.com/recipes/apple-pay-on-the-web.md)
- [Creating a Merchant](https://docs.preczn.com/recipes/creating-a-merchant.md)
- [Get Merchant by ID](https://docs.preczn.com/recipes/get-merchant-by-id.md)
- [Get Merchant Onboarding Requirements](https://docs.preczn.com/recipes/get-merchant-onboarding-requirements.md)
- [Google Pay for Web](https://docs.preczn.com/recipes/google-pay-for-web.md)
- [PaymentFields](https://docs.preczn.com/recipes/paymentfields.md)
- [Tokenize an Existing Loan](https://docs.preczn.com/recipes/tokenize-an-existing-loan.md)

## Pages
- [Preczn Data Security](https://docs.preczn.com/page/preczn-data-security.md)

## Changelog
- [10/16/2026 Release](https://docs.preczn.com/changelog/10162026-release.md)
- [10/15/2026 Release](https://docs.preczn.com/changelog/10152026-release.md)
- [9/25/2026 Release](https://docs.preczn.com/changelog/9252026-release.md)
- [9/16/2026 Release](https://docs.preczn.com/changelog/9162026-release.md)
- [8/26/2026 Release](https://docs.preczn.com/changelog/8262026-release.md)
- [8/24/2026 Release](https://docs.preczn.com/changelog/8242026-release.md)
- [8/6/2026 Release](https://docs.preczn.com/changelog/862026-release.md)
- [7/16/2026 Release](https://docs.preczn.com/changelog/7162026-release.md)
- [7/01/2026 Release](https://docs.preczn.com/changelog/07012026-release.md)
- [Upcoming Change — Standardized Error Response Format](https://docs.preczn.com/changelog/upcoming-change-standardized-error-response-format.md)