Skip to main content

3.2.2 Lấy thông tin giao dịch hoàn tiền

Thông tin chung​

  • API lấy thông tin giao dịch hoàn tiền được sử dụng để lấy về thông tin của giao dịch hoàn tiền trong trường hợp backend của Đối tác không nhận được callback của hệ thống MB Payment Hub.

Đặc tả​

Endpoint​

    GET /api/merchant/v1/refund/{refundId}
    Content-Type: application/json
    MERCHANT_CODE: Mã đối tác
    MERCHANT_SECRET: Khóa bí mật của Đối tác

Dữ liệu truyền lên​

Tham số(URL)Mô tả
refundIdBẮT BUỘC. Kiểu String, tối đa 30 ký tự. ID của giao dịch hoàn tiền

Dữ liệu trả về​

Tham sốMô tả
idKiểu String, tối đa 30 ký tự. ID của giao dịch hoàn tiền
transactionIdKiểu String, tối đa 30 ký tự. ID của giao dịch thanh toán
amountKiểu Number. Số tiền hoàn
descriptionKiểu String, tối đa 45 ký tự. Nội dung giao dịch hoàn tiền
createdTimeKiểu String. Thời điểm tạo yêu cầu hoàn tiền
Theo định dạng yyyy-MM-dd’T’HH:mm:ss (ISO 8601)
refundedTimeKiểu String. Thời điểm thực hiện hoàn tiền
Theo định dạng yyyy-MM-dd’T’HH:mm:ss (ISO 8601)
statusKiểu String, tối đa 45 ký tự. Trạng thái của đăng ký bao gồm:
PROCESSING: Đang xử lý
SUCCEEDED: Thành công
FAILED: Thất bại
errorCodeKiểu String, tối đa 100 ký tự. Mã lỗi trong trường hợp hoàn tiền thất bại bao gồm:
customer-account-invalid: Tài khoản/thẻ của khách hàng không hợp lệ
invalid-refund-amount: Số tiền hoàn không hợp lệ
account-balance-insufficient: Tài khoản chuyên chi của đối tác không đủ số dư để hoàn tiền
refund-period-expired: Thời hạn hoàn tiền của giao dịch đã hết
invalid-transaction-status: Trạng thái giao dịch không cho phép hoàn tiền
unknown: Lỗi không xác định. Vui lòng liên hệ với MB để được hỗ trợ

Thử nghiệm​

Tham khảo​