Payments

import { Aside } from ‘@astrojs/starlight/components’;

create_payment

Send EURD from a managed account to another EURD account, a blockchain address, or a payment request.

create_payment(
  paymentFrom: string,       // Source account code
  paymentTo: string,         // Destination (see toType)
  toType: "AccountCode" | "BlockchainAddress" | "PaymentRequestCode",
  amount: number,            // Amount in EUR (positive)
  shareName: boolean,        // Share your name with the recipient
  message?: string,          // Optional message
  metadata?: string          // Optional metadata (JSON string)
)

Example prompt:

“Pay €25 to ACC_abc123 with the message ‘dinner split‘“

create_payment_request

Create a shareable payment request with a QR code and deep link. The payer can open the link in the Quantoz app to pay.

create_payment_request(
  accountCode: string,                    // Your receiving account
  amount: number,                         // Requested amount in EUR
  expiresOn: string,                      // ISO 8601 expiry datetime
  shareName: boolean,                     // Share your name with the payer
  isOneOffPayment: boolean,               // Single use only
  payerCanChangeRequestedAmount: boolean, // Let payer adjust amount
  message?: string,
  paymentReference?: string,
  callbackUrl?: string                    // Webhook for status updates
)

Returns: { paymentRequestCode, qrCode, deepLink, smartLink }

list_payment_requests

List your payment requests with optional filters.

list_payment_requests(
  status?: "Open" | "Paid" | "Processing" | "Cancelled" | "Expired",
  accountCode?: string,
  startDate?: string,   // ISO 8601
  endDate?: string,
  page?: number,        // Default 1
  pageSize?: number     // Default 10
)

delete_payment_request

Cancel an open payment request.

delete_payment_request(paymentRequestCode: string)

get_transactions

Retrieve the transaction history for an account.

get_transactions(
  accountCode: string,
  page?: number,
  pageSize?: number,
  type?: "Payment" | "Funding" | "Payout",
  status?: string,
  startDate?: string,
  endDate?: string,
  txCode?: string,
  toAccountCode?: string
)

redeem_eurd

Redeem EURD back to a bank account via SEPA transfer.

redeem_eurd(
  accountCode: string,
  amount: number,
  bankAccountNumber?: string,  // Uses profile default if omitted
  metadata?: string
)

fund_and_forward

Fund a business account and immediately forward the EURD to a consumer account in one atomic step. Requires BusinessPremium scope. Minimum €5.00.

fund_and_forward(
  businessAccountCode: string,
  profileAccountCode: string,
  amount: number,       // Minimum 5.00
  message: string,      // Max 100 chars
  metadata?: string
)