Maestro

Features
Method	Debit Card, Sync
Countries	Europe
Processing currencies	All
Increments	✅
Captures	✅
Partial/Multiple partial captures	⚠️ (Only one partial capture is supported)
Cancels	✅
Partial/Multiple partial cancels	✅ *
Refunds	✅
Partial/Multiple partial refunds	✅
Recurring	✅
Installments	-
Credits	-
Disputes	✅
Min Amount	N/A
Account verification	✅

note

* Feature support depends on the acquirer. Please contact NomuPay's support team if more information is needed.

Maestro cards (part of the Mastercard scheme) are widely accepted in e-commerce and physical environments. Card tokenization and consumer authentication (via the 3-D Secure protocol) improve the consumer experience and security of payments.

Account verification (Zero auth)

An account verification is an authorization request with an amount of 0.

Auto-cancellation

Card schemes require a period of time within which the authorized amount must be captured. This period can vary depending on the Merchant Category Code (MCC), but is typically 30 days for Maestro. If an amount remains to be captured within this period, a cancellation process is automatically initiated. In this case, you will receive the result of the operation asynchronously, in a cancel webhook.

Payment flow

Payment

Request

{
    "processingAccountId": "2HdN2jq6XWmlkhqRC2gDTNYCvNH",
    "merchantReference": "B2A8734D-9450-4915-A63D-FE5C21F09550",
    "amount": {
        "value": 200,
        "currency": "eur"
    },
    "paymentMethod": {
        "type": "maestro",
        "maestro": {
            "account": {
                "number": "6703444444444449",
                "expiryMonth": "1",
                "expiryYear": "2030",
                "cvv": "333"
            },
            "capture": "manual",
            "threedsPassThrough": {
                "version": "2.1.0",
                "eci": "02",
                "transactionId": "fe7ecca3-3082-483c-880e-a06a3cf94545",
                "authenticationValue": "kBGgt+19mPklgPfl9DQ9KWjOyBY="
            }
        }
    }
}

Response

{
    "id": "2RkJWSysl7k2IsOUCGje1fnkhmg",
    "merchantReference": "B2A8734D-9450-4915-A63D-FE5C21F09550",
    "status": "succeeded",
    "paymentMethod": {
        "type": "maestro",
        "scheme": {
            "approvalCode": "11DCB0",
            "cvvResult": "M",
            "transactionId": "MCC792D1C0626"
        }
    }
}