LogoLogo
StatusChangelogDashboardCreate a Ticket
  • Getting Started
  • Intro to APIs
  • How to Contact us
  • How to Go-Live
  • Intro to Risk
  • Intro to Spec Sheets
  • Product Guides
    • Deposit Hub
      • 🌎Global Cash
    • Credit Hub
    • Payment Accounts
    • ID Score
  • API References
    • OAuth
      • OAuth Object Details
      • Create OAuth Key
      • Generate Refresh Token
    • Users
      • User Object Details
      • Testing on UAT
      • View All Users
      • View User
      • Create User
      • Update User
      • Generate UBO Doc
      • Manage Duplicates
      • Allowed Document Types
      • Allowed Entity Scopes
      • Allowed Entity Types
    • Nodes
      • Node Object Details
      • Testing on UAT
      • View all User Nodes
      • View Node
      • Create Node
      • Update Node
      • Generate eCash Barcode
      • Allowed Node Types
      • View ATMs
    • Subnets
      • Subnet Object Details
      • Testing on UAT
      • View all Node Subnets
      • View Subnet
      • Create Subnet
      • Update Subnet
      • Push to Wallet
    • Shipments
      • Shipment Object Details
      • View all Subnet Shipments
      • View Shipment
      • Create Shipment
      • Cancel Shipment
    • Statements
      • Statement Object Details
      • View all User Statements
      • View all Node Statements
    • Transactions
      • Transaction Object Details
      • Testing on UAT
      • View all User Transactions
      • View all Node Transactions
      • View Transaction
      • Create Transaction
      • Create Batch Transactions
      • Cancel Transaction
      • Retry ACH Transaction
      • Dispute Chargebacks
      • Dispute Transaction
    • Subscriptions
      • Subscription Object Details
      • Webhook Object Details
      • Testing on UAT
      • View all Subscriptions
      • View Subscription
      • Create Subscription
      • Update Subscription
      • View Webhook Logs
    • Miscellaneous
      • Dummy Transactions
      • Verify Address
      • Verify Routing Number
      • International WIRE-INT Required Data by Country
      • View Billers
      • View Enriched Data
      • Loan Limits
      • Transaction Decisioning
      • 3D Secure
      • Virtual Terminal
      • Pre-Authorization
      • Card Disputes Guide
      • Mobile Wallets
      • Interchange Revenue
      • Enrichment Guide
  • Developer Guides
    • User Onboarding
      • Create User Flow
      • Authenticate as the User
      • Create Node Flow
        • Cash Advance
        • Credit Builder Loan
        • One Time Loans
        • Secured Open Loans
        • Secured Revolving Loans
        • Unsecured Revolving Loans
      • Create Subnets Flow
        • Creating Cards
        • Creating AC/RT
      • Linking External Accounts
        • Linking Cards
        • Linking External Bank Account
      • Add Additional Documents
    • Account Details
      • Displaying Balances
      • Transaction History
      • Transaction Details
      • Account Agreements
      • Node Statements
      • Card Details
    • Managing Cards
      • Card Preferences
      • Setting PIN
      • Mobile Wallet Flow
        • Integrate with Apple Pay
        • Integrate with Google Pay
        • Integrate with Samsung Pay
      • Shipping Cards
    • Originating Transactions
      • Sending Fed Wires
      • Sending ACH Transfers
      • Sending International Wires
      • Deposit a Check
      • Issuing Checks
      • Recurring Transactions
      • 3rd Party Payment Accounts
      • Cancelling Transactions
      • Exceeding Origination Limits
    • Receiving Transactions
      • Transaction Decisioning
      • Receiving ACH / Wires
      • Card Transactions
      • Exceeding Inbound Limits
    • Managing Disputes
      • ACH Disputes
      • Card Disputes
    • 3rd Party Integrations
      • Payment Integrations
      • Account Aggregators
      • 3rd Parties & Compliance
  • Recipes
    • Overdraft Protection
    • Social Banking
    • Monetizing Transactions
Powered by GitBook
On this page
  • Pre-Auth Risk
  • Automated Fuel Dispenser Transactions

Was this helpful?

Export as PDF
  1. API References
  2. Miscellaneous

Pre-Authorization

Pre-Authorizations ("pre-auths") are temporary holds that merchants place on a cardholder's funds instead of immediately debiting the cardholder. They tend to be for a higher amount than the price of the purchased product/service. Pre-auths can be inconvenient for the final user because they will be unable to spend the pre-authed funds until the pre-auth window has passed and the transaction has either settled or returned. This is often confusing for users because the transaction is not yet visible on their statements, since the transaction has not yet (technically) taken place.

For example, a user could have an initial bill of $23 for food delivery. However, the merchant issues a $30 pre-auth to account for anticipated tips. After a couple of days, the merchant settles the transaction and includes the user's $2 tip, making the final transaction amount $25.

Expected Behavior

When a pre-auth is initiated, a transaction is created with "status": "CREATED". The pre-auth amount is determined by the merchant (with the exception of Automated Fuel Dispenser Transactions, mentioned below). If the user has the funds, it will move quickly to "status": "PROCESSING-DEBIT" and then "status": "PROCESSING-CREDIT".

If the merchant does complete the transaction, the transaction will be updated with "status": "SETTLED"and "code": "pre_auth_completion".

If the merchant does not complete the transaction after 7 days, the pre-auth will drop, with "status": "RETURNED" and "code": "pre_auth_expiration".

Please keep in mind:

  • Pre-Auths will count toward a user's limits

  • We have seen online merchants make heavy use of pre-auths

Pre-Auth Risk

It is not uncommon for the final settled amount to be higher than the pre-auth amount. This is expected behavior. However, if you suspect a merchant is fraudulently inflating the settlement amount, our only real recourse is filing disputes or requesting to block the merchant altogether.

Additionally, please note that we cannot cancel a pre-auth while it is processing, so if a user creates a transaction and is later locked, you will ultimately be responsible for covering any losses.

Automated Fuel Dispenser Transactions

Automated Fuel Dispenser (AFD) transactions (aka “gas transactions") are pre-auths associated with fuel purchases at gas stations. Synapse sets the standard pre-auth amount for such transactions at $100. This temporary hold ensures the cardholder is liable for up to $100 when the pre-auth clears. If the value of the fuel dispensed was less than $100, the transaction will settle for the lower amount and the balance of the associated node should update once the pre-auth completes (i.e. with "recent_status.status": "SETTLED" and "recent_status.note": "pre_auth_completion").

PreviousVirtual TerminalNextCard Disputes Guide

Last updated 3 years ago

Was this helpful?