Skip to content
Lango Lango Docs

Going live

Test keys are yours from registration. Live keys are issued — never self-served — once your business is verified. Here is the whole path.

Verification checklist

In Dashboard → Settings, complete:

  1. Business details — legal name, trading name, address, contact.
  2. Documents — certificate of incorporation, CR14, proof of address, and a director’s ID. Reviewed by a human at Lango, usually within two business days.
  3. Bank account — where settlements go. We verify the account name matches your legal name; a name mismatch is a hard stop, not a warning. New and changed accounts have a 48-hour cooling-off before they can receive settlements.
  4. The agreement — your fee schedule and terms, accepted in the dashboard by a director.

When all four are green, Lango review flips your account to live and live keys appear in Dashboard → Developers.

Launch checks

Before pointing customers at it:

  • Live key stored in your secrets manager — never in code, config files in git, or client-side bundles.
  • Webhook endpoint deployed, signature verification on, and subscribed to at least payment.succeeded, payment.failed, payment.unresolved, settlement.paid.
  • Your unknown handling reviewed against the one page that matters.
  • Idempotency keys derived from your order ids, not generated per HTTP attempt.
  • Fee bearer configuration checked with a preview — the number your customer sees must match what they’re charged.
  • A small real payment made and refunded, end to end, by you.

Key hygiene

  • Keys are shown once at creation and stored hashed — copy them then or roll them.
  • Scope keys to what each system needs (payments:read for your reporting job, not your full key).
  • Rotate by creating the replacement first, deploying it, then revoking the old key — revocation is immediate.
  • If a key may have leaked, revoke it now and rotate; then check GET /v1/events for anything you don’t recognise.

After launch

Watch the dashboard’s home attention panel for the first days: it surfaces failing webhooks, unresolved payments, and anything needing action. Settlement advices should reconcile against your bank statement to the cent — if one doesn’t, that’s our bug: support@lango.co.zw with the advice number.