Tài khoản
Tài khoản thanh toán là cách để nhận thanh toán khi đặt 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 các 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ó một số 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. 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 thảo luận tại đây.
Midtrans
Nền tảng OneEntry hỗ trợ tích hợp với hệ thống thanh toán Indonesia Midtrans. Chi tiết về cách kết nối Midtrans được thảo luận tại đây.
Xendit
Nền tảng OneEntry hỗ trợ tích hợp với hệ thống thanh toán Xendit. Chi tiết về cách kết nối Xendit được thảo luận 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. Chỉ có thể tạo một tài khoản với các loại Stripe, Midtrans và Xendit cho mỗi dự án; có thể có bao nhiêu tài khoản với loại Tùy chỉnh tùy thích.
- Mã - 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 
.
Trong chế độ chỉnh sửa, bạn có thể thay đổi:
- Tên
- Loại
- Mã
Các tài khoản Stripe, Midtrans và Xendit trong chế độ chỉnh sửa cũng có các cài đặt kết nối với hệ thống thanh toán. Chúng được mô tả trên các trang Stripe, Midtrans và Xendit.
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 (ví dụ: 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 thù cho từng API 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 PayPal Orders API 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.v.
Cách hoạt động
Ngoài các trường cơ bản (Tên, Loại, Mã), bạn sẽ thấy bảng “Tham số tùy chỉnh cho API thanh toán”. Trong bảng hiển thị các tập hợp thuộc tính từ phần Cài đặt → Thuộc tính. Bảng cho phép bạn thiết lập sự tương ứng giữa:
- Mã (Tên tham số trong API) (ví dụ:
purchase_unitscho PayPal hoặcline_itemscho 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 
. 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à các loại khác.
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 thun",
"description": "Áo thun siêu đẹp",
"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": "Giày 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 PayPal API.
Các tham số thường được sử dụng khác của PayPal:
intent — ví dụ, "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 yêu cầu của các API bên ngoài.
Ẩ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" 
.
Các tài khoản thanh toán bị ẩn sẽ không được hệ thống đề xuất để lựa chọn khi cấu hình 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 
.
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.