Payment Method
Định nghĩa
Payment Method mô tả cách khách hàng muốn trả tiền: thẻ, tài khoản ngân hàng, ví điện tử, chuyển khoản địa phương, QR code hoặc một scheme thanh toán cụ thể.
Cách hiểu bằng lời của tôi
Trong thiết kế API thanh toán tốt, “cách trả tiền” nên tách khỏi “giao dịch đang cần thu bao nhiêu tiền”. Payment Method chứa thông tin tĩnh hoặc bán tĩnh về instrument, còn Payment Intent giữ trạng thái của transaction.
Vì sao cần tách abstraction
- Một người dùng có thể thử nhiều payment method cho cùng một đơn hàng.
- Mỗi payment method có vòng đời khác nhau: thẻ có thể đồng bộ, ví điện tử cần redirect, QR cần webhook, bank debit có thể mất nhiều ngày.
- Nếu nhét tất cả vào một object charge/source, API dễ trở thành state machine khó hiểu.