Single transcation

Tulu Switch provides a search transaction column for users to search for specific transactions.

To access information about a specific transaction from the Tulu Switch API, you can use a POST request to the transaction endpoint. Below is an example employing cURL:

Request payload

Name

Type

Description

start_date

string

The start date for filtering transactions (in YYYY-MM-DD format).

end_date

string

The end date for filtering transactions (in YYYY-MM-DD format).

channel

string

The payment channel used (e.g., fiat)

currency

string

The currency for the transaction. Supported currencies {ngn,usd,kes,cad}


    let headersList = {
        "Accept": "/",
        "User-Agent": "Thunder Client (https://www.thunderclient.com)",
        const myHeaders = new Headers();
myHeaders.append("Authorization",Bearer token", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpX
VCJ9.eyJyb2xlaWQiOiI2NDEiLCJ1c2VySWQiOiI4Y2Q3NjQ0ZC1mYzNmLT

       let bodyContent = JSON.stringify({
         "start_date": "2024-01-23",
         "end_date": "2024-03-22",
         "Channel": "fiat",
         "currency": "ngn"
       });

       let response = await fetch("https://api.switch.tulupay.com/v1/transactions/history
       /a6bfa7ed-e3f9-4d0f-87c1-098918c4020d/ngn", {
         method: "POST",
         body: bodyContent,
         headers: headersList
       });

       let data = await response.text();
       console.log(data);

   

Request details

  • Endpoint:`https://api.switch.tulupay.com/v1/transactions/history/9a468616-4cd7-4ce7-9fcb-5f4090442891/currency`
  • Method:`GET`
  • Headers:
  • Content-Type:`application/json`
  • Authorization:`Bearer token`
  • Response details

    After a successful response, you'll receive a simple JSON object with single transaction . Here's an example:

    
        {
            "status": "success",
            "statusCode": "00",
            "data": [
              {
                "transaction_id": "a6bfa7ed-e3f9-4d0f-87c1-098918c40
                20d.a45100d0-5849-4236-8998-a02f2c86bd8a",
                "source_acct": "ade@gmail.com",
                "destination_acct": "dele@gmail.com",
                "recipient_name": "desire adeyemo",
                "response_code": "00",
                "response_message": "Success",
                "trans_type": "transfer",
                "transaction_desc": "school fees",
                "transaction_amount": "100",
                "initial_balance": "800000",
                "current_balance": "799800",
                "created": "2024-03-22 13:30:14"
              },
              {
                "transaction_id": "a6bfa7ed-e3f9-4d0f-87c1-098918c
                4020d.8759434c-49a7-4708-9e4d-09f379d857a3",
                "source_acct": "ade@gmail.com",
                "destination_acct": "dele@gmail.com",
                "recipient_name": "desire adeyemo",
                "response_code": "00",
                "response_message": "Success",
                "trans_type": "transfer",
                "transaction_desc": "school fees",
                "transaction_amount": "500",
                "initial_balance": "799800",
                "current_balance": "799700",
                "created": "2024-03-22 13:30:22"
              },
              {
                "transaction_id": "a6bfa7ed-e3f9-4d0f-87c1-098918c
                4020d.bbd5beca-ed20-49e9-ba62-7c46855c31fd",
                "source_acct": "ade@gmail.com",
                "destination_acct": "dele@gmail.com",
                "recipient_name": "desire adeyemo",
                "response_code": "00",
                "response_message": "Success",
                "trans_type": "transfer",
                "transaction_desc": "school fees",
                "transaction_amount": "200",
                "initial_balance": "0",
                "current_balance": "800000",
                "created": "2024-03-22 13:30:5"
              }
            ],
            "transaction_status": {
              "total_transaction": 3,
              "last_week_transaction": 0,
              "this_week_transaction": 0
            }
          }
        

    Contact Us for Developer Support

    Contact our dedicated developer support team for assistance, guidance, or any questions you have regarding Tuluswitch API integration. We're here to ensure your development experience is smooth and successful.

    Read Our Developer FAQ for Insights

    Master the Tuluswitch API with our Developer Blog! Get expert insights, advanced tips, and industry trends beyond the documentation. Stay connected with the developer community to build exceptional payment platforms. Visit the blog now and unlock your full potential!