Refund giao dịch
Hoàn trả lại số tiền/điểm mà khách hàng đã thanh toán
Giới thiệu dịch vụ
Dịch vụ Hoàn lại giao dịch (Refund) cho phép merchant trả lại số tiền/điểm mà người dùng đã thanh toán qua ví VinID Pay.
Merchant có thể thực hiện hoàn lại một phần hoặc toàn bộ giá trị của giao dịch tùy thuộc vào nghiệp vụ của mình. Người dùng sẽ được thông báo trên ứng dụng VinID về số tiền/điểm mà merchant hoàn trả.
VinID Pay cung cấp dịch vụ Refund thông qua 2 phương thức sử dụng:
User Frontend (Merchant Site/Merchant App): merchant đăng nhập bằng tài khoản merchant vào trang web/ ứng dụng của VinID cung cấp để hoàn tiền cho giao dịch. Xem hướng dẫn tại đây
Backend-to-Backend: merchant tích hợp kết nối hệ thống thanh toán của VinID và sử dụng API để yêu cầu hoàn tiền cho giao dịch.
Luồng người dùng
User thực hiện trả lại mặt hàng đã mua tại Merchant
Merchant tạm giữ lại hàng và gửi yêu cầu refund giao dịch tới VinID
VinID kiểm tra yêu cầu của Merchant:
a. Nếu các thông tin yêu cầu hợp lệ, VinID sẽ thực hiện refund theo yêu cầu của Merchant
b. Nếu các thông tin yêu cầu không hợp lệ, VinID sẽ từ chối yêu cầu và báo lỗi cho Merchant.
VinID thông báo kết quả xử lý refund cho Merchant
Dựa vào kết quả phản hồi của VinID, Merchant đưa ra quyết định việc trả hàng của User.
APIs
Refund
POST
{API-HOST}/merchant-integration/v1/orders/refund
Tạo yêu cầu refund giao dịch
Request Body
order_reference_id
string
Mã định danh đơn hàng hoàn tiền tại merchant. Cần unique trên mỗi request, tối đa 35 ký tự
original_order_reference_id
string
Mã định danh đơn hàng gốc cần refund.
(Là giá trị order_reference_id
mà merchant truyền sang VinID khi tạo giao dịch)
description
string
Mô tả lý do của việc refund
merchant_user_id
string
Mã nhân viên của merchant thực hiện hoàn tiền.
merchant_user_name
string
Tên nhân viên của merchant thực hiện hoàn tiền.
vnd_amount
number
Số tiền muốn hoàn lại cho khách hàng. Giá trị phải nguyên lớn hơn 0
point_amount
number
Số điểm muốn hoàn lại cho khách hàng. Giá trị phải nguyên lớn hơn 0
Mã lỗi
Mã lỗi
Thông báo
200
OK
2000801
Refund thành công. Khách hàng đã nhận lại tiền. Phần điểm hoàn lại sẽ được cập nhật trong thời gian sớm nhất
2000802
Refund thành công. Khách hàng đã nhận lại điểm. Phần tiền hoàn lại sẽ được cập nhật trong thời gian sớm nhất
4000001
Dữ liệu không hợp lệ
4000800
Mã đơn hàng gốc không tồn tại
4000801
Giao dịch gốc không phải là payment
4000802
Giao dịch gốc không thành công
4000803
Giao dịch gốc có khuyến mãi
4000804
Giao dịch gốc đã cashback
4000807
Giao dịch gốc không phải DIRECT PAY hoặc QR PAYMENT
4000809
Số tiền còn lại không đủ thực hiện giao dịch
4000810
Currency không đúng với giao dịch gốc
4000811
Số tiền refund phải là số nguyên dương
4000812
Giao dịch gốc không được thanh toán bằng điểm
4000813
Điểm loyalty không trùng với giao dịch gốc
4000817
Merchant không được thiết lập refund tự động
4000820
Giao dịch đã quá thời hạn có thể refund
4000824
Thiếu thông tin mã giao dịch gốc
4030800
Merchant không được phép thực hiện hoàn tiền
4040800
Giao dịch gốc không tồn tại trên core ví
4040801
Giao dịch gốc không tồn tại
4080804
Quá thời hạn kết nối
4090801
Mã đơn hàng đã tồn tại
5000800
Refund thất bại
5000801
Hệ thống xảy ra lỗi khi xử lý yêu cầu
5000802
Hệ thống xảy ra lỗi khi xử lý yêu cầu
Thông tin thêm:
Last updated
Was this helpful?