DNA Payments Developer Documentation

website·Indexed 34 days ago

https://developer.dnapayments.com

Developer guides and API references for integrating DNA Payments and axept® Checkout v3. Includes documentation for payment components (PayPal, Google Pay, WeChat Pay), integrations for Apple Pay, Klarna, and Open Banking, the Pay by Link API, and plugins for Magento 2.

Tokens
191.5K
Snippets
547
Records
1.1K
Agent score
67%

What's inside DNA Payments

  1. Overview of the axept® PRO Printing & Scanning API

    The axept® PRO Printing & Scanning API serves as a hardware abstraction bridge for Android terminals. It allows developers to interact with printing and scanning capabilities across different terminal types and manufacturers using a consistent set of functions and protocols, eliminating the need for hardware-specific implementations. The API supports text and image printing for card receipts, goods receipts, kitchen orders, vouchers, QR codes, and POS reporting.
  2. Overview of axept® Checkout v3 integration

    axept® Checkout v3 is an e-commerce payment solution that handles sensitive card information so the host website never has access to full card numbers. The integration follows a four-stage process:

    1. Authentication: The host website must authenticate with axept® Checkout v3 for every transaction.
    2. Redirection for Payment: The consumer is directed to the payment form via full-page redirect or a JavaScript lightbox.
    3. Payment Result: axept® Checkout v3 confirms the authorization result to the host website.
    4. Redirection to Host: The consumer is redirected back to the host site using provided URLs to complete the checkout.
  3. Overview of axept® Connect Cloud Integration

    axept® Connect is a Cloud Integration solution for axept® PRO terminals. Unlike standard axept® PRO setups, it does not depend on the local network for the connection between the Point of Sale (POS) and the Terminal. Integration is handled via API calls to a RESTful endpoint to initiate transactions, monitor status, and receive optional webhook responses.
  4. Overview of axept® Gateway

    The axept® Gateway is a Web Service for processing electronic payments across various platforms, including ecommerce (websites and mobile apps) and MOTO (Mail Order or Telephone Order). Unlike axept® Checkout, which is a hosted payment page, the Gateway allows developers to maintain complete control over the design of the payment capture webpages and the overall payment flow, providing an 'invisible' processing experience to the cardholder.
  5. Overview of the DNA Payments Reporting API

    The Reporting API allows partners to retrieve transaction data processed by their merchants, facilitating automated reconciliation and Management Information (MI) reporting. New merchants added to the DNA Platform are automatically available via the API.

    Availability Constraints: This API is only available to users who:

    1. Process transactions through a DNA-acquired solution, OR
    2. Use the latest DNA Ecommerce solutions through any Acquirer.

    Important Implementation Note: There are distinct endpoints for POS (Point of Sale) and Ecommerce payments. Developers must use the specific endpoint corresponding to their deployed solution.

  6. Overview of axept® Checkout v3 Integration

    axept® Checkout v3 is an ecommerce transaction processing solution that handles sensitive card information so the host website never has access to full card numbers. The integration follows a four-stage lifecycle:

    1. Authentication: The host website must authenticate with axept® Checkout v3 for every single transaction.
    2. Redirection for Payment: The consumer is sent to the payment form via full-page redirect or a JavaScript lightbox.
    3. Payment Result: axept® Checkout v3 confirms the authorization result to the host website.
    4. Redirection to Host: The consumer is redirected back to the host site via provided URLs to complete the checkout.
  7. Overview of available standalone payment components

    The platform provides a set of standalone payment method buttons that can be integrated into an application to allow customers to pay using their preferred secure methods. The available components include:

    • Apple Pay: Secure payments for Apple device users.
    • Google Pay: Secure payments for users with Google accounts.
    • Apple Pay Express Checkout: A streamlined version of Apple Pay for faster checkout.
    • Alipay: A leading payment platform primarily used in China.
    • WeChat Pay: A payment method integrated within the WeChat app, widely used in China.
    • Alipay+: A cross-border digital payment service supporting multiple e-wallets.
    • Click to Pay: A secure method using stored card details across participating merchants.
  8. Overview of the DNA Pay by Link API

    The Pay by Link API is a RESTful service that allows partners to programmatically manage payment links. These links generate securely hosted payment pages where customers can make preset payments to a merchant. While this functionality is available manually via the DNA Merchant Portal, the API enables automated integration for creating, updating, canceling, and retrieving payment links within a third-party solution.
  9. Overview of axept PRO Scanning API

    The Scanning API is a RESTful endpoint residing on the target terminal used exclusively for capturing barcode and QR code data. All captured data is returned as Base64 encoded strings.

    Supported Barcode Formats:

    • UPC-A, UPC-E, EAN-8, EAN-13, Code 39, Code 128, Interleaved 2 of 5, Codabar, MSI

    Supported QR Code Formats:

    • QR Code, Data Matrix, PDF417, Aztec Code, MaxiCode
  10. Overview of DNA Payments Hosted Fields

    DNA Payments Hosted Fields allows merchants to be eligible for the simplest level of PCI compliance (SAQ A). Sensitive data fields (such as PAN and CSC) are hosted on the DNA Payments platform but are located and styled on the merchant's page via iFrames, allowing the merchant to maintain control over the checkout look and feel.
  11. Overview of Incremental Authorisation flows

    Incremental authorisations allow a merchant to authorize additional funds beyond the initial amount, which are later settled via a single charge request. This is ideal for usage-based billing (e.g., EV charging, hotels). The typical lifecycle is: 1. Initial pre-authorisation via a Merchant Initiated Transaction (MIT) $\rightarrow$ 2. One or more incremental authorisations to increase funds $\rightarrow$ 3. A final capture/settlement request (or a cancel/reversal to release funds).
  12. Overview of DNA Payments Partner Tools

    DNA Payments provides a suite of tools for partners and direct merchants to manage and grow merchant portfolios. Available tools include the Order API for managing orders, Reporting tools for payment reconciliation, and a Terminal Management System (TMS) currently under development. Additionally, a Merchant Portal is available for reporting and transaction management that does not require technical integration.