Skip to main content

​
Create Income Transaction

curl -X POST https://api.kinconecta.com/api/income_transactions \
  -H "Content-Type: application/json" \
  -d '{
    "guideId": 789,
    "tripId": 123,
    "tourId": 456,
    "txnType": "BOOKING_INCOME",
    "amount": 150.00,
    "sign": "CREDIT",
    "status": "COMPLETED",
    "description": "Payment for City Walking Tour",
    "occurredAt": "2026-04-15T14:30:00"
  }'
Create a new income transaction record for a guide.

​
Request Body

​
guideId
integer
required
ID of the guide
​
tripId
integer
ID of the trip booking (if applicable)
​
tourId
integer
ID of the tour (if applicable)
​
txnType
enum
required
Type of transaction
  • BOOKING_INCOME: Income from tour booking
  • WITHDRAWAL: Withdrawal of funds
  • REFUND: Refund to tourist
  • ADJUSTMENT: Manual adjustment
​
amount
decimal
required
Transaction amount
​
sign
enum
required
Transaction direction
  • CREDIT: Money added to guide’s balance
  • DEBIT: Money deducted from guide’s balance
​
status
enum
required
Transaction status
  • PENDING: Transaction is pending
  • COMPLETED: Transaction is completed
  • FAILED: Transaction failed
  • CANCELLED: Transaction was cancelled
​
description
string
Description of the transaction
​
occurredAt
datetime
required
Timestamp when the transaction occurred

​
Response

​
transactionId
integer
Unique identifier for the transaction
​
guideId
integer
ID of the guide
​
tripId
integer
ID of the trip booking
​
tourId
integer
ID of the tour
​
txnType
enum
Transaction type
​
amount
decimal
Transaction amount
​
sign
enum
Transaction direction (CREDIT, DEBIT)
​
status
enum
Transaction status
​
description
string
Transaction description
​
occurredAt
datetime
When the transaction occurred
​
createdAt
datetime
When the record was created

​
Get All Income Transactions

curl https://api.kinconecta.com/api/income_transactions
Retrieve all income transactions in the system.

​
Response

Returns an array of income transaction objects.

​
Get Income Transaction by ID

curl https://api.kinconecta.com/api/income_transactions/123
Retrieve a specific income transaction by its ID.

​
Path Parameters

​
id
integer
required
The transaction ID

​
Response

Returns a single income transaction object.

​
Update Income Transaction

curl -X PUT https://api.kinconecta.com/api/income_transactions/123 \
  -H "Content-Type: application/json" \
  -d '{
    "status": "COMPLETED",
    "description": "Updated: Payment processed successfully"
  }'
Update an existing income transaction.

​
Path Parameters

​
id
integer
required
The transaction ID

​
Request Body

All fields from the create request are optional. Only provide the fields you want to update.

​
Response

Returns the updated income transaction object.

​
Delete Income Transaction

curl -X DELETE https://api.kinconecta.com/api/income_transactions/123
Delete an income transaction by its ID.

​
Path Parameters

​
id
integer
required
The transaction ID

​
Response

Returns 204 No Content on successful deletion.

Build docs developers (and LLMs) love

Get started for freeTalk to us