kamiPay LogokamiPay Docs

Tx Status Lot

Query multiple transaction statuses within a time period

This is an endpoint specific for certain type of integrations. It allows the user to check all confirmed charge transactions in a given time period up to 24 hours range per request. It's only available for Charge Service at this point and it'll return a list with a dictionary inside providing all the information for each of the different payments received including external_reference key for validations.

Path Parameters

NameTypeDescription
store_idint[]Optional. You can pass a list of integers [1, 2, 3] to identify store. If not provided it's assume all.
checkout_idint[]Optional. You can pass a list of integers [1, 2, 3] to identify checkout. If not provided it's assume all.
startEPOCHOptional. Starting point of the selected time period.
endEPOCHOptional. End of the selected time period.

Example Request

const store_id = [1, 2, 3]
const checkout_id = [1, 2, 3]
const start = 1718472442
const end = 1718418515

const url = `${baseURL}/v2/status/tx_status_lot?store_id=${store_id}&checkout_id=${checkout_id}&start=${start}&end=${end}`

const response = await fetch(url, {
    method: "GET",
    headers: {
      Authorization: `Bearer ${access_token}`,
      "Content-Type": "application/json",
    },
});
import requests

store_id = [1, 2, 3]
checkout_id = [1, 2, 3]
start = 1718472442
end = 1718418515

url = f"{base_url}/v2/status/tx_status_lot?store_id={store_id}&checkout_id={checkout_id}&start={start}&end={end}"

headers = {
    'Authorization': f'Bearer {access_token}',
    'Content-Type': 'application/json',
}

response = requests.get(url, headers=headers)
package main

import (
  "fmt"
  "net/http"
  "strings"
)

func main() {
  storeIds := []string{"1", "2", "3"}
  checkoutIds := []string{"1", "2", "3"}
  start := 1718472442
  end := 1718418515
  
  url := fmt.Sprintf("%s/v2/status/tx_status_lot?store_id=%s&checkout_id=%s&start=%d&end=%d", 
                    baseURL, 
                    strings.Join(storeIds, ","), 
                    strings.Join(checkoutIds, ","),
                    start,
                    end)
  
  // Create request
  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", fmt.Sprintf("Bearer %s", access_token))
  req.Header.Add("Content-Type", "application/json")
  
  // Make the request
  client := &http.Client{}
  resp, err := client.Do(req)
  if err != nil {
    fmt.Println("Error making request:", err)
    return
  }
  defer resp.Body.Close()
}

Response

[
  {
    "store_id": "1",
    "checkout_id": "1",
    "operation_id": "1718462463281",
    "tx_hash": "txid5",
    "brl_requested": "25.00",
    "usdt_credited": "5.00000",
    "external_data": "Factura 6",
    "request_datetime": "1718472442.872",
    "credit_datetime": "1718472443.872"
  },
  {
    "store_id": "1",
    "checkout_id": "1",
    "operation_id": "1718399849145",
    "tx_hash": "txid1",
    "brl_requested": "150.00",
    "usdt_credited": "20.00000",
    "external_data": "Factura 2",
    "request_datetime": "1718418514.401",
    "credit_datetime": "1718418515.401"
  }
]
{
  "detail": "Endpoint Not Authorized"
}
{
  "detail": "end - start has to be >0 and <24 hrs"
}
{
  "detail": "an unexpected error occurred"
}

This endpoint is limited to returning transactions within a 24-hour period. For longer time ranges, make multiple requests with different start/end periods.

On this page