Svea Invoice as a new payment method

We are excited to announce that we've added Svea as a new payment provider method to our "Initiate Payment" API endpoint.

About Svea
Svea is a well-established European financial group with over 40 years of experience in helping businesses improve liquidity. With operations spanning multiple countries and a dedicated workforce of more than 2,000 employees—including advisors, lending specialists, developers, and designers—Svea offers a wide range of financial solutions. They are committed to delivering tailored services within financing, credit information, invoicing, and payment processing to companies of all sizes and across all industries.

Key Features of the New Svea Integration

• Invoice with Credit Judgment:
  Transactions through Svea involve a credit check, ensuring that your end-customers receive an invoice only after passing Svea’s credit assessment.
• Simplified Collections:
  Once the invoice is issued, Svea takes responsibility for collecting funds from the end-customer. This means you can reduce administrative burdens and the complexity of managing receivables.
• Flexible Payment Terms:
  Svea provides flexible credit days, enabling you to offer favorable payment terms while still maintaining control over your cash flow.
• Seamless Integration with Existing Checkout Flows:
  The "Initiate Payment" endpoint allows you to easily incorporate Svea’s invoice payment method into your checkout process, ensuring a smooth, user-friendly experience for your customers.

This addition aligns with our goal to provide a broader range of payment methods, ensuring you can cater to diverse customer preferences and regional requirements while maintaining efficient and secure transaction flows.

JSON Request Description:

When initiating a payment with Svea as the payment provider, you send a POST request to the Initiate Payment endpoint along with a JSON body that contains parameters specific to the Svea invoice payment method. Below is an example structure along with a description of each field.

{
  "provider_method_parameters": {
    "customer_identity": {
      "email": "[email protected]",
      "country_code": "SE",
      "customer_type": "individual",
      "national_id_number": "6201153953"
    },
    "distribution_type": "post",
    "invoice_items": [
      {
        "amount_per_unit": 100,
        "article_number": "123abc",
        "description": "Example Product",
        "number_of_units": 10,
        "vat": 0
      }
    ],
    "navigation": {
      "confirmation_url": "www.my-website.com/checkout-confirm",
      "rejection_url": "www.my-website.com/checkout-rejection"
    },
    "notes": "Please pay!",
    "number_of_credit_days": 14,
    "print_type": "default"
  }
}

Field Descriptions:

• provider_method_parameters (object): Contains all settings and data specific to the Svea invoice payment method.
• customer_identity (object): Information identifying the customer who will receive the invoice.
• email (string): Customer’s email address.
• country_code (string): ISO code for the customer’s country (e.g., "SE" for Sweden).
• customer_type (string): Type of customer, typically "individual" or "company".
• national_id_number (string): The customer’s national ID number, used for credit assessment.
• distribution_type (string): How the invoice should be delivered to the customer (e.g., "post").
• invoice_items (array of objects): A list of items on the invoice.
• amount_per_unit (number): Price per unit (excluding VAT).
• article_number (string): Unique identifier for the item.
• description (string): A short description of the product or service.
• number_of_units (number): Quantity of the item purchased.
• vat (number): VAT percentage or amount applicable to the item.
• navigation (object): URLs for redirecting the customer after the payment process.
• confirmation_url (string): URL to redirect to upon successful confirmation.
• rejection_url (string): URL to redirect to if the payment is rejected.
• notes (string): Additional message or instructions for the invoice.
• number_of_credit_days (number): The number of days until the invoice is due.
• print_type (string): Determines the print formatting of the invoice, e.g., "default".

JSON Response Description:

After processing your request to initiate a Svea invoice payment, the response will contain information needed to proceed with the payment and any subsequent actions. The response indicates next steps such as redirecting the user to a verification page.

{
  "redirect_url": "https://svea-redirect-url.com/authenticate",
  "reference": "SVEA_ORDER_ID_1234567890"
}

Field Descriptions:

• redirect_url (string): A URL to which the payer is redirected for authentication, identity verification, or additional payment steps as required by Svea.
• reference (string): The unique reference provided by Svea for this transaction, commonly referred to as the "Svea Order ID." This ID can be used for tracking, customer service, or post-payment activities.

In summary:

Request: Send detailed invoice and customer data in JSON to initiate the payment with Svea.
Response: Receive a redirect_url to finalize the payment process and a reference that uniquely identifies the order within Svea’s system.