Skip to main content
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

  1. Create the order with suppress_user_notifications: true while the user is in your app
  2. When the user leaves without finishing, update the order to enable notifications
  3. Truv sends email and SMS reminders on your behalf
  4. 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

FieldTypeDefaultDescription
suppress_user_notificationsbooleanfalseSuppress all Truv email/SMS notifications for this order
first_notification_delay_hoursinteger0Hours to delay the first notification after enabling

​
Reminders

Truv automatically sends an initial notification and up to three reminders via email and/or SMS. 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 ExpirationOrder LifespanInitial NotificationReminders
1 day24 hours + weekends30 seconds1st: 6 hours
2nd: 16 hours
3rd: 22 hours
2 days48 hours + weekends30 seconds1st: 6 hours
2nd: 24 hours
3 days72 hours + weekends30 seconds1st: 24 hours
2nd: 48 hours
3rd: 66 hours
1 week168 hours + weekends30 seconds1st: 24 hours
2nd: 72 hours
3rd: 120 hours
2 weeks336 hours + weekends30 seconds1st: 96 hours
2nd: 192 hours
3rd: 288 hours
3 weeks504 hours + weekends30 seconds1st: 264 hours
2nd: 384 hours
3rd: 456 hours
4 weeks672 hours + weekends30 seconds1st: 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