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: 6cbc8dbc-1813-4b9b-a888-d5a48a8b4677

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": "6cbc8dbc-1813-4b9b-a888-d5a48a8b4677"
}

200Success

{
  "success": true,
  "response": {
    "id": "6cbc8dbc-1813-4b9b-a888-d5a48a8b4677",
    "currency": "USDT",
    "network": "ethereum",
    "status": "pending",
    "orderId": "Order #123456",
    "description": "Payment by order #123456",
    "address": "0x00000005707Bf50EfA35a2db020eDe9Ac0780b9f",
    "addressId": "7a4043e6-793e-4677-8c5a-1b293fe13020",
    "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/6cbc8dbc-1813-4b9b-a888-d5a48a8b4677",
    "expiresAt": "2025-06-04T10:06:10.118Z",
    "createdAt": "2025-06-04T09:36:10.118Z",
    "updatedAt": "2025-06-04T09:36:10.118Z",
    "transactions": [
      {
        "id": "e8fbc52b-5f17-4185-907d-2824407189f6",
        "status": "processed",
        "currency": "USDT",
        "network": "ethereum",
        "amount": "100.32",
        "tx": "0xb502e6ba8745a99f3484d75c027c55cacc26d6342b3a129f97d802899435ef12",
        "confirmations": 1,
        "sender": "0x00000005707bf50efa35a2db020ede9ac08ae226",
        "priceUSD": "2000",
        "amountUSD": "100"
      }
    ],
    "orphanDeposits": [
      {
        "id": "ee27c417-0cf0-4ed4-8987-70622942bb26",
        "organizationId": "8386e943-3ca4-4317-9a33-bfa9e7a09993",
        "orderId": "6cbc8dbc-1813-4b9b-a888-d5a48a8b4677",
        "stage": "WITHDRAWAL",
        "status": "PENDING",
        "message": null,
        "currency": "BUSD",
        "network": "bsc",
        "amount": "200",
        "canWithdrawal": true,
        "inTransaction": {
          "addressType": "PAY_IN",
          "addressId": "7a4043e6-793e-4677-8c5a-1b293fe13020",
          "address": "0x00000005707Bf50EfA35a2db020eDe9Ac0780b9f",
          "txId": "0x123456...",
          "amount": "200",
          "status": "processed"
        },
        "outTransactions": {
          "address": "0x00000005707Bf50EfA35a2db020eDe9Ac0780b9f",
          "txId": "0x123456...",
          "amount": "200",
          "status": "processed",
          "feeAmount": "1.2",
          "feeAmountUSD": "1.22",
          "withdrawalId": "73789913-1d6d-4f7b-a905-12c91a8a3fec",
          "createdAt": "2025-06-05T09:36:10.118Z"
        },
        "createdAt": "2025-06-04T09:36:10.118Z"
      }
    ]
  }
}