Thực thể không thể xử lý

Khi không thể hoàn tất yêu cầu thanh toán của bạn do thông tin không chính xác hoặc vi phạm quy tắc kinh doanh. Các vấn đề sau đây có thể trả về lỗi UNPROCESSABLE_ENTITY.

Lưu ý: Nếu vấn đề vẫn tiếp diễn hoặc nếu bạn có thêm thắc mắc, bạn có thể liên hệ với paypal-techsupport.com.

DUPLICATE_INVOICE_ID Trả hàng từ API Thanh toán v1 hoặc Đơn hàng v2.

Nguyên nhân
PayPal phát hiện ID hóa đơn trùng lặp. Mỗi giao dịch cần một invoice_id duy nhất để ngăn chặn các giao dịch trùng lặp. Điều này thường xảy ra khi cùng một số đơn đặt hàng được sử dụng cho nhiều giao dịch.

Tác động
Quá trình thanh toán dừng lại, khiến khách hàng của bạn không thể hoàn tất giao dịch mua của họ. Điều này có thể dẫn đến mất doanh số.

Giải pháp
Sử dụng số ID hóa đơn khác nhau cho mỗi giao dịch. Nếu bạn cần sử dụng cùng một ID hóa đơn nhiều lần, hãy liên hệ với bộ phận hỗ trợ PayPal. Cân nhắc thiết lập Thông báo thanh toán tức thời (IPN) hoặc webhook để nhận thông tin cập nhật theo thời gian thực về các giao dịch.

ORDER_ALREADY_AUTHORIZED Trả hàng từ API Thanh toán v2 hoặc Đơn hàng v2.

Nguyên nhân
Đơn hàng đã được ủy quyền thông qua yêu cầu trước đó. Khi một đơn hàng được tạo với intent="AUTHORIZE", chỉ cho phép một ủy quyền. Lần thử thứ hai sẽ bị từ chối. Điều này có thể xảy ra nếu bạn vô tình gửi cùng một yêu cầu hai lần hoặc nếu bạn bỏ lỡ việc thấy rằng yêu cầu đầu tiên đã thành công.

Tác động
Không ảnh hưởng đến ủy quyền ban đầu. Chỉ lần thử thứ hai bị từ chối. Bạn không thể ủy quyền một phần số tiền ngay bây giờ và ủy quyền phần còn lại sau.

Giải pháp
Ủy quyền toàn bộ số tiền trong một yêu cầu, sau đó tạo nhiều ảnh chụp nếu cần. Tạo nhiều ảnh chụp bằng cách đặt final_capture = "false" trong các yêu cầu chụp của bạn. Điều này rất hữu ích cho việc chia nhỏ các lô hàng. Cân nhắc tích hợp webhook PayPal để tự động nhận thông tin cập nhật về trạng thái đơn hàng. Nếu các lệnh gọi API mất quá nhiều thời gian, hãy liên hệ với bộ phận hỗ trợ kỹ thuật PayPal.

ORDER_ALREADY_CAPTURED Trả về từ API Đơn hàng v2.

Nguyên nhân
Đơn hàng PayPal đã ở trạng thái "đã chấp nhận thanh toán", nghĩa là đã hoàn tất thanh toán và tiền đã được chuyển vào tài khoản của bạn. Không có ảnh chụp mới nào có thể được tạo theo thứ tự này. Điều này xảy ra nếu bạn đang sử dụng intend="SALE" chỉ cho phép chụp một lần cho mỗi đơn hàng hoặc nếu hệ thống của bạn không ghi lại sự thành công của lần chụp đầu tiên và thử lại.

Tác động
Nếu bạn chỉ nắm bắt được một phần số tiền đặt hàng, bạn không thể nắm bắt số tiền còn lại trừ khi bạn tạo một đơn đặt hàng PayPal mới. Không có tác động đến khách hàng của bạn nếu bạn chỉ có ý định chụp một lần, nhưng hệ thống của bạn có thể không đồng bộ với hồ sơ của PayPal.

Độ phân giải
Nếu bạn muốn chụp nhiều lần, hãy sử dụng intent="AUTHORIZE" thay vì intent="SALE". Thao tác này sẽ tạo ủy quyền trước, cho phép chụp nhiều lần sau. Đảm bảo thông số final_capture được đặt thành false trong lệnh gọi API thanh toán được ủy quyền chấp nhận thanh toán của bạn để cho phép chấp nhận thêm thông tin. Sử dụng i nvoice_id duy nhất cho mỗi lần chụp. Theo dõi các phản hồi API thành công để tránh các lệnh gọi trùng lặp. Cân nhắc sử dụng webhook PayPal để nhận cập nhật tự động về thay đổi trạng thái thanh toán.

ORDER_NOT_APPROVED Trả hàng từ API Thanh toán v1 hoặc Đơn hàng v2.

Nguyên nhân
Khách hàng của bạn đã bắt đầu nhưng không hoàn tất quy trình thanh toán PayPal hoặc yêu cầu có thể thiếu thông tin thanh toán bắt buộc.

Tác động
Khoản thanh toán bị từ chối và không được xử lý, gây ra sự chậm trễ trong giao dịch mua.

Giải pháp
Đảm bảo khách hàng của bạn được chuyển hướng đến URL "rel":"approve" mà PayPal cung cấp khi bạn tạo đơn hàng. Thao tác này sẽ đưa họ đến quy trình thanh toán PayPal để phê duyệt khoản thanh toán. Đảm bảo yêu cầu của bạn bao gồm tất cả thông tin thanh toán bắt buộc.

SHIPPING_ADDRESS_INVALID Trả hàng từ API Thanh toán v1 hoặc Đơn hàng v2.

Nguyên nhân
Khách hàng có thể đã bỏ lỡ các trường địa chỉ quan trọng như địa chỉ đường phố, thành phố hoặc tiểu bang. Định dạng địa chỉ có thể không chính xác hoặc hệ thống của bạn có thể không gửi chính xác địa chỉ đầy đủ trong yêu cầu.

Tác động
Khoản thanh toán bị từ chối và không được xử lý, gây ra sự chậm trễ trong giao dịch mua.

Giải pháp
Thêm xác thực biểu mẫu để đảm bảo tất cả các trường địa chỉ bắt buộc được hoàn thành chính xác trước khi gửi. Cân nhắc sử dụng các công cụ xác thực địa chỉ để đảm bảo địa chỉ tuân theo định dạng chính xác. Kiểm tra hệ thống của bạn để đảm bảo tất cả thông tin địa chỉ đang được nắm bắt chính xác và được bao gồm trong yêu cầu của bạn.