GrailPay home page
stable
Search...
⌘K
Ask AI
Contact
Contact
Search...
Navigation
Getting Started
Transaction Scenarios - Direct Payouts
Home
Business Guides
ACH Technical Guides
Risk Intelligence
Releases
Blog
Getting Started
Overview
Authentication
Idempotency
Sandbox
Transactions Overview
Transaction Scenarios - Direct Payouts
Transaction Scenarios - Batch Payout
Users
Onboard a Person
Onboarding a Business
Deleting a User
Get All Users
Get User
Update KYB
Transactions
Cancel a Transaction
Create a Transaction
Fetch a Transaction
Get All Transactions
Payouts
Get Business Batch Payout
Get Batch Merchant Payout
Get Batch Person Payout
Get Batch Processor Payout
List Business Batch Payouts
List Merchant Batch Payouts
List Person Batch Payouts
List Processor Batch Payouts
Refunds
Refund a Transaction
Get Batch Refund
Get All Batch Refunds
Get Refund Details
Get Transaction Refunds
Bank Accounts
Account Transaction History
Add Bank Account
Delete Bank Account
Fetch Bank Account
Get Account Balance
Get All Bank Accounts
Get User by Bank Account
Set Default Account
Validate Account & Routing Number
Webhooks
Webhook Events
Register a Webhook
De-register Webhook
Get All Webhook Events
Billing
Get Merchant Billing Summary
Bank Link SDK
Overview
On this page
Successful Transaction
States
Flow of Funds
History
Cancelled Transaction Before Capture
States
Flow of Funds
History
Transaction Failed: NSF on Capture
States
Flow of Funds
History
Transaction Failed: NSF After Capture Before Payout
States
Flow of Funds
History
Transaction Failed: NSF After Payout
States
Flow of Funds
History
Chargeback
States
Flow of Funds
History
Refund
States
Flow of Funds
History
Payout Failed
States
Flow of Funds
History
Getting Started
Transaction Scenarios - Direct Payouts
A description of the different transaction scenarios that can occur when using direct payouts.
Successful Transaction
States
Flow of Funds
History
Transaction started.
Capture from payor completed.
Payout to payee completed.
Transaction completed.
Cancelled Transaction Before Capture
This when a transaction is cancelled. Currently they can only be cancelled in the CAPTURE_PENDING state.
States
Flow of Funds
History
Transaction started.
Transaction cancelled.
Transaction completed.
Transaction Failed: NSF on Capture
This happens when the payor does not have enough funds available.
States
Flow of Funds
History
Transaction started.
Capture from payor failed.
Transaction completed.
Transaction Failed: NSF After Capture Before Payout
This happens when the bank allows the capture to happen then signals an NSF before the payout is completed.
States
Flow of Funds
History
Transaction started.
Capture from payor completed.
NSF signaled from bank.
Transaction completed.
Transaction Failed: NSF After Payout
This happens when the bank signals an NSF after the payout has completed.
States
Flow of Funds
History
Transaction started.
Capture from payor completed.
Payout to payee completed.
NSF signaled from bank.
Clawback from payee completed.
Transaction completed.
Chargeback
This happens when the payor notifies the bank that they did not authorize the charge.
States
Flow of Funds
History
Transaction started.
Capture from payor completed.
Payout to payee completed.
Payor initiates chargeback.
Funds returned to payor.
Clawback from payee completed.
Transaction completed.
Refund
This happens when the payee issues a refund.
States
Flow of Funds
History
Transaction started.
Capture from payor completed.
Payout to payee completed.
Payee initiates refund.
Clawback from payee completed.
Funds returned to payor.
Transaction completed.
Payout Failed
This happens when the credit to the payee fails, typically because of an incorrect account/routing number.
States
Flow of Funds
History
Transaction started.
Capture from payor completed.
Payout to payee failed.
Funds returned to payor.
Transaction completed.
Transactions Overview
Transaction Scenarios - Batch Payout
Assistant
Responses are generated using AI and may contain mistakes.