Skip to main content
TLDP uses Bearer authentication. Send your API key in the Authorization header on every request:

Key types

Your key encodes both your permissions and your environment.
Never expose a secret key in a browser, mobile app, or any client a user can inspect. If a secret key leaks, roll it immediately.

Test vs live

The middle segment of the key (test or live) selects the environment:
  • Test (…_test_…) runs entirely in sandbox — data is isolated, no money moves, and webhook events are marked livemode: false. Build and verify your integration here.
  • Live (…_live_…) is production. Money moves and events are livemode: true.
Every response includes a header confirming which environment your key resolved to, so you can assert you’re calling the right one.

Example