Check Transaction Status

curl --request GET \
  --url https://api.bluswap.co/api/v1/transactions/payin/status \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.bluswap.co/api/v1/transactions/payin/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bluswap.co/api/v1/transactions/payin/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.bluswap.co/api/v1/transactions/payin/status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bluswap.co/api/v1/transactions/payin/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "status": "<string>",
  "status_code": "<string>",
  "amount": "<string>",
  "status_description": "<string>",
  "payment_mode": "<string>",
  "account_type": "<string>",
  "card_network": "<string>",
  "RRN": "<string>"
}

Use this endpoint to verify the final state of a payment. Call it after initiating a transaction to confirm whether funds were successfully captured. The response includes the payment method used, the source account type, and, for UPI transactions, the bank’s Retrieval Reference Number (RRN).

Request Header

string

required

Your merchant secret key.

Query Parameter

string

required

The order ID you provided when initiating the collection.

Sample Request

curl --get 'https://api.bluswap.co/api/v1/transactions/payin/status' \
  --header 'x-api-key: YOUR_SECRET_KEY' \
  --data-urlencode 'order_id=YOUR_ORDER_ID'

const response = await fetch(
  'https://api.bluswap.co/api/v1/transactions/payin/status?order_id=YOUR_ORDER_ID',
  {
    method: 'GET',
    headers: {
      'x-api-key': 'YOUR_SECRET_KEY'
    }
  }
);
console.log(await response.json());

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.bluswap.co/api/v1/transactions/payin/status?order_id=YOUR_ORDER_ID"))
    .header("x-api-key", "YOUR_SECRET_KEY")
    .GET()
    .build();
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

import requests

response = requests.get(
    "https://api.bluswap.co/api/v1/transactions/payin/status",
    headers={"x-api-key": "YOUR_SECRET_KEY"},
    params={"order_id": "YOUR_ORDER_ID"},
)
print(response.json())

request, err := http.NewRequest(http.MethodGet, "https://api.bluswap.co/api/v1/transactions/payin/status?order_id=YOUR_ORDER_ID", nil)
if err != nil { panic(err) }
request.Header.Set("x-api-key", "YOUR_SECRET_KEY")
response, err := http.DefaultClient.Do(request)
if err != nil { panic(err) }
defer response.Body.Close()

<?php
$curl = curl_init('https://api.bluswap.co/api/v1/transactions/payin/status?order_id=YOUR_ORDER_ID');
curl_setopt_array($curl, [
    CURLOPT_HTTPHEADER => ['x-api-key: YOUR_SECRET_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

require "net/http"

uri = URI("https://api.bluswap.co/api/v1/transactions/payin/status?order_id=YOUR_ORDER_ID")
request = Net::HTTP::Get.new(uri, {"x-api-key" => "YOUR_SECRET_KEY"})
puts Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request).body }

Response

Examples

Card Payment Success
UPI / QR Success
Failure
Initiated

{
    "status": "SUCCESS",
    "status_code": "200",
    "amount": "10.00",
    "status_description": "Transaction completed successfully",
    "account_type": "DEBIT_CARD",
    "card_network": "VISA",
    "payment_mode": "DEBIT_CARD"
}

{
    "status": "SUCCESS",
    "status_code": "200",
    "amount": "10.00",
    "status_description": "Transaction completed successfully",
    "account_type": "SAVINGS",
    "card_network": "N/A",
    "payment_mode": "QR",
    "RRN": "605800410630"
}

{
    "status": "FAILED",
    "status_code": "200",
    "amount": "10.00",
    "status_description": "Transaction failed: TXN NOT COMPLETED",
    "account_type": "N/A",
    "card_network": "N/A",
    "payment_mode": "QR",
    "RRN": null
}

{
    "status": "INITIATED",
    "status_code": "200",
    "amount": "10.00",
    "status_description": null,
    "account_type": "N/A",
    "card_network": "N/A",
    "payment_mode": "DEBIT_CARD",
    "RRN": null
}

Response Fields

String

Terminal state of the transaction. One of SUCCESS, FAILED, or INITIATED.

String

Numeric status indicator (e.g., 200).

String

The exact amount captured for this transaction (e.g., 10.00).

String

Human-readable message describing the outcome of the transaction.

String

The payment method used. Possible values: QR, DEBIT_CARD, CREDIT_CARD, VPA, INTENT.

String

Source account type from which the payment was made (e.g., SAVINGS, DEBIT_CARD).

String

The card network provider (e.g., VISA, MASTERCARD). Returns N/A for UPI transactions.

String

Retrieval Reference Number the bank’s unique identifier for this transaction. Populated for successful UPI transactions only.

Treat an initiated payment as pending. Fulfil the order only after receiving a SUCCESS status via webhook or the status endpoint.

Check Transaction Status

curl --request GET \
  --url https://api.bluswap.co/api/v1/transactions/payin/status \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.bluswap.co/api/v1/transactions/payin/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bluswap.co/api/v1/transactions/payin/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.bluswap.co/api/v1/transactions/payin/status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bluswap.co/api/v1/transactions/payin/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "status": "<string>",
  "status_code": "<string>",
  "amount": "<string>",
  "status_description": "<string>",
  "payment_mode": "<string>",
  "account_type": "<string>",
  "card_network": "<string>",
  "RRN": "<string>"
}

Get Started

Collections

Payouts

Refunds

Check Transaction Status

Request Header

Query Parameter

Sample Request

Response

Examples

Response Fields

​Request Header

​Query Parameter

​Sample Request

​Response

​Examples

​Response Fields

Request Header

Query Parameter

Sample Request

Response

Examples

Response Fields