Getting information about an order

The method allows you to get information on a previously created order by its identifier in the system

Getting information about an order

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

Order information request body

orderIdstringOptional

Order ID in the system

Example: 4b3399ee-3690-4984-8c39-a911c8b0aad4

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

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

{
  "orderId": "4b3399ee-3690-4984-8c39-a911c8b0aad4"
}

200Success

{
  "success": true,
  "response": {
    "id": "4b3399ee-3690-4984-8c39-a911c8b0aad4",
    "currency": "USDT",
    "network": "ethereum",
    "status": "pending",
    "orderId": "Order #123456",
    "description": "Payment by order #123456",
    "address": "0x00000005707Bf50EfA35a2db020eDe9Ac0780b9f",
    "addressId": "258e95ed-a3c2-4c85-bf6f-09f8b8f1c0be",
    "tag": null,
    "amount": "123.12",
    "received": "100.32",
    "paymentTolerancePercent": "1.5",
    "successWebhook": "https://merchant.domain/webhooks/success",
    "errorWebhook": "https://merchant.domain/webhooks/fail",
    "returnUrl": "https://merchant.domain/",
    "link": "https://payment.domain/4b3399ee-3690-4984-8c39-a911c8b0aad4",
    "expiresAt": "2025-06-09T13:48:11.523Z",
    "createdAt": "2025-06-09T13:18:11.523Z",
    "updatedAt": "2025-06-09T13:18:11.523Z",
    "transactions": [
      {
        "id": "8aae278f-b75f-4ff0-af2f-15d5c8772e0c",
        "status": "processed",
        "currency": "USDT",
        "network": "ethereum",
        "amount": "100.32",
        "tx": "0xb502e6ba8745a99f3484d75c027c55cacc26d6342b3a129f97d802899435ef12",
        "confirmations": 1,
        "sender": "0x00000005707bf50efa35a2db020ede9ac08ae226",
        "priceUSD": "2000",
        "amountUSD": "100"
      }
    ],
    "orphanDeposits": [
      {
        "id": "8786dbfb-f487-4ad4-b51f-18b9f8d3c5cf",
        "organizationId": "19539253-58da-4ab4-965f-3f23f0cd63f3",
        "orderId": "4b3399ee-3690-4984-8c39-a911c8b0aad4",
        "stage": "WITHDRAWAL",
        "status": "PENDING",
        "message": null,
        "currency": "BUSD",
        "network": "bsc",
        "amount": "200",
        "canWithdrawal": true,
        "inTransaction": {
          "addressType": "PAY_IN",
          "addressId": "258e95ed-a3c2-4c85-bf6f-09f8b8f1c0be",
          "address": "0x00000005707Bf50EfA35a2db020eDe9Ac0780b9f",
          "txId": "0x123456...",
          "amount": "200",
          "status": "processed"
        },
        "outTransactions": {
          "address": "0x00000005707Bf50EfA35a2db020eDe9Ac0780b9f",
          "txId": "0x123456...",
          "amount": "200",
          "status": "processed",
          "feeAmount": "1.2",
          "feeAmountUSD": "1.22",
          "withdrawalId": "1b9d4377-adb5-4cf0-85d5-f970c213a3e0",
          "createdAt": "2025-06-10T13:18:11.523Z"
        },
        "createdAt": "2025-06-09T13:18:11.523Z"
      }
    ]
  }
}