Skip to content

Hướng dẫn cấu hình cổng thanh toán SePay

Phan Tấn Dũng edited this page Nov 12, 2023 · 2 revisions
  1. Bạn làm việc với SePay để đăng ký sử dụng dịch vụ và được cấp tài khoản. Sau đó đọc các hướng dẫn của SePay để biết cách thêm ngân hàng vào
  2. Truy cập menu Tích hợp WebHooks để tiến hành thêm mới. Bạn nhập các thông số theo nhu cầu, trong đó chú ý một số mục sau:
    • Bắn WebHooks khi > Có tiền vào
    • Bỏ qua nếu nội dung giao dịch không có Code thanh toán? > Không
    • Thuộc tính WebHooks > Gọi đến URL > https://domaincuaban.com/sepay-webhooks.php
    • Là WebHooks xác thực thanh toán? > Đúng
    • Cấu hình chứng thực WebHooks > Kiểu chứng thực > API Key
    • Request Content type > multipart/form-data
    • API Key > Bạn nhập chuỗi bất kỳ khoảng 32 ký tự và giữ bí mật chuỗi này.
    • Trạng thái > Kích hoạt và nhấp lưu
  3. Truy cập quản trị website quyền tối cao vào mục cổng thanh toán. Ấn tích hợp cổng SePay và nhập các thông tin cần thiết. Chú ý một số thông số sau:
    • Danh sách ID ngân hàng thanh toán > Nhập cách nhau dấu phảy mã ngân hàng. Bạn có thể lấy mã ngân hàng từ đây. Bạn truy cập trang đó và tìm mã "bin" ứng với ngân hàng của bạn.
    • Danh sách số tài khoản thụ hưởng > Bạn nhập số tài khoản phân cách nhau bởi dấu phảy. Đây là số tài khoản nhận tiền mà khách sẽ chuyển khoản.
    • Danh sách tên tài khoản ngân hàng > Tên chủ tài khoản tương ứng, phân cách bởi dấu phảy. Lưu ý mỗi tên chỉ nhập tiếng Việt không dấu, viết hoa, tối thiểu 5 ký tự, tối đa 50 kí tự, không chứa các ký tự đặc biệt.
    • Chi nhánh ngân hàng > Danh sách đầy đủ tên và chi nhánh ngân hàng tương ứng, phân cách bởi dấu chấm phảy (;)
    • IP SePay > Nhập IP của bên SePay sẽ bắn webhook sang website của bạn. Bạn có thể liên hệ SePay để lấy danh sách các IP. Nếu bạn không nhập thì hệ thống sẽ chấp nhận mọi IP.
    • Mã bí mật > Nhập mã API Key bạn đã cấu hình ở bước số 2
    • Lưu ý: Các bước trên bạn cần phải nhập đầy đủ và đúng thứ tự nếu có nhiều hơn một số tài khoản nhận chuyển khoản.
  4. Upload file sepay-webhooks.php vào thư mục gốc của website, ngang hàng với index.php
  5. Truy cập cấu hình > Thiết lập an ninh > Cấu hình CSP nhập thêm api.vietqr.io vào mục img-src