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
  2. Payment Initiation
  3. Create Hybrid QR Code

Create Extension for QR Code by ID

POST /v2/mia/qr/{qrId}/extension

Allows extending the validity period and/or modifying the amount for an existing Hybrid QR code. Useful when a QR code needs to be reused for a new order or requires a new validity period.


Request parameters (body)

Parameter
Type
Required
Description

expiresAt

string (datetime)

Yes

New expiration date of the QR code. Must comply with: minimum 1 minute, maximum 60 days from the current moment.

(min>0 / max=100000) ISO 8601 format (ex: "2029-10-22T10:32:28+03:00").

amount

number (decimal)

Yes, for Fixed or Controlled

Payment amount. Must satisfy the limits: amountMin <= amount <= amountMax. Not allowed for Free.

amountMin

number (decimal)

Yes, forControlled

Minimum payment amount. Not allowed for Fixed or Free.

amountMax

number (decimal)

Yes, forControlled

Maximum payment amount. Not allowed for Fixed or Free.

description

string (max 500)

Yes

Order description.

orderId

string (max 100)

No

Order ID from the Merchant.

callbackUrl

string (max 1000)

No

URL for payment notification. Format: HTTPS.

redirectUrl

string (max 1000)

No

URL to which the client is redirected after payment. Format: HTTPS.

Request example

{
  "expiresAt": "2029-11-22T10:32:28+03:00",
  "amount": 100.00,
  "description": "Updated order description",
  "orderId": "456",
  "callbackUrl": "https://example.com/callback",
  "redirectUrl": "https://example.com/success"
}

Response (200 OK)

Parameter
Type
Description

result

object

Response object.

result.extensionId

string (guid)

ID of the added extension.

ok

boolean

true if the request was processed successfullyfalse otherwise.

errors

array

Errors list, if any.

errors.errorCode

string

Error code.

errors.errorMessage

string

Error description.


Response example

{
  "result": {
    "extensionId": "fe7e93a2-d5f2-4e7f-81a3-3c7d17c224f2"
  },
  "ok": true
}
PreviousCreate Hybrid QR CodeNextPayment Cancellation

Last updated 1 day ago