Payment information

API endpoint (GET)
https://api.maibmerchants.md/v1/pay-info/{payId}

Ensure that the Content-Type header and body are excluded from requests to this endpoint.

Request parameter (URL path)

Parameter	Required	Type	Description
payId	YES	String(UUID)	Transaction identifier

Request example (CURL)

curl --location --request GET 'https://api.maibmerchants.md/v1/pay-info/f16a9006-128a-46bc-8e2a-77a6ee99df75' \
--header 'Authorization: Bearer access_token' \

Response parameters

Parameter	Type	Description
result	Object	Object containing transaction data.
payId	String	Transaction identifier assigned by maib ecomm.
orderId	String	Order ID generated by Merchant website/app.
billerId	String	Card identifier registered in maib ecomm system (for recurring/one-click payments).
billerExpiry	String	The date (month/year) until which the card data will be saved in maib ecomm system (for recurring/one-click payments). Format: MMYY (e.g: 1229 - december 2029).
status	String	Transaction status
statusCode	String	Transaction status code
statusMessage	String	Transaction status information message
threeDs	String	3-D Secure authentication result
rrn	String	RRN - Transaction ID generated by maib.
approval	String	Approval Code - The transaction approval code generated by the card issuing bank.
cardNumber	String	Masked number card.
amount	Number(decimal)	Transaction amount. Format: X.XX
confirmAmount	Number(decimal)	Amount debited from Customer's account in format X.XX (for two-step payments).
refundAmount	Number(decimal)	Amount refunded to Buyer in formatt X.XX (for refunded payments).
currency	String	Transaction currency (MDL/EUR/USD).
description	String	Payment description.
clientIp	String	Customer IP
clientName	String	Customer Name Surname
email	String	Customer email
phone	String	Customer phone
delivery	String	Shipping cost
items	Array	The products or services ordered from the website/app
- id	String	Product ID
- name	String	Product name
- price	Number(decimal)	Product price
- quantity	Integer	Product quantity
ok	Boolean	Request/transaction processing status. true - no errors false - an error occurred (error details will be in errors)
errors	Array	Request/transaction processing errors. Errors table
errorCode	String	Error code
errorMessage	String	Error description
errorArgs	Object	Object contains parameters with error details

Example

Successful

{
"result": {
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"orderId": "123",
"billerId": "t78i8006-458a-46bc-9e0a-89a6ee11df68",
"billerExpiry": "1225",
"status": "OK",
"statusCode": "000",
"statusMessage": "Approved",
"threeDs": "AUTHENTICATED",
"rrn": "331711380059",
"approval": "327593",
"cardNumber": "510218******1124",
"amount": 10.25,
"confirmAmount": 10.25,
"refundAmount": 10.25,
"currency": "EUR",
"description": "Description",
"clientIp": "127.0.0.1",
"clientName": "Name Surname",
"email": "[e-mail]",
"phone": "069123456",
"delivery": 1.25,
"items": [
{
"id": "10",
"name": "Product 1",
"price": 2.50,
"quantity": 2
},
{
"id": "11",
"name": "Product 2",
"price": 4,
"quantity": 1
}
],
},
"ok": true
}

Error

{
    "errors": [
        {
            "errorCode": "13002",
            "errorMessage": "Payment ID 'f16a9006-128a-46bc-8e2a-77a6ee99df75' not found",
            "errorArgs": {
                "paymentId": "f16a9006-128a-46bc-8e2a-77a6ee99df75"
            }
        }
    ],
    "ok": false
}