POST /payment/info

Returns the current status and details of a payment. Requires authentication. Provide at least one of uuid or order_id.

Request

POST /payment/info

Request Body

Field	Type	Required	Description
`uuid`	string	No*	The payment UUID
`order_id`	string	No*	Your internal order identifier

* At least one of uuid or order_id is required.

Example

# Compute sign: MD5(base64(JSON.stringify(body)) + API_KEY)
curl -X POST https://api.nearpayments.io/cryptomus/v1/payment/info \
  -H "Content-Type: application/json" \
  -H "merchant: YOUR_MERCHANT_UUID" \
  -H "sign: COMPUTED_SIGN" \
  -d '{
    "order_id": "order-42"
  }'

Status Mapping

The adapter maps upstream Cryptomus statuses to NearPayments statuses:

Cryptomus Status	NearPayments Status
`waiting`	`process`
`confirming`	`confirm_check`
`confirmed`	`confirm_check`
`sending`	`process`
`partially_paid`	`wrong_amount`
`finished`	`paid`
`failed`	`fail`
`refunded`	`refund_paid`
`expired`	`cancel`

Response

{
  "state": 0,
  "result": {
    "uuid": "a1b2c3d4-...",
    "order_id": "order-42",
    "amount": "50.00",
    "payment_amount": "50.00",
    "payer_amount": "50.00",
    "discount_percent": 0,
    "discount": "0.00",
    "payer_currency": "USDT",
    "currency": "USDT",
    "merchant_amount": "49.50",
    "network": "tron",
    "address": "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb",
    "from": "TXyz...",
    "txid": "abc123...",
    "payment_status": "finished",
    "url": "https://api.nearpayments.io/pay/a1b2c3d4-...",
    "expired_at": 1710600000,
    "status": "paid",
    "is_final": true,
    "additional_data": null,
    "created_at": "2025-01-15T10:30:00+00:00",
    "updated_at": "2025-01-15T10:35:00+00:00"
  }
}