This glossary is comprehensive and very detailed, and is designed to serve as a valuable reference during your implementation of Straddle’s services. Don’t go crazy memorizing all of these, but do refer back to them as needed.
A
ACH (Automated Clearing House)
An electronic network for financial transactions in the United States, used by Straddle for processing certain types of bank transfers.
Account
A business entity that has entered into a contractual relationship with Straddle to utilize its services directly. Accounts can access the Straddle API Sandbox upon creation and need to complete an onboarding process for production access.
Account Status
The current state of a Straddle account, which can be one of: created
, onboarding
, active
, rejected
, or inactive
.
Account-to-Account (A2A) Payments
Transactions that move money directly from one bank account to another. Straddle orchestrates A2A money movement via multitple payment rails so you don’t have to worr
Address Risk
A component of Identity that provides a risk score for physical addresses.
Adverse Media Screening
A component of Identity that identifies individuals associated with news items related to financial crimes.
AML (Anti-Money Laundering)
Regulations and procedures that Straddle helps you comply with to prevent criminals from disguising illegally obtained funds as legitimate income.
API (Application Programming Interface)
A set of protocols and tools for building software applications, specifically referring to Straddle’s API. The Straddle API allows developers to integrate payment and identity verification features into their applications.
API Key
A unique identifier used to authenticate requests to the Straddle API. API keys should be kept secure and not shared publicly.
API Version
The specific version of the Straddle API being used, which determines the available features and endpoints.
Authentication
The process of verifying the identity of a user or system making requests to the Straddle API. Straddle uses Bearer tokens for API authentication.
B
Balance Check
A feature in Straddle’s platform that verifies the available balance in a customer’s account before initiating a charge. This helps prevent failed payments due to insufficient funds.
Bank Account Verification
The process of confirming that a bank account is valid and belongs to the stated owner. Straddle offers multiple methods for bank account verification, including API-based verification and open banking connections.
Bearer Token
A type of access token used for authentication in the Straddle API.
Bridge
Straddle’s comprehensive suite of account connectivity endpoints that facilitate secure connections between users and their financial accounts. Bridge includes:
A drop-in open banking widget
Support for third-party tokens (e.g., Plaid, MX)
API-based bank account verification
Bridge Token
A JWT (JSON Web Token) used in the Straddle Bridge widget for secure account connectivity. Bridge tokens are generated using the /v1/bridge/initialize
endpoint.
Bridge Widget
A drop-in user interface component provided by Straddle for easy integration of bank account connectivity features. The Bridge Widget is a hosted UI component that you can embed on your website to allow customers to connect their bank accounts to your platform.
Business Profile
A set of information about an account on the Straddle platform, including details such as legal name, business name, website, description, tax ID, address, and industry information.
C
Capability
A specific feature or permission granted to an account on the Straddle platform. Capabilities include payment_types
, customer_types
, and consent_types
.
Capability Request
A formal request to enable a specific capability for an account on the Straddle platform.
Charge
A type of payment transaction where money is debited from a Customer. Charges are created using the /v1/charges
endpoint.
Compliance Profile
A set of information in the Straddle API request when creating a Customer that triggers fully-compliant KYC validation.
Consent Type
The method by which a customer provides authorization for a transaction. Straddle supports two consent types: internet
and signed
.
Correlation ID
An optional client-generated identifier passed in the request headers to trace and debug a series of related API requests.
Correlation Score
A measure of the relationship strength between different elements of provided personally identifiable information (PII).
Create Charge
The API endpoint and process for initiating a new charge transaction.
Create Payout
The API endpoint and process for initiating a new payout transaction.
Currency
The monetary unit used for transactions on the Straddle platform.
Customer
An individual or business involved in a payment transaction with your business. All customers are automatically screened for fraud and watchlist compliance when they are created. The customer object is used to:
Manage fraud and compliance
Generate paykeys
Relate payment activity
Send notifications
Customer Identification Program (CIP)
A government-mandated regulation that Straddle’s KYC process complies with. Straddle Identity keeps you compliant with CIP requirements by:
Screening customers for fraud
Performing (optional) KYB and KYC
Matching against watchlist databases
Enrolling in ongoing watchlist monitoring
Customer Review
An endpoint in the Straddle API that allows you to review a customer’s identity results.
Customer Status
The current state of a customer in the Straddle system, which can be one of: pending
, review
, verified
, inactive
, or rejected
.
Customer Type
The classification of a customer as either an individual or a business. This determines the type of information required for verification and the available features.
D
Dashboard
The web-based user interface provided by Straddle for account setup, activity reporting, customer management, and more.
Decision Engine
The core component of Straddle’s Identity that provides automated decisioning on fraud, synthetic ID, and PII matching.
Deposit
A type of funding event where money is sent from Straddle to an your business bank account for the settlement of charges.
Device Info
Information about the device used by a customer during a transaction.
E
Email Risk
A component of Identity that provides a risk score for email addresses.
Embed
A product offering by Straddle enables deeply integrated payment infrastructure for platforms, marketplaces, and other PSP/PayFac providers. Embed simplifies the process of integrating bank payments and managing complex money movement scenarios within an app or service.
Error Response
A standardized format for API responses when an error occurs.
External ID
A unique identifier provided by the integrating application for cross-referencing purposes between Straddle and an external system.
F
Fraud Score
A score that assesses the risk of identity fraud associated with a transaction.
Funding Event
Represents the movement of money between Straddle and an Account. Funding events are automatically generated as part of a payment and cannot be created directly via the API.
Funding Event Type
The classification of a funding event, which can be charge deposit
, charge reversal
, payout return
, or payout withdrawal
.
Funding Time
The time that it takes for a funding event to complete. Unlike other providers, Straddle initiates funding events within 24 hours.
G
Global Watchlist Screening
Straddle’s process for identifying risk by matching entities against sanctions and enforcement lists.
H
HTTP Status Code
A standard code returned with an API response to indicate the outcome of the request.
I
Identity Velocity
A factor considered in Identity that monitors the frequency and recency of identity usage.
Identity Verification
The process of confirming a customer’s identity. Straddle uses a combination of techniques to verify customer identities.
Identity-Linked Payment
Straddle’s core concept of connecting verified customer identities directly to payment methods. Paykeys are a new kind of payment token that contain both a customer’s identity and payment information.
Industry
The business sector in which an Account operates.
K
Know Your Business (KYB)
The process of verifying the identity and suitability of business customers.
Know Your Customer (KYC)
Straddle’s process of verifying the identity and suitability of customers. This process helps prevent fraud and ensures compliance with regulatory requirements.
KYC Field Validations
Comprehensive checks performed by Straddle on provided PII fields.
L
Linked Bank Account
A bank account that has been connected to a Straddle Account. Funding events, like deposits and withdrawals, are transfers from Straddle to the linked bank account.
M
Metadata
User-defined key-value pairs that can be attached to various objects in the Straddle system. Metadata is useful for storing additional information about an object in a structured format.
N
Network Alerts
Notifications generated by Straddle’s consortium partners related to potential risks related to a Customer or Payment.
O
OAuth
An open standard for access delegation, used in Straddle’s authentication process.
OFAC SDN List
One of the key watchlists that Straddle screens against as part of its Global Watchlist Screening process.
Open Banking
A banking practice that provides third-party financial service providers open access to consumer banking, transaction, and other financial data.
Organization
A centralized entity in Straddle that allows management of multiple accounts. Organizations provide features such as centralized dashboard, streamlined account onboarding and user management, and consolidated reporting.
P
Pagination
The practice of dividing a large set of results into smaller, manageable “pages” in API responses.
Pay by Bank
Straddle’s unified API flow for bank payments. Pay by Bank combines identity verification, open banking, and money movement into a single API.
Paykey
A secure token that links a verified customer identity to a specific payment method. Paykeys are a core component of Straddle’s identity-linked payment system.
Paykey Source
The origin of a Paykey, which can be a bank account, Straddle, or a third-party provider like Plaid or MX.
Paykey Status
The current state of a Paykey in the Straddle system, which can be pending
, active
, inactive
, or rejected
.
Payment
A transaction between a Customer and a business (Account) using Straddle’s payment services. Straddle supports two types of payments: charge
and payout
.
Payment Date
The date on which a payment is scheduled to occur.
Payment Rail
The specific method or network used to process a payment, such as ACH or RTP.
Payment Status
The current state of a payment transaction, which can include created
, pending
, paid
, failed
, or cancelled
.
Payout
A type of payment transaction where money is sent to a customer.
Phone Risk
A component of Straddle’s risk assessment that provides a risk score for phone numbers.
Politically Exposed Person (PEP) Screening
A part of Straddle’s watchlist screening process to identify individuals who hold prominent public positions.
R
Rate Limiting
Restrictions on the number of API requests that can be made within a given time period.
Real-time Monitoring
Straddle’s continuous process of monitoring existing customers for changes in watchlist status.
Representative
An individual who has legal authority or significant responsibility within a business Account on the Straddle platform.
Request Example
A sample API request provided in the documentation to illustrate proper usage.
Request ID
An optional client generated header value that is returned in the API response. The request ID can be used to trace and debug individual API requests.
Risk Score
A numerical value assigned by Straddle’s system to indicate potential risk associated with a transaction or customer.
S
Sandbox
A testing environment that mimics the live Straddle platform, allowing developers to test API integrations without affecting real accounts or transactions. The Sandbox is available to all Straddle accounts via the url https://test.straddle.io
.
Sanctions and Enforcements Screening
Straddle’s process of screening consumers and businesses during onboarding against various sanctions lists.
Status Details
Additional information about the current status of an object in the Straddle system.
Status History
A record of status changes for an object over time.
StraddleAccount ID
A unique identifier for a Straddle account. This is the primary identifier for an account in the Straddle system. This value can be used by Platforms to originate API requests to Straddle on behalf of an Account by including the header X-Straddle-Account-Id
.
Straddle Identity
An all-in-one identity verification system that provides a risk score for physical addresses, email risk, phone risk, and more. Identity uses a combination of machine learning, big data, and predictive analytics to accurately verify identities and prevent fraud.
Support Channels
The various methods provided by a business during Account onboarding for customer support, such as email, phone, or chat.
Synthetic ID Detection
Custom models trained with consortium data to tackle fake and randomized synthetic patterns to produce highly accurate, real-time, actionable risk scores and reason codes, with 90% auto-capture in the riskiest 3% of users.
Synthetic Identity Risk Score
A score that predicts the probability that provided PII corresponds to a fictitious person.
T
Terms of Service
The agreement that users must accept to use the Straddle platform.
Third-Party Fraud
Also known as identity fraud, where an imposter uses a real person’s information for financial gain.
Transaction
A financial operation processed through the Straddle platform, such as a charge
or payout
.
W
Watchlist Screening
The process of checking customer information against various sanctions and enforcement lists.
Watchtower
Straddle’s transaction monitoring risk engine that provides built-in balance confirmation, real-time fraud detection, and risk assessment.
Webhook
A mechanism for receiving real-time notifications about events in the Straddle system.
Withdrawal
A type of funding event where money is pulled from an external bank account by Straddle, typically for payouts.