Create a new payment request (RTP)

POST /v2/rtp

This endpoint creates an individual Request to Pay (RTP), which is sent to a customer through the banking application. The RTP contains payment details such as amount, currency, description, and expiration. Once created, the customer will receive a prompt in their bank app to accept or reject the request.

Request

HTTP Method: POST Endpoint:

/v2/rtp

Headers:

Authorization: Bearer {access_token}
Content-Type: application/json

---

Request Body Parameters

Parameter	Type	Required	Description
alias	string(100)	Yes	Customer identification (phone number). Format: 373xxxxxxxx. Example: "37369112221".
amount	number (decimal)	Yes	Amount of the RTP.
expiresAt	string (datetime, ISO 8601-1:2019)	Yes	Expiration date/time of the RTP. Minimum: 1 minute, Maximum: 60 days. Example: "2029-10-22T10:32:28+03:00".
currency	string (enum)	Yes	Payment currency. Possible values: MDL.
description	string(500)	Yes	Order description.
orderId	string(100)	No	Merchant’s internal order identifier.
terminalId	string(100)	No	Terminal ID provided by the bank.
callbackUrl	string(1000)	No	HTTPS URL where the merchant will receive payment data after a successful payment.
redirectUrl	string(1000)	No	HTTPS URL where the customer will be redirected after successful payment (for website integration).

---

Example Request

POST /v2/rtp HTTP/1.1
Host: api.maibmerchants.md
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "alias": "37369112221",
  "amount": 150.00,
  "expiresAt": "2029-10-22T10:32:28+03:00",
  "currency": "MDL",
  "description": "Invoice #123",
  "orderId": "INV123",
  "terminalId": "P011111",
  "callbackUrl": "https://merchant.example.com/callback",
  "redirectUrl": "https://merchant.example.com/success"
}

---

Response

Response Parameters

Parameter	Type	Description
result	object	Response result object.
result.rtpId	string (GUID)	Unique identifier of the RTP.
result.orderId	string(100)	Merchant’s order identifier.
result.expiresAt	string (datetime, ISO 8601-1:2019)	Timestamp when the RTP expires.
ok	boolean	Indicates if the request was processed successfully (true).
errors	array	List of errors, present only if ok = false. Each error contains errorCode and errorMessage.

---

Example Successful Response

{
  "result": {
    "rtpId": "123e4567-e89b-12d3-a456-426614174000",
    "orderId": "INV123",
    "expiresAt": "2029-10-22T10:32:28+03:00"
  },
  "ok": true
}

---

Notes

• A new RTP is created in Pending status.

• If not accepted or rejected by the customer before expiresAt, it will automatically move to Expired.

• The rtpId returned in the response is required for all subsequent operations (checking status, cancelling, refunding).