Query a transaction
POST /transactions
Look up one order by your referenceId or by the InsPay transactionId. Pass either value in id.
Use this when a callback does not arrive, and before you retry a deposit or withdrawal that timed out or returned 5xx.
Request
| Field | Required | Notes |
|---|---|---|
id | yes | Your referenceId, or the InsPay transactionId |
timestamp, nonce | yes | See signing |
transaction-query.json
{
"id": "TXN-20261011-001",
"timestamp": 1791729147,
"nonce": "e7f8a9b0"
}Samples
transaction.sh
API_KEY="YOUR_API_KEY"
SECRET_KEY="YOUR_SECRET_KEY"
BASE_URL="https://api-sandbox.inspay.dev/merchant"
CANONICAL='{"id":"TXN-20261011-001","nonce":"e7f8a9b0","timestamp":"1791729147"}'
SIG=$(printf '%s' "$CANONICAL" | openssl dgst -sha256 -hmac "$SECRET_KEY" -hex | awk '{print $NF}')
curl -sS -X POST "$BASE_URL/transactions" \
-H "Content-Type: application/json" \
-H "x-api-key: $API_KEY" \
-H "x-signature: $SIG" \
--data-binary "$CANONICAL"Response 200
| Field | Notes |
|---|---|
transactionId | InsPay transaction id |
providerOrderId | Internal routing reference. Coming soonRemoved from merchant responses. |
merchantId | Returned on the transaction record |
referenceId | Your order id |
type | DEPOSIT or WITHDRAW |
currency | For example JPY |
status | See statuses. Only COMPLETED means paid. |
playerId | Your player id |
superTransactionId | Returned on the transaction record |
createdAt, updatedAt | Returned on the transaction record |
method | Returned on the transaction record |
amount, fee | fee is the InsPay fee |
netAmount | amount − fee for a deposit, amount + fee for a withdrawal. Available before completion. |
actualAmount | null until completed, then the same calculation as netAmount |
currentBalance | Returned on the transaction record |
receiverAccount, receiverName, receiverBank, receiverBankCode, receiverBankBranch | Receiver bank details, when present |
Not found:
transaction-not-found.json
{"message": "Transaction not found"}HTTP status 404.
Last updated on