Availity
Availity is how an authorization request actually reaches a payer. The trading relationship is yours, and we submit under it, so the payer sees your organisation rather than ours.
#Before you start
- An Availity account for your organisation, with an administrator who can create a developer application.
- A subscription that covers the transactions we send. The default scope is
healthcare-hipaa-transactions, which covers both Service Reviews (the authorization itself) and Coverages (the eligibility check that decides whether an authorization is even needed). - About fifteen minutes.
#Steps
- Create a developer application in AvailityIn your Availity developer portal, register an application. Availity issues a client id and a client secret for it.
- Copy the client id and secretThe secret is shown once by Availity. If you lose it, regenerate it there rather than guessing.
- Open Settings, then ConnectionsChoose Availity and paste the client id and the client secret.
- Add a customer id only if you were given oneSome organisation structures require it; most do not. Leave it blank unless Availity told you otherwise.
- SaveWe request a token with those exact values. If Availity refuses them, nothing is stored and the reason is shown.
#What we ask for
| Field | Required | Stored as |
|---|---|---|
| Client ID | yes | readable |
| Client secret | yes | encrypted, never displayed again |
| Scope | no | readable, defaults to healthcare-hipaa-transactions |
| Customer ID | no | readable |
#When it does not work
Availity refused these credentials- The client id or the secret is wrong, or the application was deleted in the Availity portal. Nothing was stored, so simply correct and save again.
Authorizations submit but eligibility does not- Your subscription probably covers Service Reviews but not Coverages. They ride the same product, so this is a subscription question for Availity rather than a settings change here.
It worked and then stopped- Secrets in the Availity portal can be rotated or expired by your own administrator. Re-validate the connection from Settings; if it fails, issue a new secret in Availity and paste it here.
Treat a client secret like a password
Anyone holding it can transact under your organisation at the payer. Paste it directly into Settings rather than sending it by email or chat, and rotate it in the Availity portal if it has ever been shared.
#Connecting is not the same as going live
Saving a valid credential proves the connection works. It does not start sending real transactions to payers. Moving your practice onto the live rail is a separate, deliberate change with its own audit trail, and it happens once you are ready and the trading partner agreement is in place.
- ConnectedYour credentials are stored and proven. Authorizations are still produced against a simulator, so you can walk the whole workflow without anything reaching a payer.
- LiveYour practice is switched to the live clearinghouse. From that point every request carries your own credentials and reaches Availity under your organisation.
Your traffic is yours
Once live, every token is minted from your client id and your secret. Two practices on this platform never share a clearinghouse identity, so the payer's record of who submitted always names the practice that actually did.