Nhảy đến nội dung

Tài khoản

Tài khoản thanh toán là cách để nhận tiền khi có đơn hàng. Bạn có thể tạo nhiều tài khoản cho các loại thanh toán khác nhau, chẳng hạn như kết nối hệ thống thanh toán hoặc thêm thanh toán bằng tiền mặt.

Các công cụ để làm việc với tài khoản nằm trong phần "Tài khoản" trong mục "Thanh toán". Các tài khoản thanh toán đã được tạo sẽ nằm trong danh sách chung. Dưới đây là mẫu để tạo tài khoản thanh toán mới.

Các loại tài khoản thanh toán.​

Hiện tại, hệ thống có hai loại tài khoản thanh toán để lựa chọn.

Stripe​

Nền tảng OneEntry hỗ trợ tích hợp với hệ thống thanh toán Stripe. Hãy chọn loại này nếu bạn muốn kết nối hệ thống thanh toán Stripe với dự án của mình. Chi tiết về cách kết nối Stripe với nền tảng OneEntry được đề cập tại đây.

Tùy chỉnh​

Nếu bạn muốn sử dụng một hệ thống thanh toán khác hoặc nhận thanh toán bằng tiền mặt, hãy sử dụng loại tài khoản thanh toán này.

Tạo tài khoản thanh toán​

Trong mẫu tạo tài khoản thanh toán, hãy chỉ định:

  • Tên - Chuỗi không duy nhất
  • Loại - Giá trị từ danh sách thả xuống.
  • Thẻ - Chuỗi duy nhất.

Sau khi điền đầy đủ thông tin, nhấn nút "Thêm". Nếu tất cả các trường được điền chính xác, tài khoản thanh toán sẽ được tạo và thêm vào danh sách chung.

Chỉnh sửa tài khoản thanh toán​

Chọn tài khoản thanh toán từ danh sách mà bạn muốn chỉnh sửa và nhấn vào biểu tượng chỉnh sửa Edit.

Trong chế độ chỉnh sửa, bạn có thể thay đổi:

  • Tên
  • Loại
  • Thẻ

Các thay đổi sẽ được lưu tự động.

Tham số tùy chỉnh cho API thanh toán​

Để tích hợp linh hoạt với các hệ thống thanh toán khác nhau (chẳng hạn như PayPal, Stripe và các hệ thống khác), bạn có thể thêm các tham số tùy chỉnh, đặc trưng cho API cụ thể vào tài khoản thanh toán.

Các tham số này được truyền dưới dạng cặp "khóa–giá trị" khi khởi tạo phiên thanh toán. Ví dụ, trong API Đơn hàng của PayPal thường yêu cầu các trường như purchase_units, intent, application_context.return_url hoặc payer.email_address, trong khi Stripe sử dụng các tham số khác, chẳng hạn như mode, line_items, v.v.

Cách hoạt động​

Ngoài các trường cơ bản (Tên, Loại, Thẻ), bạn sẽ thấy bảng “Tham số tùy chỉnh cho API thanh toán”. Bảng này là sự tổng hợp các tập hợp thuộc tính từ mô-đun Cài đặt, và cho phép thiết lập sự tương ứng giữa:

  • Thẻ (Tên tham số trong API) (chẳng hạn như purchase_units cho PayPal hoặc line_items cho Stripe)
  • Giá trị, sẽ được thay thế khi tạo thanh toán

Để thiết lập giá trị - bạn cần mở chỉnh sửa tập hợp, nhấn vào nút Edit. Sau đó chọn thuộc tính cần thiết từ tập hợp đã được cấu hình sẵn, và nhập giá trị cần thiết, theo đúng loại thuộc tính.

⚠️ Quan trọng: các tập hợp thuộc tính và nội dung của chúng được cấu hình riêng biệt và có thể bao gồm các trường khác nhau: chuỗi, số, giá trị boolean, JSON, v.v.

Ví dụ sử dụng với PayPal Giả sử bạn muốn truyền chi tiết đơn hàng vào PayPal qua trường purchase_units. Bạn tạo một tập hợp thuộc tính có tên “PayPal Purchase Unit”, thêm vào đó thuộc tính items loại JSON, chứa cấu trúc như sau:

    {
      "invoice_id": "90210",
      "amount": {
        "currency_code": "USD",
        "value": "230.00",
        "breakdown": {
          "item_total": {
            "currency_code": "USD",
            "value": "220.00"
          },
          "shipping": {
            "currency_code": "USD",
            "value": "10.00"
          }
        }
      },
      "items": [
        {
          "name": "Áo phông",
          "description": "Áo siêu mới",
          "unit_amount": {
            "currency_code": "USD",
            "value": "20.00"
          },
          "quantity": "1",
          "category": "HÀNG HÓA VẬT LÝ",
          "sku": "sku01",
          "image_url": "https://example.com/static/images/items/1/tshirt_green.jpg",
          "url": "https://example.com/url-to-the-item-being-purchased-1",
          "upc": {
            "type": "UPC-A",
            "code": "123456789012"
          }
        },
        {
          "name": "Giày",
          "description": "Chạy, Kích thước 10.5",
          "sku": "sku02",
          "unit_amount": {
            "currency_code": "USD",
            "value": "100.00"
          },
          "quantity": "2",
          "category": "HÀNG HÓA VẬT LÝ",
          "image_url": "https://example.com/static/images/items/1/shoes_running.jpg",
          "url": "https://example.com/url-to-the-item-being-purchased-2",
          "upc": {
            "type": "UPC-A",
            "code": "987654321012"
          }
        }
      ]
}

Sau đó, trong cài đặt tài khoản thanh toán, bạn liên kết:

Khóa: purchase_units Giá trị: thuộc tính items từ tập hợp “PayPal Purchase Unit” Khi tạo đơn hàng, hệ thống sẽ tự động thay thế giá trị hiện tại của thuộc tính này vào thân yêu cầu đến API PayPal.

Các tham số thường được sử dụng khác của PayPal:

intent — chẳng hạn như "CAPTURE" hoặc "AUTHORIZE" application_context.return_url — URL để quay lại sau khi thanh toán thành công application_context.cancel_url — URL hủy thanh toán

Cơ chế này cho phép điều chỉnh các tích hợp thanh toán theo bất kỳ yêu cầu cụ thể nào của API bên ngoài mà không cần thay đổi mã của nền tảng.

Ẩn tài khoản thanh toán​

Nếu bạn không muốn sử dụng tài khoản thanh toán nữa và không thể xóa nó vì nó đã được sử dụng trong dự án, bạn có thể ẩn nó.

Để làm điều này, trên tài khoản đã chọn, nhấn vào biểu tượng "mắt" Edit.

Các tài khoản thanh toán đã ẩn sẽ không được hệ thống đề xuất để lựa chọn khi thiết lập kho đơn hàng.

Xóa tài khoản thanh toán​

Chọn tài khoản thanh toán từ danh sách mà bạn muốn xóa và nhấn vào biểu tượng xóa Edit.

Xác nhận hành động trong hộp thoại. Sau đó, tài khoản thanh toán sẽ bị xóa và biến mất khỏi danh sách chung.