Manza Ruby SDK

gem "manza"

require "manza"

manza = Manza.new(api_key: ENV["MANZA_API_KEY"])
# Or with explicit base URL (defaults to https://ma.manza.finance, Morocco):
manza = Manza.new(api_key: ENV["MANZA_API_KEY"], base_url: "https://za.manza.finance")

entity = manza.entity.get
# => #<Manza::Response status=200 ...>
entity.body["name"]
# => "Acme Corp"

manza.entity.get

manza.accounts.list(currency_code: "MAD", limit: 50)
manza.accounts.get("019dde7d-...")
manza.accounts.list_transactions("019dde7d-...", operation: "credit")
manza.accounts.get_transaction("019dde7d-...", "01a0e1...")

manza.customers.list(q: "acme")
manza.customers.get("01a0...")
manza.customers.create(
  customer_type: "business",
  company_name: "Acme Corp",
  email: "billing@acme.com",
  ice_number: "000000000000000"
)
manza.customers.update("01a0...", email: "new@example.com")
manza.customers.delete("01a0...")

manza.invoices.list(status: "sent", limit: 50)
manza.invoices.create(
  customer_id: "01a0...",
  currency_code: "MAD",
  issue_date: "2026-05-03",
  due_date: "2026-06-03",
  items: [{ description: "Consulting", quantity: 10, unit_price: "150.00" }]
)
manza.invoices.send_invoice("01a0...")
manza.invoices.mark_as_paid("01a0...")
manza.invoices.cancel("01a0...")
manza.invoices.credit_note("01a0...")
manza.invoices.create_payment_link("01a0...", account_id: "019dde7d-...")

manza.payment_links.list(status: "active")
manza.payment_links.create(
  account_id: "019dde7d-...",
  amount: "1500.00",
  description: "March consulting",
  link_type: "single"
)
manza.payment_links.cancel("01a0...")

manza.checkout_sessions.create(
  account_id: "019dde7d-...",
  amount: "1500.00",
  success_url: "https://merchant.example.com/success?session_id={CHECKOUT_SESSION_ID}",
  cancel_url: "https://merchant.example.com/cancel",
  customer_email: "buyer@example.com",
  metadata: { order_id: "ORD-123" }
)
manza.checkout_sessions.get("cs_...")

manza.beneficiaries.list
manza.beneficiaries.create(beneficiary_type: "business", company_name: "Acme Supplies", email: "ap@acme.com")
manza.beneficiaries.list_external_accounts("01a0...")
manza.beneficiaries.get_external_account("01a0...", "01a1...")
manza.beneficiaries.create_external_account("01a0...", account_number: "007780...", name: "Main account")

manza.payee_trust_requests.create(external_account_ids: ["01a1..."])
manza.payee_trust_requests.get("01a2...")

manza.transfer_drafts.create(
  account_id: "019dde7d-...",
  beneficiary_id: "01a0...",
  amount: "2500.00",
  client_reference: "po_1042" # unique per entity; a duplicate raises Manza::ConflictError
)
manza.transfer_drafts.get("01a3...")
manza.transfer_drafts.decline("01a3...", authorization_id: "01a4...", reason: "Not ours")

manza.webhook_endpoints.list
manza.webhook_endpoints.create(
  url: "https://example.com/webhooks/manza",
  events: ["invoice.sent", "payment_link.paid"]
)
manza.webhook_endpoints.test_endpoint("01a0...")
manza.webhook_endpoints.regenerate_secret("01a0...")
manza.webhook_endpoints.enable("01a0...")
manza.webhook_endpoints.disable("01a0...")

input = Manza::TransferAuthorization.signature_input(
  payment_id: draft["id"],
  nonce: webhook["data"]["authorization"]["nonce"],
  amount: draft["amount"],               # the API's decimal string, e.g. "2500.0"
  currency_code: draft["currency_code"],
  account_id: draft["account_id"],
  payee: Manza::TransferAuthorization.payee_for(external_account_id: draft["external_account_id"]),
  client_reference: draft["client_reference"]
)
signature = Manza::TransferAuthorization.sign(secret: signing_secret, signature_input: input)

authorizer = Manza.new(api_key: ENV["MANZA_AUTHORIZER_API_KEY"])
authorizer.transfer_drafts.authorize(draft["id"], authorization_id: webhook["data"]["authorization"]["id"], signature: signature)

page = manza.invoices.list(limit: 100)
page.data         # => Array of invoice hashes
page.has_more     # => true / false
page.next_cursor  # => string or nil

# Walk pages explicitly:
while page
  page.data.each { |inv| process(inv) }
  page = page.next  # returns nil when has_more is false
end

begin
  manza.invoices.get("does-not-exist")
rescue Manza::NotFoundError => e
  e.status      # => 404
  e.request_id  # => "req_..."
  e.type        # => "not_found_error"
end

manza = Manza.new(api_key: "...", api_version: "2026-03-27")