external — Boundary Docs

External third-party service adapters following the FC/IS pattern. Three active adapters: SMTP, IMAP, and Twilio.

Note	Stripe payments have moved to payments library.

Key namespaces

boundary.external.schema              — Malli schemas for all four adapters
boundary.external.ports               — Protocols: ISmtpProvider, IImapMailbox,
                                        IStripePayments, IStripeWebhooks, ITwilioMessaging
boundary.external.core.smtp           — Pure SMTP helpers
boundary.external.core.imap           — Pure IMAP helpers
boundary.external.core.stripe         — Pure Stripe helpers (build params, verify signatures)
boundary.external.core.twilio         — Pure Twilio helpers (build SMS/WhatsApp params)
boundary.external.shell.adapters.smtp — SmtpProviderAdapter (javax.mail)
boundary.external.shell.adapters.imap — ImapMailboxAdapter (javax.mail, UIDFolder)
boundary.external.shell.adapters.stripe  — StripeAdapter (clj-http, form-encoded POSTs)
boundary.external.shell.adapters.twilio  — TwilioAdapter (clj-http, Basic auth)

Enabling adapters

All four adapters ship as :inactive in config.edn. Move to :active to enable:

;; In :active section of resources/conf/dev/config.edn

:boundary.external/stripe
{:api-key        #env STRIPE_API_KEY
 :webhook-secret #env STRIPE_WEBHOOK_SECRET
 :api-version    "2024-04-10"}

:boundary.external/twilio
{:account-sid #env TWILIO_ACCOUNT_SID
 :auth-token  #env TWILIO_AUTH_TOKEN
 :from-number #env TWILIO_FROM_NUMBER}

:boundary.external/smtp
{:host     #env SMTP_HOST
 :port     587
 :username #env SMTP_USERNAME
 :password #env SMTP_PASSWORD
 :tls?     true}

:boundary.external/imap
{:host     #env IMAP_HOST
 :port     993
 :username #env IMAP_USERNAME
 :password #env IMAP_PASSWORD
 :ssl?     true}

Stripe payments

(require '[boundary.external.ports :as ports])

;; Create payment intent
(ports/create-payment-intent stripe
  {:amount 2999 :currency "eur" :customer-id "cus_123"})

;; Verify webhook signature
(ports/verify-webhook-signature stripe raw-body signature #env STRIPE_WEBHOOK_SECRET)

Twilio SMS / WhatsApp

;; Send SMS
(ports/send-sms twilio {:to "+31612345678" :body "Your code: 123456"})

;; Send WhatsApp
(ports/send-whatsapp twilio {:to "+31612345678" :body "Your order has shipped!"})

Testing

clojure -M:test:db/h2 :external