Payments Order

Query the status and details of a specific payment order by its product ID and transaction signature. This endpoint is used to verify whether a user has successfully paid for a product or membership.

---

API

GET /api/payment/order

Example:

GET https://coindpay.xyz/api/payment/order?payeeId=plan_xyz123&signature=0xabc123

---

Query Params

Name	Type	Required	Description
payeeId*	string	Yes	The ID of the product or service being purchased
signature*	string	Yes	Unique transaction identifier (e.g., on-chain txHash or fiat orderId)

💡 This endpoint supports both crypto and fiat payments, and the signature value must be globally unique.

* Required

---

Response

✅ 200 - Success

{
  "ok": true,
  "data": {
    "id": "payment_abc123",
    "payeeId": "plan_xyz123",
    "signature": "0xabc123",
    "uuid": "user_xyz987",
    "payer": "0xabcde1234",
    "payerName": "Visa",
    "name": "Alice",
    "email": "[email protected]",
    "message": "Monthly plan",
    "chain": "solana",
    "chainId": 101,
    "amount": 18.5,
    "usd": 9.99,
    "contract": "So11111111111111111111111111111111111111112",
    "symbol": "USDC",
    "fiatCoin": "USD",
    "fiatAmount": 9.99,
    "createdAt": "2025-06-29T03:10:00Z"
  }
}

---

❌ Error Responses

404 - Not Found

{
  "ok": false,
  "message": "Payment not found ˙◠˙"
}

---

Field Descriptions

Field	Type	Description
id	string	Unique payment ID
payeeId	string	Product or service ID
signature	string	Unique transaction hash or order reference
uuid	string	Internal ID of the payee (receiver)
payer	string	Wallet address (for crypto payments)
payerName	string	Fiat payment provider name (e.g., Visa)
name	string	Name of the payer (optional)
email	string	Email of the payer (optional)
message	string	Optional payment message
chain	string	Blockchain name (e.g., solana, ethereum)
chainId	number	Chain ID used for payment
amount	number	Amount paid in token
usd	number	USD value at time of payment
contract	string	Contract address of the token
symbol	string	Token symbol (e.g., USDT, USDC)
fiatCoin	string	Fiat currency code (e.g., USD)
fiatAmount	number	Fiat amount paid (if any)
createdAt	string	ISO 8601 timestamp

---

Notes

• This endpoint replaces /payment/verify and is intended for verifying and retrieving full payment data.

• It works with both on-chain and off-chain payments (crypto, ramps, card, etc.)

• If no payment is found for the given signature and payeeId, ok will be false.