Get invoice by merchant_order_id

GET /api/v3/projects/{projectId}/invoices

Returns the invoice matching the given merchant_order_id within the project.

v4 signature payload: {merchant_order_id}

Request parameters

Field	Type	Required	Description
`projectId`	integer (int32)	yes
`merchant_order_id`	string	—	Order ID in the merchant’s system

Response example


{
  "data": {
    "price": {
      "amount": "100.00",
      "currency": "RUB",
      "vat_included": true
    },
    "status": "Created",
    "customer": {
      "type": "mobile_phone",
      "msisdn": "7960***0000"
    },
    "created_at": "2026-09-21T12:00:00Z",
    "invoice_id": "0d0f3c58-9b1e-4a77-9a0c-000000000001",
    "authorization": {
      "type": "SMS_PIN",
      "is_authorized": false
    },
    "payment_status": "NOT_PAID",
    "merchant_order_id": "ORDER-000000001",
    "billing_channel": "MC",
    "expires_at": "2026-09-21T12:00:00Z"
  },
  "success": true
}

Response codes

Code	Description
`200`	Invoice found
`400`	Validation or business request error
`401`	Authentication failed (missing/invalid signature or timestamp)
`403`	Project access denied or IP not whitelisted
`404`	Invoice not found
`500`	Unexpected platform error
`503`	Service temporarily unavailable