Lỗi và tên sự kiện API Quyết định
Xử lý trạng thái HTTP trước khi giải thích một quyết định. URL thay đổi tài khoản sử dụng dấu gạch nối, trong khi sự kiện JSON là account_change. Các mã 401, 409, 422, 429 hoặc 503 chỉ ra xử lý yêu cầu, ủy quyền hoặc dịch vụ; đó không phải là kết quả cho phép/xem xét/từ chối.
Xác thực và tuyến dịch vụ
401 có nghĩa là khóa được cấu hình bị thiếu/không chính xác hoặc tài khoản thử nghiệm không thể xác thực. 409 ở chế độ thử nghiệm có nghĩa là sự kiện không có tuyến dịch vụ được phê duyệt. Các ID nhà cung cấp do khách hàng chọn không xác định hoặc không được phê duyệt sẽ trả về 422. Yêu cầu tuyến dịch vụ được phê duyệt không bỏ qua xác thực tài khoản.
Xác thực và ánh xạ sự kiện
Sử dụng onboarding/onboarding, payout/payout và account-change/account_change cho các cặp URL/body. Sự không khớp path/body và các schema không hợp lệ sẽ trả về 422. Các trường chủ đề tùy chọn không có nghĩa là mọi nhà cung cấp đều có thể hoạt động mà không có các định danh bắt buộc. Các đường dẫn sự kiện không xác định phải thất bại trong quá trình xác thực thay vì thực hiện một sự kiện khác.
Giới hạn tốc độ và tình trạng không khả dụng
429 báo hiệu giới hạn tốc độ thử nghiệm có kiểm soát. 503 có thể có nghĩa là khóa sản xuất bị thiếu, thử nghiệm có kiểm soát được cấu hình không chính xác hoặc nhà cung cấp upstream không khả dụng. Sử dụng chi tiết phản hồi để chẩn đoán tình trạng bên trong, sau đó tuân theo quy trình thử lại có giới hạn của người gọi hoặc quy trình xem xét. Việc truy xuất dấu vết sản xuất vẫn không khả dụng theo mặc định.
Nguồn và phạm vi
Dựa trên hợp đồng alpha và triển khai nguồn. Tính khả dụng của tuyến dịch vụ trực tiếp yêu cầu xác nhận riêng.