Tham chiếu · API máy chủ
POST /api/v1/payments
Báo kết quả charge — nửa còn lại của phát hiện thử thẻ.
Báo kết quả của một lần charge. Đây là nửa còn lại của phát hiện thử thẻ.
POST /api/v1/payments
Vì sao nó bắt buộc#
Số lần bị từ chối là một trong ba phép đo của mô hình thử thẻ, và bên duy nhất biết nó là cổng thanh toán của bạn.
Cho tới khi site của bạn báo kết quả đầu tiên, số lần bị từ chối là chưa đo, không phải 0, và quy tắc paymentDeclines không bao giờ kích hoạt được cho site đó. Một site không bao giờ báo kết quả không phải một site có thẻ không bao giờ bị từ chối.
Yêu cầu#
{ "attemptId": "<từ phản hồi verdict>", "outcome": "declined" }outcome là "approved" hoặc "declined". attemptId lấy từ payment.attemptId trong phản hồi của POST /api/v1/verdict.
Xác thực#
Khoá bí mật của site, qua x-api-key. Không gửi header CORS: một trình duyệt tự báo kết quả của chính nó sẽ báo "approved".
Mã trả về#
| Mã | Nghĩa |
|---|---|
200 | Đã ghi nhận |
400 | Body không đúng dạng |
401 | Khoá sai hoặc thiếu |
404 | Không tìm thấy lần thử đó |
503 | Lịch sử thanh toán chưa được cấu hình |
404 cũng là câu trả lời cho một attemptId thuộc site khác, nên khoá bí mật của một khách hàng không dò được ID của khách hàng khác.
Trường `card` là gì#
Fingerprint thẻ của cổng thanh toán, hoặc một hash do bạn tự tính. Tuyệt đối không phải số thẻ.
Bất cứ chuỗi nào chứa một dãy 13-19 chữ số qua được kiểm tra Luhn sẽ bị từ chối với 400 trước khi nó được hash, ghi log hay lưu lại. Một lần từ chối nhầm tốn của người tích hợp một thông báo lỗi rõ ràng ngay ngày đầu; một lần chấp nhận nhầm tốn một phạm vi PCI.
Token được lưu chỉ dưới dạng SHA-256 có muối theo site, nên cùng một thẻ ở hai khách hàng là hai khoá không liên hệ gì nhau.