UnifyStays is now generally available. Every supplier and every feature, free until 1 November.See pricing →
Supplier credential guide

Bring Your Own Hotel Supplier Credentials: Architecture and Setup

3 min readUpdated

Short answer

Bring-your-own-supplier-credentials means the travel company connects an authorized supplier account it owns to a shared API layer. The platform encrypts the credentials, scopes them to the organization and environment, uses them only for that customer’s supplier requests and verifies operational requirements before marking the connection ready.

  1. Your accountYour contract and rates
  2. EncryptedStored server-side
  3. ScopedPer organization and environment
  4. One APIUsed only for you
Your supplier account, connected safely

Why use customer-owned credentials

Customer-owned credentials preserve the direct supplier relationship and its commercial terms while removing supplier-specific integration code from the customer application.

A connection has several readiness layers

Credential presence is necessary but not sufficient.

  • Supplier account and contract approved
  • Correct sandbox or production credentials
  • Credentials encrypted and stored
  • Outbound IPs allowlisted when required
  • Supplier-side access activated
  • A real request verified

Encryption and trust boundaries

The encryption key should remain outside the database. Encrypted credentials must be bound to the owning organization, connection and environment so copied ciphertext cannot be reused in another context.

Troubleshooting authentication failures

A provider rejection can mean a bad key, wrong environment, missing IP allowlisting, unapproved production access or a wrong endpoint. Test those boundaries separately before changing application validation logic.

Questions

Can supplier credentials be exposed to frontend code?

No. Supplier secrets should remain server-side and should never be embedded in browser bundles or public repositories.

Why can a correct key still fail?

The key may belong to another environment, require supplier-side activation or be restricted to allowlisted outbound IPs.

Does connected status prove the credentials work?

No. Readiness should require credential presence and a verified provider workflow, not only a metadata status.

Sources

Skip building the hotel supply layer.

Connect your supplier accounts to one API — content, mapping and booking safeguards included.