maib MIA QR API
EN
EN
  • Overview
    • General Technical Specifications
    • MIA QR Types
  • Endpoints
    • Authentication
      • Obtain Authentication Token
    • Payment Initiation
      • Create QR Code (Static, Dynamic)
      • Create Hybrid QR Code
        • Create Extension for QR Code by ID
    • Payment Cancellation
      • Cancel Active QR (Static, Dynamic)
      • Cancel Active QR Extension (Hybrid)
    • Payment Refund
      • Refund Completed Payment
    • Information Retrieval (GET)
      • Display List of QR Codes with Filtering Options
      • Retrieve QR Details by ID
      • Retrieve List of Payments with Filtering Options
      • Retrieve Payment Details by ID
  • Payment Simulation (Sandbox)
  • Notifications on Callback URL
  • Errors
    • API Errors
    • HTTP Status Codes
  • Glossary
  • maib e-commerce API
Powered by GitBook
On this page
  1. Endpoints

Payment Initiation

Payment initiation in the QR MIA ecosystem is performed by generating a QR code, which can be scanned using the maib mobile application or the phone’s camera to complete the payment.

Available QR Types

  • Static QR Fixed QR code, used in static contexts (e.g., stickers, menus). The amount can be:

    • Fixed

    • Controlled (minimum-maximum range)

    • Free (the user enters the amount)

  • Dynamic QR QR code generated for a single transaction, with a fixed amount and limited validity.

  • Hybrid QR Reusable QR code allowing modification of the amount and expiration date. Suitable for static displays but with dynamic behavior.

Payment Initiation Steps

  1. Select the required QR type (Static, Dynamic, Hybrid)

  2. Send a POST request to the corresponding endpoint

  3. Include the following details:

    • Amount type (Fixed, Controlled, Free)

    • Currency (only MDL)

    • Amount or limits

    • Expiration date

    • Order description

    • Callback and redirect URLs (for web integration)

  4. Receive the response containing the generated QR data:

    • qrId: unique identifier of the QR code

    • extensionId: extension identifier (only for Hybrid QR)

    • url: link to be displayed, saved, or rendered as a QR code

  5. Display the QR code to the end user

  6. The payment is made by scanning the QR code using the bank app or phone camera

PreviousObtain Authentication TokenNextCreate QR Code (Static, Dynamic)

Last updated 1 day ago