Skip to Content
Version 1.1 · A Coming soon badge is a backward-compatible change still rolling out.
Query a transaction

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

FieldRequiredNotes
idyesYour referenceId, or the InsPay transactionId
timestamp, nonceyesSee 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

FieldNotes
transactionIdInsPay transaction id
providerOrderIdInternal routing reference. Coming soonRemoved from merchant responses.
merchantIdReturned on the transaction record
referenceIdYour order id
typeDEPOSIT or WITHDRAW
currencyFor example JPY
statusSee statuses. Only COMPLETED means paid.
playerIdYour player id
superTransactionIdReturned on the transaction record
createdAt, updatedAtReturned on the transaction record
methodReturned on the transaction record
amount, feefee is the InsPay fee
netAmountamount − fee for a deposit, amount + fee for a withdrawal. Available before completion.
actualAmountnull until completed, then the same calculation as netAmount
currentBalanceReturned on the transaction record
receiverAccount, receiverName, receiverBank, receiverBankCode, receiverBankBranchReceiver bank details, when present

Not found:

transaction-not-found.json
{"message": "Transaction not found"}

HTTP status 404.

Last updated on