3.3.4 Gửi dữ liệu thanh toán tự động sang MB

Lưu ý

API này chỉ sử dụng cho đối tác đăng ký sử dụng tính năng thanh toán tự động.

Thông tin chung

• API Đối tác gửi thông tin trích nợ tự động sang để MB thu theo thông tin đó

Đặc tả

Endpoint

    POST /api/merchant/v2/auto-debit/bills/sync

Header

    Content-Type: application/json
    MERCHANT_CODE: Mã đối tác
    MERCHANT_SECRET: Khóa bí mật của Đối tác
    CLIENT_MESSAGE_ID: Mã tra cứu log giao dịch phía MB(dùng UUID)

Dữ liệu truyền lên

Tham số	Mô tả
billPaymentInfo.transactionId	BẮT BUỘC. Kiểu String. Mã giao dịch, Unique message id generated by service consumer for each request (using UUID)
billPaymentInfo.billIdentifies	BẮT BUỘC. Kiểu List. Thông tin bổ sung định danh bill. List phần tử dạng <name;value>
billPaymentInfo.billIdentifies.name	BẮT BUỘC. Kiểu String. Truyền mặc định "name":"CONTRACT-CODE"
billPaymentInfo.billIdentifies.value	BẮT BUỘC. Kiểu String. Truyền vào mã hợp đồng
billPaymentInfo.billInfos	BẮT BUỘC. Kiểu Object. Danh sách các bill
billPaymentInfo.billInfos.amount	BẮT BUỘC. Kiểu String. Số tiền thanh toán
billPaymentInfo.billInfos.billId	BẮT BUỘC. Kiểu String. Mã hóa đơn - Truyền vào mã giao dịch autodebit. Ví dụ: AT113WXX1AES
billPaymentInfo.billInfos.billInfoOthers	Kiểu List. Thông tin bổ sung. Dạng list, mỗi phần tử ở dạng <name;value>. Trường mở rộng, đối tác truyền tùy ý
billPaymentInfo.billInfos.billInfoOthers.name	Kiểu String. Thông tin bổ sung. Truyền vào tên biến
billPaymentInfo.billInfos.billInfoOthers.value	Kiểu String. Thông tin bổ sung. Truyền vào giá trị
billPaymentInfo.billInfos.descriptions	BẮT BUỘC. Kiểu String. Thông tin bổ sung. Mô tả giao dịch
billPaymentInfo.billInfos.term	BẮT BUỘC. Kiểu String. Kỳ thanh toán. Truyền vào kỳ thanh toán
billPaymentInfo.customerInformation	BẮT BUỘC. Kiểu Object. Thông tin khách hàng
billPaymentInfo.customerInformation.customerCode	BẮT BUỘC. Kiểu String. Mã khách hàng (mã hợp đồng)
billPaymentInfo.customerInformation.customerAddress	Kiểu String. Địa chỉ khách hàng
billPaymentInfo.customerInformation.customerName	Kiểu String. Tên khách hàng
billPaymentInfo.customerInformation.customerOthers	Kiểu String. Thông tin khách hàng bổ sung
billPaymentInfo.customerInformation.customerPhone	Kiểu String. Số điện thoại KH
billPaymentInfo.partner	BẮT BUỘC. Kiểu String. Truyền mặc định PAYMENT
billPaymentInfo.serviceIdentifies	BẮT BUỘC. Kiểu Object. Bộ thông tin định danh đối tác
billPaymentInfo.serviceIdentifies.serviceCode	BẮT BUỘC. Kiểu String. Mã service thanh toán hóa đơn. Truyền mặc định PAYMENT
billPaymentInfo.serviceIdentifies.providerUnit1Code	BẮT BUỘC. Kiểu String. Mã số 1 định danh đối tác thanh toán. Truyền vào mặc định mã merchant
billPaymentInfo.serviceIdentifies.providerUnit2Code	Kiểu String. Mã số 2 định danh đối tác thanh toán
billPaymentInfo.serviceIdentifies.providerUnit3Code	Kiểu String. Mã số 3 định danh đối tác thanh toán

Dữ liệu trả về

Tham số	Mô tả
transactionlist	Kiểu List. Danh sách kết quả giao dịch
transactionlist.billId	Kiểu String. Bill id
transactionlist.errorCode	Kiểu String. Mã lỗi
transactionlist.errorDesc	Kiểu String. Mô tả mã lỗi
transactionlist.mBReferenceNumber	Kiểu String. Số tham chiếu FT
transactionlist.status	Kiểu String. Trạng thái của bill. Tham khảo mục Bill_payment_status
transactionlist.transactionPaymentId	Kiểu String. Số duy nhất do MB sinh ra để định danh giao dịch

Thử nghiệm

Tham khảo

• 1.5. Thanh toán tự động