Verification
Verifications are a core concept of the Sohar platform. A Verification represents a request for eligibility status and benefits information for a given patient.
Webhooks
The Sohar service operates asynchronously, utilizing webhooks to facilitate real-time interactions. We use Svix to send webhook events; for more information please refer to their documentation.
This section provides detailed information about the webhooks triggered by specific events. Webhooks can be configured in the Sohar dashboard.
Events
Occurs whenever a production verification has been completed.
Occurs whenever a sandbox verification has been completed.
Occurs whenever a production verification has not been resolved immediately.
Occurs whenever a sandbox verification has not been resolved immediately.
Attributes
A unique identifier for the verification.
An optional identifier for the verification. This is a user-defined value that can be used when creating the verification.
Statuses
| Status | Description |
|---|---|
| complete.eligible | The verification was successfully completed; Patient is confirmed active coverage and covered for the provided taxonomy code. |
| complete.ineligible | The verification was successfully completed; Patient is either inactive and/or not covered for the provided taxonomy code. |
| error.member.id | The member ID was not recognized by the payer, or a different payer ID should be used. |
| error.member.dob | The patient’s date of birth was not recognized by the payer, or a different payer ID should be used. |
| error.member.name | The patient’s name was not recognized by the payer, or a different payer ID should be used. This is often due to incorrect spelling or nicknames. |
| error.payer | The payer has been unavailable for over 24 hours and the Sohar Operations team have been unable to resolve the verification via payer portal or phone call. |
| error.payer.npi | The provided NPI is not recognized by the payer. Some payers require an NPI on file in order to provide benefits. Some payers require a rendering NPI in order to provide benefits, for example Blue Cross Blue Shield of Texas. |
| pending | The verification could not be resolved immediately, typically because the payer API was unavailable. A verification with this status will be followed by one of the statuses listed above. |
Sandbox Values
Use the following payerId and memberId values in the sandbox environment for pre-defined responses.
| Payer ID | Member ID | Status |
|---|---|---|
| 60054 | 00000000 | complete.eligible |
| 60054 | 00000001 | complete.ineligible |
| 60054 | 10000000 | error.member.id |
| 60054 | 10000001 | error.member.dob |
| 60054 | 10000002 | error.member.name |
| OSCAR | error.payer.npi | |
| 06111 | pending |