Skip to main content

Sandbox

Before runs no separate sandbox environment. A bk_test_ key, against the same https://api.before.com, opens practice sales: the real wizard, products and prices, marked as practice and never sent to a carrier.

Live key (bk_live_)Test key (bk_test_)
SaleRealPractice, hidden from the funeral home's normal lists
WizardUnmarkedShows a Practice pill
DocumentsSent for signatureWatermarked PRACTICE and signed at once, with no email or text to the family
CarrierSubmittedNever submitted
mode in responses and webhookslivetest
WebhooksAll four eventssale.signed only

Practise the whole flow​

  1. Open a session with a test key and a new partner_reference.
  2. Call Before.open with the token and complete the wizard.
  3. Send the documents for signature. A practice sale is signed straight away, so onComplete fires with out_for_signature or signed.
  4. Receive sale.signed with "mode": "test" and verify its signature.
  5. Read the sale with GET /v1/partner/sales/:id.

sale.submitted, policy.issued and sale.declined never fire for practice sales. Exercise those handlers with a recorded event signed with your own endpoint secret; the signature is all your code needs to trust.

Create test and live keys in the Before Partner Portal.

Keep modes apart​

  • A test key reads only practice sales, and a live key only real ones.
  • A partner_reference belongs to the mode that first used it. Use distinct references in testing, such as a test- prefix.
  • One endpoint receives both modes; branch on data.mode.