Skip to main content

Cấu hình cổng thanh toán

Để cổng thanh toán hoạt động chính xác và mang đậm dấu ấn thương hiệu của doanh nghiệp, bạn cần thực hiện cấu hình các thông số cơ bản trên Tingee Merchant Portal.

1. Truy cập trang cấu hình​

  1. Truy cập vào trang Nhà phát triển trên Tingee Merchant Portal (yêu cầu đăng nhập).
  2. Chọn tab Cấu hình thanh toán (Payment Gateway).

Truy cập trang cấu hình

2. Các thông số cần cấu hình​

Tại đây, bạn cần thiết lập các thông số sau để cổng thanh toán có thể hoạt động:

Các thông số cấu hình

2.1. Logo Cổng thanh toán​

  • Mô tả: Tải lên hình ảnh Logo của doanh nghiệp bạn. Logo này sẽ được hiển thị nổi bật trên giao diện thanh toán.
  • Quy định: Hỗ trợ định dạng JPG, PNG, kích thước tối đa 2MB. Tỷ lệ khuyến nghị là 1:1.

2.2. Tên thương hiệu hiển thị (*)​

  • Mô tả: Tên doanh nghiệp hoặc cửa hàng sẽ được hiển thị trên cổng thanh toán giúp khách hàng nhận diện.
  • Bắt buộc: Có.

2.3. Đường dẫn IPN (*)​

  • Mô tả: Đường dẫn (URL) máy chủ của bạn để Tingee gửi thông báo trạng thái giao dịch (Webhook).
  • Hoạt động: Hệ thống Tingee sẽ gửi dữ liệu đơn hàng (qua HTTP POST) về địa chỉ này mỗi khi có sự thay đổi trạng thái (Thành công, Hết hạn, Hủy). Đặc biệt, với giao dịch QR Tĩnh, nếu khách hàng chuyển khoản sau khi đơn hàng đã hết hạn/bị hủy, hệ thống vẫn sẽ đẩy Webhook ghi nhận trạng thái thực tế (Hết hạn-Thành công, Hủy-Thành công) hoặc các giao dịch chuyển đúp (Duplicate).
  • Bắt buộc: Có.
  • Lưu ý: URL phải là public và có thể truy cập được từ Internet (không dùng localhost). Trong quá trình phát triển, bạn có thể sử dụng các công cụ như webhook.site để giả lập nhận Webhook test.

2.4. Đường dẫn trả về (Return URL)​

  • Mô tả: URL (hoặc App Scheme) điều hướng khách hàng về lại web/app của bạn sau khi thanh toán xong.
  • Bắt buộc: Không (nếu có truyền returnUrl qua API Tạo link thanh toán thì hệ thống sẽ ưu tiên tham số truyền từ API).

2.5. Các Tài khoản cho phép thanh toán (*)​

  • Mô tả: Chọn các tài khoản sẽ hiển thị khi khách hàng thanh toán trên cổng.
  • Bắt buộc: Có.
  • Lưu ý quan trọng: Nên chọn Tài khoản ngân hàng có hỗ trợ QR Động (VietQR / Mã hóa linh hoạt). Nếu dùng QR Tĩnh, hệ thống sẽ phải quét theo nội dung chuyển khoản thủ công, rất dễ dẫn đến việc bị rớt đơn hàng do khách hàng nhập sai cú pháp.

3. Lưu cấu hình​

Sau khi điền đầy đủ và chính xác các thông tin, bấm Lưu. Hệ thống sẽ cập nhật ngay lập tức và các link thanh toán tạo ra sau đó sẽ tự động áp dụng cấu hình mới nhất này.

Copyright © 2026 TINGEE - Giải pháp thanh toán bởi HENO.