Refund API

Ask AI

Hợp đồng Endpoint

Khởi tạo hoàn tiền cho một giao dịch đã hoàn thành.

POST /v2/refundapplication/jsonYêu cầu chữ ký

Request

Trường	Kiểu	Bắt buộc	Mô tả
transactionId	String (ULID)	M	ID giao dịch GLODIPAY gốc.
amount	Float	M	Số tiền hoàn trả. Tối thiểu 0.10 và bị giới hạn bởi số tiền còn lại có thể hoàn trả.
reason	String(max:1000)	O	Lý do hoàn tiền ngắn gọn.
signature	String(max:750)	M	Chữ ký RSA-MD5.

Phản hồi

Một phản hồi thành công trả về status, message, và một đối tượng data chứa refundId và refundNumber. Các lỗi xác thực trả về HTTP 422 với status: error và một mảng errors.

Hoàn tiền được xử lý tự động: message là null.

Đang chờ phê duyệt: message là "Refund created and waiting for approval."

Lưu ý: Một số nhà cung cấp (PayAgency, SmartPay, ClisaPay, FinvyPay, WPay) chỉ hỗ trợ hoàn tiền toàn bộ. Cổng thanh toán thực thi số tiền hoàn trả tối thiểu tương ứng.

Các cập nhật trạng thái hoàn tiền được gửi đến URL webhook của giao dịch gốc và phải được xác nhận bằng {"returnCode":"100"} trong vòng 30 giây.

Nguồn

Trang này được trích xuất từ Refund API.