Payment options
Invoice content uses payment_multiple_options to describe how the recipient
can pay. See Invoices for the common content and payment
payload.
Payment methods
Section titled “Payment methods”Set payable to true to enable payment through Kivra’s payment platform.
Use method: "1" for BankGiro or method: "2" for PlusGiro, and provide the
destination account. The supported currency is SEK.
An optional swish_alias must be available for the sender to offer Swish.
Set it to "disable" to disable Swish for an individual invoice. Set
autogiro_destination to "disable" to disable automatic payment for an
individual invoice.
Fixed payment options
Section titled “Fixed payment options”Each entry in options supplies a due date, amount, reference type, and
reference. Options should differ in amount or reference. The first option’s
due date determines invoice notifications, and clients without support for
multiple options display only the first option.
Flexible payment options
Section titled “Flexible payment options”Add flexible_option when the recipient may choose the amount. Include at
least one fixed option as well, for clients that do not support flexible
options.
Use min_limit and max_limit for enforced amount limits, and
min_suggested and max_suggested for warnings that the recipient can
choose to ignore. Payment provider and bank limits still apply.
Payment events
Section titled “Payment events”See Payment webhooks to receive payment events and eligible invoice-declined events.
See the Send content API reference for the complete payment schema and validation rules.