Skip to main content
GET
/
api
/
v3
/
deposit
/
card
/
{reference_id}
Get Deposit status
curl --request GET \
  --url https://sandbox-api.kotanipay.io/api/v3/deposit/card/{reference_id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "Deposit status retrieved.",
  "data": {
    "status": "PENDING",
    "id": "5f9b2c7b9c9d6b0017b4e6b1",
    "amount": 10,
    "walletId": "5f9b2c7b9c9d6b0017b4e6b1",
    "referenceId": "5f9b2c7b9c9d6b0017b4e6b1",
    "referenceNumber": 1234567890,
    "createdAt": "2025-10-08T11:28:01.591Z",
    "transactionCost": 10,
    "transactionAmount": 10,
    "callbackUrl": "https://example.com",
    "customerKey": "",
    "initialDepositBalance": 10,
    "finalDepositBalance": 10
  }
}
An integrator can use this endpoint to check the status of a card deposit transaction.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
reference_id
string
required

Response

​
success
boolean
Example:

true

​
message
string
Example:

"Deposit status retrieved."

​
data
object