Transaction

Get transaction

Retrieves details for a specific transaction. For production environment, merchant status must be ACTIVE. Sandbox environment can be used with any merchant status.

Authorization

AuthorizationRequiredBearer <token>

In: header

Query Parameters

idRequiredstring

Transaction ID

Format: "uuid"

Response Body

Transaction details retrieved successfully

TypeScript Definitions

Use the response body type in TypeScript.

dataobject

Missing transaction ID

TypeScript Definitions

Use the response body type in TypeScript.

errorRequiredobject

Unauthorized

TypeScript Definitions

Use the response body type in TypeScript.

errorRequiredobject

Forbidden - Either transaction belongs to another merchant or production environment requires ACTIVE merchant status

TypeScript Definitions

Use the response body type in TypeScript.

errorRequiredobject

Transaction not found

TypeScript Definitions

Use the response body type in TypeScript.

errorRequiredobject

Server error

TypeScript Definitions

Use the response body type in TypeScript.

errorRequiredobject

curl -X GET "https://api.katu9.com/transaction?id=497f6eca-6276-4993-bfeb-53cbbbba6f08" \
  -H "Authorization: Bearer <token>"

fetch("https://api.katu9.com/transaction?id=497f6eca-6276-4993-bfeb-53cbbbba6f08", {
  headers: {
    "Authorization": "Bearer <token>"
  }
})

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://api.katu9.com/transaction?id=497f6eca-6276-4993-bfeb-53cbbbba6f08"

  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "Bearer <token>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}

import requests

url = "https://api.katu9.com/transaction?id=497f6eca-6276-4993-bfeb-53cbbbba6f08"

response = requests.request("GET", url, headers = {
  "Authorization": "Bearer <token>"
})

print(response.text)

{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "type": "DEPOSIT",
    "amount": 0.1,
    "currency": "string",
    "status": "string",
    "fee": 0.1,
    "netAmount": 0.1,
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  }
}

{
  "error": {
    "message": "string",
    "details": {}
  }
}

{
  "error": {
    "message": "string",
    "details": {}
  }
}

{
  "error": {
    "message": "string",
    "details": {}
  }
}

{
  "error": {
    "message": "string",
    "details": {}
  }
}

{
  "error": {
    "message": "string",
    "details": {}
  }
}

Create payment link POST

Creates a new payment link for an existing transaction. The new link is associated with the transaction and triggers all active merchant webhooks subscribing to the `payment_link.created` event. The webhook POSTs a JSON payload with the payment link data, the associated transactionId, and an HMAC SHA256 signature in the `X-Katu9-Signature` header.

Create transaction POST

Creates a new payment transaction (deposit or withdrawal). For production environment, merchant status must be ACTIVE. Sandbox environment can be used with any merchant status. **Webhook:** On success, triggers all active merchant webhooks subscribing to the `transaction.created` event. The webhook POSTs a JSON payload with the transaction data and an HMAC SHA256 signature in the `X-Katu9-Signature` header. **Audit Trail:** Each transaction creation is recorded in the `transaction_history` table for auditing.