---
sourceType: api-reference
sourceTypeMatchedRule: api-prefix
slug: TS/apis/callback
title: Webhook nhận kết quả thanh toán
---
Merchant thiết lập Webhook để nhận kết quả thanh toán từ Transfer Service. Khi Transfer Service nhận trạng thái thanh toán từ ngân hàng, hệ thống sẽ gọi URL này để thông báo kết quả cho Merchant.

- **URL**: `https://your-webhookurl.com`
- **Method**: `POST`
- **Response Type**: `application/json`

### Request body

Transfer Service gửi body dạng **JSON** chứa đầy đủ thông tin giao dịch, cấu trúc tương tự response của [API truy vấn trạng thái giao dịch](/docs/TS/apis/queryOrder). Merchant **nên xác thực chữ ký** (`signature`) trước khi xử lý để đảm bảo request đến từ Transfer Service.

### Sample callback payload

```json
{
  "merchant_order_id": "251125_004904618",
  "ts_order_id": "1ea9544268078159d816",
  "created_time": 1764056578002,
  "order_time": 1764056578002,
  "expire_time": 1764057778002,
  "updated_time": 1764056609139,
  "bank_code": null,
  "amount": 50000,
  "description": "Nap DT 251125004904618",
  "embed_data": "{}",
  "qr_data": "0002010102123857....",
  "paid_amount": 50000,
  "paid_time": 1764056608000,
  "transaction_detail": "QAAUMI9446  ZTRANS47 4 59ee13.....",
  "status": "PAID",
  "status_code": 2,
  "signature": "5d592031dba0c9....",
  "app_id": "726e9484a8c1419f18d0",
  "timestamp": 1764056609169
}
```