Sandbox Environment
Your sandbox mirrors production behavior including payment routing logic, OFAC screening, account verification services, and webhook delivery. Sandbox credentials and velocity limits are provisioned during onboarding.Sandbox velocity limits are client-specific and configured by your Ingo integration manager during onboarding.
Test Categories
Understanding Soft Failures
Ingo uses two distinct failure modes across verification and authentication services: Soft failure — A partial match that does not stop the flow. The recipient experiences no interruption and proceeds transparently. Your system is notified of the result in the background via the correlated success webhook carrying the soft-fail status code. No failure webhook emits for a soft failure. Hard failure — A mismatch on a field your configuration has designated as requiring a hard failure. How each verification field’s mismatch is treated is defined during your implementation setup via the configuration form. When a hard failure occurs, the recipient is stopped and must retry. If maximum attempts are exhausted, the session or transaction terminates.A Note on Multi-Party Testing
Notify Managed Parties flows are scenario-driven, not scripted. Party roles, approval decisions, authentication outcomes, and disbursement selections are all made through live recipient and approver interactions. Because the orchestration responds dynamically to those interactions, testing is structured around intended outcomes rather than prescriptive step sequences. The verification mechanism for every scenario is the webhook event sequence — you know a scenario completed correctly when the expected events fire in the correct order.Self-Service Scenarios
Notify API — Staging & Lifecycle
Notify API — Staging & Lifecycle
Successful Notification Delivery
Category: Self-ServiceScenario: Stage a transaction via the Notify API. The recipient receives the notification email and it is delivered successfully.Success criteria: Notification delivered without bounceKey webhook sequence to verify:
Notification Reminder
Category: Self-ServiceScenario: Stage a transaction. Receive the initial notification. Allow the reminder notification to fire without completing the disbursement.Success criteria: Both sent and reminder events receivedKey webhook sequence to verify:
Notification Bounce
Category: Self-ServiceScenario: Stage a transaction using an invalid email address. Confirms your system handles undeliverable notification events.Success criteria: Bounce event receivedKey webhook sequence to verify:
Idempotent Notify Request
Category: Self-ServiceScenario: Resubmit an identical Notify API request using the same
participant_unique_id1. Confirms duplicate protection is working correctly.Success criteria: Response status: 101 — no new transaction createdCancel — Successful
Category: Self-ServiceScenario: Stage a transaction. Submit a Notify Cancel request before the recipient completes the flow. Confirms cancellation before disbursement selection.Success criteria: Cancellation confirmed, disbursement request canceled event firesKey webhook sequence to verify:
Cancel — Failure Conditions
Category: Self-ServiceScenario: Attempt to cancel a transaction in a state that does not permit cancellation — already completed, already canceled, already expired, or invalid notification ID. Confirms your system handles cancel error responses gracefully.Success criteria: Appropriate error status returned for each invalid state
Recipient Authentication & RVDM
Recipient Authentication & RVDM
Authentication — Success
Category: Self-ServiceScenario: Stage a transaction. Open the notification and complete the authentication challenge with fully matching data. Recipient proceeds to disbursement selection.Success criteria: Authentication success event fires, flow continues to account selectionKey webhook sequence to verify:
Authentication — Soft Failure
Category: Self-ServiceScenario: Stage a transaction. Open the notification and enter partially matching authentication data. The recipient experiences no interruption and proceeds transparently. Your system is notified of the partial match in the background via the authentication success webhook carrying the soft-fail status code.Success criteria: Authentication success fires with soft-fail status code; recipient proceeds uninterruptedKey webhook sequence to verify:
Authentication — Hard Failure & Termination
Category: Self-ServiceScenario: Stage a transaction. Open the notification and provide non-matching authentication data until maximum attempts are reached. The recipient is stopped at each failure and may retry. After exhausting all attempts, the transaction terminates.Success criteria: Failure event fires, transaction terminatesKey webhook sequence to verify:
RVDM — Success
Category: Self-ServiceScenario: Stage a transaction with RVDM enabled. Complete authentication. Provide recipient information that fully matches the session data.Success criteria: RVDM success event fires, flow continues to account selectionKey webhook sequence to verify:
RVDM — Soft Failure
Category: Self-ServiceScenario: Stage a transaction with RVDM enabled. Provide partially matching recipient data. The recipient experiences no interruption and proceeds transparently. Your system is notified of the partial match in the background via the RVDM success webhook carrying the soft-fail status code.Success criteria: RVDM success fires with soft-fail status code; recipient proceeds to account selection uninterruptedKey webhook sequence to verify:
RVDM — Hard Failure & Termination
Category: Self-ServiceScenario: Stage a transaction with RVDM enabled. Provide non-matching recipient data until maximum attempts are exhausted. The recipient is stopped at each failure and may retry. After exhausting all attempts, the transaction terminates.Success criteria: RVDM failure event fires, transaction terminatesKey webhook sequence to verify:
Payment Scenarios — Card
Payment Scenarios — Card
Card — Successful Disbursement
Category: Self-ServiceScenario: Stage a transaction. Complete the flow through authentication and RVDM. Select card disbursement and tokenize a valid test card. Payment processes successfully.Success criteria: Tokenization and payment success events fireKey webhook sequence to verify:
Card — Repeat Recipient
Category: Self-ServiceScenario: Stage a second transaction for a recipient with a previously tokenized card. Complete the flow using the existing token without re-entering card details.Success criteria: Payment completes using stored token, no re-tokenization required
Card — Account Not Available
Category: Self-ServiceScenario: Stage a transaction. Enter a card account number not supported for disbursement. The recipient is stopped and must use a different account. Your system is notified via the CNS/CD failure webhook.Success criteria: CNS/CD failure event firesKey webhook sequence to verify:
Payment Scenarios — ACH
Payment Scenarios — ACH
ACH — Successful Disbursement
Category: Self-ServiceScenario: Stage a transaction. Complete authentication and RVDM. Select ACH disbursement and enter a valid test routing and account number. Payment processes successfully.Success criteria: Tokenization and payment success events fireKey webhook sequence to verify:
ACH — Repeat Recipient
Category: Self-ServiceScenario: Stage a second ACH transaction for a recipient with a previously registered account. Completes using the existing token.Success criteria: Payment completes using stored token
Payment Scenarios — PayPal
Payment Scenarios — PayPal
PayPal — Successful Disbursement
Category: Self-ServiceScenario: Stage a transaction. Complete authentication and select PayPal as the disbursement method. In the PayPal flow, PayPal Account Verification (AV) runs in place of RVDM. The AV success webhook notifies your system of the verification result in the background. The recipient experiences no interruption — the account is tokenized and payment processes successfully.Success criteria: PayPal AV success, tokenization success, and payment success all fire in sequenceKey webhook sequence to verify:
PayPal — Repeat Recipient
Category: Self-ServiceScenario: Stage a second PayPal transaction for a recipient with a previously registered PayPal account. Completes using the existing token.Success criteria: Payment completes using stored token
Payment Scenarios — Check
Payment Scenarios — Check
Check — Recipient-Elected (Client Issuance)
Category: Self-ServiceScenario: Stage a transaction. Complete the flow and have the recipient elect check as their disbursement method. Client issues the check.Success criteria: Check in process event fires confirming the recipient elected checkKey webhook sequence to verify:
Check — Address Not Confirmed
Category: Self-ServiceScenario: Stage a check transaction. Recipient selects check but does not confirm the address on file.Success criteria: Check in process event fires with address-not-confirmed status codeKey webhook sequence to verify:
Check — Notification Expiration (Client Issuance)
Category: Self-ServiceScenario: Stage a Client Issuance check transaction. Allow the notification to expire without recipient action. The disbursement request expires and the transaction terminates.Success criteria: Expired event fires; transaction terminatesKey webhook sequence to verify:
Check — Notification Expiration (Ingo Issuance)
Category: Self-ServiceScenario: Stage an Ingo Issuance check transaction. Allow the notification to expire without recipient action. Ingo defaults to issuing the check — the payment succeeds and the check is issued and subsequently paid.Success criteria: Payment success fires, followed by check issued and check paid eventsKey webhook sequence to verify:
Check — Ingo Issuance
Category: Self-ServiceScenario: Stage a transaction configured for Ingo check issuance. Complete the full flow. Ingo issues the check and it is subsequently paid.Success criteria: Payment success, check issued, and check paid events all fireKey webhook sequence to verify:
Recipient Cancel
Recipient Cancel
Recipient-Initiated Cancellation
Category: Self-ServiceScenario: Stage a transaction. Open the notification, complete authentication, and have the recipient elect to cancel the disbursement from within the iFrame. Confirms your system handles recipient-initiated cancellation correctly.Success criteria: Recipient cancel event fires, transaction terminatesKey webhook sequence to verify:
Controlled Scenarios
Card — AVS & CVV Risk Management
Card — AVS & CVV Risk Management
AVS Soft Fail
Category: ControlledScenario: A card account tokenization where the AVS check returns a soft failure. The recipient experiences no interruption and proceeds transparently. Your system is notified of the partial address match in the background via the tokenization success webhook carrying the soft-fail status code.Success criteria: Tokenization success fires with AVS soft-fail status code; payment completesKey webhook sequence to verify:
AVS Decline
Category: ControlledScenario: A card account tokenization where the AVS check returns a hard decline. The recipient is stopped and must use a different account. Your system is notified via the AVS/CVV failure webhook.Success criteria: AVS/CVV failure event fires; account rejectedKey webhook sequence to verify:
AVS/CVV Max Attempts — Termination
Category: ControlledScenario: AVS or CVV hard failures repeat until the maximum attempt threshold is reached. The recipient is stopped at each failure and may retry. After exhausting all attempts, the transaction terminates.Success criteria: Termination event fires after max attemptsKey webhook sequence to verify:
ACH — GIACT Account Verification
ACH — GIACT Account Verification
ANV / NAV Soft Fail
Category: ControlledScenario: An ACH account verification returns a soft failure on account number validation (ANV) or name/address validation (NAV). The recipient experiences no interruption — the flow continues transparently. Your system is notified of the partial match result in the background via the tokenization success webhook carrying the soft-fail status code.Success criteria: Tokenization success fires with soft-fail status code; payment completesKey webhook sequence to verify:
RNV / ANV / NAV Hard Decline
Category: ControlledScenario: ACH account verification returns a hard decline on routing number (RNV), account number (ANV), or name/address (NAV) validation. The recipient is stopped and must use a different account. Your system is notified via the appropriate failure webhook.Success criteria: Applicable failure event fires; account rejectedKey webhook sequence to verify:
ACH — Max Attempts Termination
Category: ControlledScenario: ACH verification hard failures repeat until maximum attempts are exhausted. The recipient is stopped at each failure and may retry. After exhausting all attempts, the transaction terminates.Success criteria: Termination event fires after max attemptsKey webhook sequence to verify:
PayPal — Account Verification
PayPal — Account Verification
PayPal AV — Soft Fail
Category: ControlledScenario: PayPal account verification returns a partial match. The recipient experiences no interruption and proceeds transparently. Your system is notified of the partial match in the background via the PayPal AV success webhook carrying the soft-fail status code. The account is tokenized and payment completes.Success criteria: PayPal AV success fires with soft-fail status code; tokenization and payment success followKey webhook sequence to verify:
PayPal AV — Hard Fail & Max Attempts Termination
Category: ControlledScenario: PayPal account verification returns a hard failure. The recipient is stopped and must retry. If maximum attempts are reached, the transaction terminates. Your system is notified via the PayPal AV failure webhook.Success criteria: PayPal AV failure event fires; termination event fires after max attemptsKey webhook sequence to verify:
OFAC Screening
OFAC Screening
OFAC Suspended — Cleared (Payment Success)
Category: ControlledScenario: A staged transaction triggers an OFAC hit during the disbursement flow. The payment is suspended. After OFAC review, the transaction is cleared and payment completes.Success criteria: Suspended and cleared events both fire; payment ultimately succeedsKey webhook sequence to verify:
OFAC Suspended — Cleared (Payment Declined)
Category: ControlledScenario: An OFAC suspension is reviewed and the transaction is cleared, but the payment is subsequently declined by the network.Success criteria: Suspended and cleared events fire; payment terminates after clearanceKey webhook sequence to verify:
OFAC Failure — Transaction Terminated
Category: ControlledScenario: An OFAC suspension is reviewed and confirmed. The transaction is terminated.Success criteria: Suspended and failure events fire; transaction terminatesKey webhook sequence to verify:
Guided Scenarios
Multi-Party Approval Flows
Multi-Party Approval Flows
Multi-party flows are scenario-driven by design. Party roles, approval decisions, and notification configurations interact dynamically based on your implementation setup. The key outcomes to validate during guided sessions:
Returned & Refunded Payments
Returned & Refunded Payments
Returned Payment
Category: GuidedScenario: A previously completed payment is returned by the account issuer. Confirms your system correctly handles the returned status and updates your records.Success criteria: Returned event received and processed correctlyKey webhook sequence to verify:
Webhook Events Reference
Notification Events
Notification Events
Authentication & Verification Events
Authentication & Verification Events
Account Verification Events
Account Verification Events
Approvals & Multi-Party Events
Approvals & Multi-Party Events
Payment Status Events
Payment Status Events