Query Cashback Detail

Query the cashback detail for a specific card reward order, including point amount, cashback value, currency, and order status.

HTTP Request

POST/v5/card/reward/point/cashback/detail

Request Parameters

Parameter	Required	Type	Comments
bizTxnId	true	string	Order ID

Response Parameters

Parameter	Type	Comments
retCode	integer	Business return code. 0: success; non-zero: failure
retMsg	string	Return message
result	object
> points	string	Point amount
> amt	string	Cashback amount
> ccy	string	Currency
> ccyType	string	Currency type. FIAT: fiat currency, CRYPTO: crypto currency
> createTime	string	Creation time
> bizTxnId	string	Order ID
> sourceId	integer	Coupon/voucher ID
> sourceCode	string	External order ID
> orderStatus	integer	Order status
> orderSubStatus	integer	Order sub-status
> orderShowStatus	string	Display status. NO_PAY: Unpaid, ORDER_PENDING_SHOW: Pending, ORDER_SUCCESS: Success, ORDER_FAIL: Failed
> failedBizCode	string	Failure reason code

---

Request Example

HTTP

POST /v5/card/reward/point/cashback/detail?bizTxnId=TXN20230101001 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672211918471
X-BAPI-RECV-WINDOW: 5000

Python

import requests

url = "https://api-testnet.bybit.com/v5/card/reward/point/cashback/detail"
headers = {
    "X-BAPI-API-KEY": "xxxxxxxxxxxxxxxxxx",
    "X-BAPI-SIGN": "XXXXX",
    "X-BAPI-TIMESTAMP": "1672211918471",
    "X-BAPI-RECV-WINDOW": "5000"
}
params = {
    "bizTxnId": "TXN20230101001"
}
response = requests.post(url, headers=headers, params=params)
print(response.json())

Node.js

const axios = require('axios');

const url = 'https://api-testnet.bybit.com/v5/card/reward/point/cashback/detail';
const headers = {
  'X-BAPI-API-KEY': 'xxxxxxxxxxxxxxxxxx',
  'X-BAPI-SIGN': 'XXXXX',
  'X-BAPI-TIMESTAMP': '1672211918471',
  'X-BAPI-RECV-WINDOW': '5000'
};
const params = { bizTxnId: 'TXN20230101001' };

axios.post(url, {}, { headers, params })
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "points": "500",
        "amt": "1.00",
        "ccy": "USDT",
        "ccyType": "CRYPTO",
        "createTime": "2023-01-01 12:00:00",
        "bizTxnId": "TXN20230101001",
        "sourceId": 12345,
        "sourceCode": "ORD20230101001",
        "orderStatus": 1,
        "orderSubStatus": 0,
        "orderShowStatus": "ORDER_SUCCESS",
        "failedBizCode": ""
    },
    "retExtInfo": {},
    "time": 1672211918471
}