DOCSEARCHbyAlgolia
Submit Docs

Dintero API Reference

website·Indexed 35 days ago

https://docs.dintero.com

API documentation for Dintero, providing endpoints for account management, store and terminal configuration, payment approvals, discount campaigns, card and token management, and OAuth authentication.

Tokens
101K
Snippets
488
Records
841
Agent score
71%

What's inside Dintero

  1. Overview of Dintero Unified Commerce Platform

    Dintero is a unified commerce platform that provides financial infrastructure for online stores, marketplaces, and point-of-sale systems. Its core capabilities include:

    • Payments: Hosted payment solutions via Dintero Checkout.
    • Loyalty & Virtual Cards: Management of customer profiles, discount/loyalty programs, digital receipts, and gift cards.
    • Order Management: Independent creation and tracking of orders, managing the lifecycle from draft through authorization, capture, and refund.
    • Partner Tools: Automation of merchant onboarding, payment configuration, and reporting via the Partner API.

  2. Overview of Dintero Discount and Reward Service capabilities

    The Dintero Discount and Reward Service allows for the configuration of customer-specific discounts, coupons, stamp cards, and bonus rewards across products and product groups.

    Supported reward types include:

    • Percentage or Fixed Amount discounts: Applicable to specific products, product groups, or all products.
    • Fixed Price: Setting a specific price for a product.
    • Buy X Pay for Y: Volume-based discounts.
    • Mix & Match: Package deals (e.g., buy a specific set of different items for a bundled price).
    • Stamp/Loyalty Cards: 'Buy X get a free product' or 'Buy X get a discount on product Y'.

    Discounts can be constrained by:

    • Usage Limits: Maximum number of times a customer can use the discount across purchases.
    • Quantity Limits: Maximum number of products the discount can be applied to.
    • Store Restrictions: Limiting usage to selected stores.
    • Customer Data: Targeting based on attributes (e.g., specific zip codes).
    • Scheduling: Specific days and times (e.g., Mondays from 10am to 11am).
    • Minimum Spend: Requiring a minimum purchase amount to trigger the discount.

  3. Overview of Dintero Loyalty & Virtual Cards services

    The Dintero Loyalty & Virtual Cards platform provides four integrated services sharing a single API and authentication model:

    • Customer service: Centralizes customer profiles, identifiers, and consents across applications.
    • Discount & Reward service: Manages coupons, loyalty cards, stamp cards, and bonus points.
    • Receipt service: Stores digital receipts from all sales channels and streams data via webhooks.
    • Wallet service: Issues and accepts virtual gift cards for online and in-store use.

  4. Overview of Dintero Checkout sandbox test data

    Dintero Checkout provides a sandbox environment to verify integrations without processing real money. The sandbox includes test data for various payment methods, including PSP cards, alternative payment methods (wallets, BNPL), bank accounts for payouts, and specific values to trigger auto-approvals for split payments. A live demo is available at https://checkout.demo.dintero.com/.

  5. Overview of Dintero Payments

    Dintero provides a hosted checkout solution for accepting payments online (web and mobile) and in person via payment terminals. It supports multiple payment methods including cards, Vipps, Klarna, invoices, Apple Pay, and Google Pay. The system handles PCI compliance and payment provider integrations, allowing developers to manage the full payment lifecycle—including capture, refund, and void—through a single API. The general workflow involves creating a session with order details, presenting payment options to the customer, and receiving a callback upon payment completion.

  6. Overview of Dintero Gift Cards in Checkout Express

    Dintero virtual gift cards allow customers to pay for orders fully or partially within Dintero Checkout Express.

    Key Constraints and Behaviors:

    • Compatibility: Only supported for Dintero Checkout Express sessions.
    • Limits: Only one gift card can be used per payment session.
    • Exclusions: Not supported for payment sessions where splits are specified.
    • Refunds/Captures: Gift cards take precedence during partial captures or refunds. A refund to a gift card cannot exceed the amount initially captured from it.
    • Supported Payment Options: Gift cards can only be enabled for the following payment options:
      • payex
      • bambora
      • dintero_psp.creditcard
      • klarna.klarna
    • Wallet Impact: Native push to payment Wallets (Vipps/MobilePay/Swish) is disabled when gift cards are enabled. Instead, push is handled via SMS containing a link to the checkout.

  7. Overview of Dintero Customer Service API

    The Dintero Customer Service API provides a centralized system to store and manage customer profiles, identifiers, consents, and tags. This ensures that data is shared in real-time across various touchpoints, including Point of Sale (POS), eCommerce platforms, Helpdesk applications, 'My Page' portals, and Loyalty programs.

  8. Overview of Dintero Payment Profiles

    Payment profiles determine which payment methods are available during a merchant's checkout session. Partners can manage these profiles on behalf of their merchants using the Dintero Partner API and a merchant access token obtained via the merchant account API access flow.

  9. Overview of Dintero payment and checkout terminology

    Key terms for integrating Dintero Checkout and payments:

    • BNPL (Buy Now, Pay Later): Invoice and installment methods (e.g., Klarna, Walley, Billie) where the provider pays the merchant upfront.
    • EHF: The Norwegian electronic invoicing format used for B2B invoice methods (e.g., Two).
    • External payment method: A payment method handled by the merchant themselves, displayed in Express sessions under a custom label and button.
    • EMD (Extra Merchant Data): Additional order details sent to Klarna for specific categories like travel or digital goods to improve acceptance rates.
    • POS (Point of Sale): In-store checkout systems used for in-person payments and Loyalty services.
    • IPP (In-person payments): Accepting payments via physical Dintero terminals.

  10. Overview of Kravia Merchant Initiated Payments (MIT)

    Kravia MIT flows allow merchants to create and pay invoices programmatically without the customer going through a manual checkout process. This is primarily used for automated invoicing, recurring billing, and back-office workflows. There are two implementation paths:

    1. One-step: Uses a single endpoint to create the session and register the invoice immediately. Best for automated or recurring billing.
    2. Two-step: Separates session creation from the payment trigger. Useful for integrating with existing session flows or when there is a delay between session setup and payment.

  11. Overview of Dintero Payment Profiles

    Payment profiles are named payment configurations stored in the Dintero Backoffice. They allow you to manage payment methods, their display order, and checkout themes centrally. By referencing a profile_id in a session request instead of listing every payment method, you can update your payment setup in the Backoffice without redeploying your integration code.

  12. Overview of Dintero Checkout Express

    Dintero Checkout Express is a streamlined checkout solution designed to increase conversion rates for returning customers. It reduces friction by securely storing customer payment details, allowing users to complete purchases with fewer clicks without re-entering payment information for every transaction.