Invoice information request

The method allows you to get information about the invoice

Invoice information request

post

Header parameters

x-api-public-keystringOptional

Public API-key

x-api-signaturestringOptional

Signing the request body with a private API-key

Content-typestringOptional

Request content type

Example: application/json

Body

The body of the request for obtaining information about the invoice

invoiceIdstringOptional

Invoice ID

Example: a391dea4-eab4-456e-af1d-aeaa9cc144be

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

POST /api-gateway/get-invoice HTTP/1.1
Host: ocp.onchainpay.io
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "invoiceId": "a391dea4-eab4-456e-af1d-aeaa9cc144be"
}

200Success

{
  "success": true,
  "response": {
    "id": "a391dea4-eab4-456e-af1d-aeaa9cc144be",
    "advancedBalanceId": "2db11a99-a1cb-44f1-ba3b-ee41d80f53be",
    "externalId": "merchantExternalId123",
    "externalUserId": "10099",
    "payerEmail": "[e-mail]",
    "orderId": "a39a97fd-f0a1-461d-9603-13cdaa54b859",
    "orderLink": "https://payment.domain/a39a97fd-f0a1-461d-9603-13cdaa54b859",
    "invoiceLink": "https://invoices.domain/a391dea4-eab4-456e-af1d-aeaa9cc144be",
    "status": "INIT",
    "order": "Order #123456",
    "description": "Payment by order #123456",
    "currency": "USD",
    "amount": "20",
    "receivedNetwork": "USDT",
    "receivedCurrency": "USDT",
    "receivedAmount": "100.32",
    "receivedAmountInInvoiceCurrency": "100.94",
    "rate": "100.32",
    "includeFee": true,
    "additionalFees": [
      "SEPA_WITHDRAWAL"
    ],
    "insurancePercent": "1",
    "slippagePercent": "2",
    "paymentTolerancePercent": "1.5",
    "webhookURL": "https://merchant.domain/webhooks/invoice",
    "returnUrl": "https://merchant.domain/",
    "expiresAt": "2025-05-14T13:40:20.466Z",
    "createdAt": "2025-05-14T13:39:50.466Z",
    "currencies": [
      {
        "currency": "USDT",
        "networks": [
          {
            "name": "ethereum",
            "amount": "25"
          }
        ]
      }
    ]
  }
}