Home
Release Notes
Home
Release Notes
Linkedin
  1. APIs
  • Balad™ Gateway Documentation 📖
  • Get Started
  • Authorization
  • Responses
  • Go Live!
  • FAQs
  • APIs
    • Authentication
      • Token
    • Core
      • Exchange rate
        • Exchange Rates
      • Balance
        • Get Current Balance
      • Secrets
        • Generate Secret
        • Delete Secret
        • Get Secrets
    • Link
      • Sandbox Testing Guide
      • Error Codes
      • Transaction Lifecycle V2
      • Lookups
        • Purposes List
        • Sources List
        • Banks List
        • Relations
      • Transactions
        • Create transaction
        • Update transaction
        • Cancel transaction
        • Get transaction status V2
        • Transactions List
        • Export Transactions List
        • Calculate receiving amount
        • Validate Account
      • Reconciliation
        • Reconciliation
  • Webhooks
    • Link.Transaction.StatusUpdateV2
  1. APIs

Link

Link overview#

Link is Balad’s remittance orchestration layer: it centralizes quoting, transfer creation, tracking, and reconciliation across payout rails (bank, wallet, card, cash) without you having to integrate multiple local partners.
Transaction lifecycle
Create transfers, update/cancel when eligible, poll status, and deliver reliable timelines.
Webhooks & reconciliation
Process event-driven updates and reconcile your ledger with Balad’s transfer states.
Lookups & eligibility
Validate corridors, payout methods, and required fields early to reduce bounce/fail rates.
Transactions & reporting
Retrieve transaction details and run reconciliation/audit checks.

What’s in this folder#

Transaction Lifecycle V2 (recommended)
Lookups (4)
Transactions (11)
Reconciliation (1)
Error Codes + Sandbox Testing Guide
Legacy/deprecated: Transaction Lifecycle V1 + old Error Codes
TIP
Use idempotency keys on create/funding calls to prevent duplicate transfers during retries/timeouts.
Integrator responsibilities
Provide and validate required compliance fields early
Implement retry/backoff and webhook signature verification with replay protection
Monitor failures/returns and support end-user resolution workflows
Previous
Get Secrets
Next
Sandbox Testing Guide
Built with