Follow-up - Truv

When a user leaves your application without finishing verification, Truv can automatically send email and SMS reminders to bring them back. Toggle notifications on and off using the order’s notification_settings. Truv handles the messaging.

How it works

Create the order with suppress_user_notifications: true while the user is in your app
When the user leaves without finishing, update the order to enable notifications
Truv sends email and SMS reminders on your behalf
When the user returns and completes verification, you receive a webhook

Suppress notifications while user is in-app

While the user is active in your application, suppress Truv notifications. Your app controls the experience.

curl --request POST \
     --url https://prod.truv.com/v1/orders/ \
     --header 'X-Access-Client-Id: YOUR_TRUV_CLIENT_ID' \
     --header 'X-Access-Secret: YOUR_TRUV_CLIENT_SECRET' \
     --header 'Content-Type: application/json' \
     --data '{
  "products": ["income"],
  "first_name": "John",
  "last_name": "Doe",
  "email": "john@example.com",
  "phone": "4155554193",
  "notification_settings": {
    "suppress_user_notifications": true
  }
}'

Enable notifications when user leaves

When the user leaves your app without completing verification, update the order to turn on notifications. Truv takes over and sends email/SMS reminders to bring them back.

curl --request PATCH \
     --url https://prod.truv.com/v1/orders/39aa1486ccca4bc19cda071ffc1ba392/ \
     --header 'X-Access-Client-Id: YOUR_TRUV_CLIENT_ID' \
     --header 'X-Access-Secret: YOUR_TRUV_CLIENT_SECRET' \
     --header 'Content-Type: application/json' \
     --data '{
  "notification_settings": {
    "suppress_user_notifications": false
  }
}'

You can also delay the first notification instead of sending it immediately.

curl --request PATCH \
     --url https://prod.truv.com/v1/orders/39aa1486ccca4bc19cda071ffc1ba392/ \
     --header 'X-Access-Client-Id: YOUR_TRUV_CLIENT_ID' \
     --header 'X-Access-Secret: YOUR_TRUV_CLIENT_SECRET' \
     --header 'Content-Type: application/json' \
     --data '{
  "notification_settings": {
    "suppress_user_notifications": false,
    "first_notification_delay_hours": 24
  }
}'

Configure notifications

Field	Type	Default	Description
`suppress_user_notifications`	boolean	`false`	Suppress all Truv email/SMS notifications for this order
`first_notification_delay_hours`	integer	`0`	Hours to delay the first notification after enabling

Reminders

Truv automatically sends an initial notification and up to three reminders via email and/or SMS. Each reminder includes the original order link. Reminders are distributed evenly from order creation until expiration. Once an order reaches a terminal status (completed, canceled, expired), reminders stop.

SMS reminders require account-level enablement. Contact support@truv.com to activate. SMS reminders are only sent between 10am–6pm ET.

Link Expiration	Order Lifespan	Initial Notification	Reminders
1 day	24 hours + weekends	30 seconds	1st: 6 hours 2nd: 16 hours 3rd: 22 hours
2 days	48 hours + weekends	30 seconds	1st: 6 hours 2nd: 24 hours
3 days	72 hours + weekends	30 seconds	1st: 24 hours 2nd: 48 hours 3rd: 66 hours
1 week	168 hours + weekends	30 seconds	1st: 24 hours 2nd: 72 hours 3rd: 120 hours
2 weeks	336 hours + weekends	30 seconds	1st: 96 hours 2nd: 192 hours 3rd: 288 hours
3 weeks	504 hours + weekends	30 seconds	1st: 264 hours 2nd: 384 hours 3rd: 456 hours
4 weeks	672 hours + weekends	30 seconds	1st: 312 hours 2nd: 432 hours 3rd: 624 hours

Order expiration periods exclude weekends, but reminders continue being sent during weekends. Customize expiration times and reminder schedules in the Truv Dashboard.

Combining email and SMS improves completion rates. High-intent borrowers complete over 50% of verifications within 2 hours.

Next steps

Data Refresh

Pull updated data without user re-authentication

Self-Certification

Let users review and confirm retrieved data

Webhooks

Receive notifications when order status changes

​How it works

​Suppress notifications while user is in-app

​Enable notifications when user leaves

​Configure notifications

​Reminders

​Next steps

Data Refresh

Self-Certification

Webhooks

How it works

Suppress notifications while user is in-app

Enable notifications when user leaves

Configure notifications

Reminders

Next steps