Recover transaction using canonical merchant reference
curl --request GET \
--url https://api-staging.cashweb.cash/api/v1/partner/transactions/reference/{merchant_reference} \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api-staging.cashweb.cash/api/v1/partner/transactions/reference/{merchant_reference}"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api-staging.cashweb.cash/api/v1/partner/transactions/reference/{merchant_reference}', 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-staging.cashweb.cash/api/v1/partner/transactions/reference/{merchant_reference}",
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-staging.cashweb.cash/api/v1/partner/transactions/reference/{merchant_reference}"
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))
}HttpResponse<String> response = Unirest.get("https://api-staging.cashweb.cash/api/v1/partner/transactions/reference/{merchant_reference}")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-staging.cashweb.cash/api/v1/partner/transactions/reference/{merchant_reference}")
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{
"data": {
"amount": "161500.00",
"confirmations": null,
"confirmed_at": null,
"created_at": "2026-02-12T11:55:00Z",
"crypto_amount": "100.00",
"crypto_currency": "usdt",
"deposit_address": "TUr4xexampleaddress",
"deposit_id": null,
"deposit_status": null,
"expires_at": "2026-02-12T12:00:00Z",
"id": "01917f00-7b4c-7f56-8a2b-15998d58c9f3",
"merchant_id": "mrc_001",
"merchant_reference": "order-4551",
"network": "trc20",
"rate": "1615.00",
"received_at": null,
"required_confirmations": null,
"status": "awaiting_deposit",
"terminal_id": "term_01",
"updated_at": "2026-02-12T11:55:00Z"
},
"success": true
}{
"error": {
"code": "<string>",
"message": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Transaction not found",
"timestamp": "2026-02-12T12:00:00Z"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}Partner API
Recover transaction using canonical merchant reference
Recovery endpoint for partner timeout scenarios. Looks up a transaction by partner-scoped canonical merchant_reference and returns the same snapshot shape as GET /transactions/{id}.
GET
/
partner
/
transactions
/
reference
/
{merchant_reference}
Recover transaction using canonical merchant reference
curl --request GET \
--url https://api-staging.cashweb.cash/api/v1/partner/transactions/reference/{merchant_reference} \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api-staging.cashweb.cash/api/v1/partner/transactions/reference/{merchant_reference}"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api-staging.cashweb.cash/api/v1/partner/transactions/reference/{merchant_reference}', 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-staging.cashweb.cash/api/v1/partner/transactions/reference/{merchant_reference}",
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-staging.cashweb.cash/api/v1/partner/transactions/reference/{merchant_reference}"
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))
}HttpResponse<String> response = Unirest.get("https://api-staging.cashweb.cash/api/v1/partner/transactions/reference/{merchant_reference}")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-staging.cashweb.cash/api/v1/partner/transactions/reference/{merchant_reference}")
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{
"data": {
"amount": "161500.00",
"confirmations": null,
"confirmed_at": null,
"created_at": "2026-02-12T11:55:00Z",
"crypto_amount": "100.00",
"crypto_currency": "usdt",
"deposit_address": "TUr4xexampleaddress",
"deposit_id": null,
"deposit_status": null,
"expires_at": "2026-02-12T12:00:00Z",
"id": "01917f00-7b4c-7f56-8a2b-15998d58c9f3",
"merchant_id": "mrc_001",
"merchant_reference": "order-4551",
"network": "trc20",
"rate": "1615.00",
"received_at": null,
"required_confirmations": null,
"status": "awaiting_deposit",
"terminal_id": "term_01",
"updated_at": "2026-02-12T11:55:00Z"
},
"success": true
}{
"error": {
"code": "<string>",
"message": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Transaction not found",
"timestamp": "2026-02-12T12:00:00Z"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}Authorizations
Path Parameters
Partner merchant reference
Response
Transaction retrieved
Standard API response wrapper for all successful responses
Create partner transaction with canonical recovery reference
Previous
Retrieve partner transaction by transaction id
Next
⌘I