Secure Acceptance Hosted Checkout

Machine Translated by Google
Thanh toán được lưu trữ trên máy chủ chấp nhận an toàn
Hội nhập
Hướng dẫn dành cho nhà phát triển

© 2023. Cybersource Corporation. Đã đăng ký Bản quyền.
Cybersource Corporation (Cybersource) cung cấp tài liệu này và phần mềm được mô tả trong tài liệu này theo thỏa thuận hiện hành giữa
người đọc tài liệu này (Bạn) và Cybersource (Thỏa thuận). Bạn chỉ có thể sử dụng tài liệu và/hoặc phần mềm này theo các điều khoản
của Thỏa thuận. Trừ khi được quy định rõ ràng trong Thỏa thuận, thông tin trong tài liệu này có thể thay đổi mà không cần thông báo
trước và do đó Cybersource không nên hiểu theo bất kỳ cách nào như một sự đảm bảo hoặc bảo đảm. Cybersource không chịu trách nhiệm hoặc
trách nhiệm pháp lý đối với bất kỳ lỗi nào có thể xuất hiện trong tài liệu này. Phần mềm có bản quyền đi kèm với tài liệu này được
cấp phép cho Bạn chỉ để sử dụng theo đúng Thỏa thuận. Bạn nên đọc kỹ Thỏa thuận trước khi sử dụng phần mềm. Trừ khi được Thỏa thuận
cho phép, Bạn không được sao chép bất kỳ phần nào của tài liệu này, lưu trữ tài liệu này trong hệ thống truy xuất hoặc truyền tài
liệu này dưới bất kỳ hình thức nào hoặc bằng bất kỳ phương tiện nào, điện tử, cơ khí, ghi âm hoặc cách khác mà không có sự cho phép
trước. sự đồng ý bằng văn bản của Cybersource.
Truyền thuyết về quyền hạn chế
Đối với Chính phủ hoặc các cơ quan quốc phòng: Việc Chính phủ hoặc các cơ quan quốc phòng sử dụng, sao chép hoặc tiết lộ phải tuân theo
các hạn chế như được quy định trong điều khoản Quyền về Dữ liệu Kỹ thuật và Phần mềm Máy tính tại DFARS 252.227-7013 và trong các điều
khoản tương tự trong FAR và Phần bổ sung FAR của NASA .
Đối với các cơ quan dân sự: Việc sử dụng, sao chép hoặc tiết lộ phải tuân theo các hạn chế được quy định trong các tiểu đoạn (a) đến (d)
của điều khoản Quyền hạn chế đối với phần mềm máy tính thương mại tại 52.227-19 và các hạn chế được quy định trong thỏa thuận thương
mại tiêu chuẩn của Cybersource Corporation đối với điều này phần mềm. Các quyền chưa được xuất bản được bảo lưu theo luật bản quyền của
Hoa Kỳ.
nhãn hiệu
Authorize.Net, eCheck.Net và The Power of Payment là các nhãn hiệu đã đăng ký của Cybersource Corporation.
Cybersource và Cybersource Decision Manager là các nhãn hiệu và/hoặc nhãn hiệu dịch vụ của Cybersource Corporation. Visa, Visa
International, Cybersource, logo Visa, logo Cybersource và 3-D Secure là các nhãn hiệu đã đăng ký của Visa International tại Hoa Kỳ
và các quốc gia khác. Tất cả các nhãn hiệu, nhãn hiệu dịch vụ, nhãn hiệu đã đăng ký hoặc nhãn hiệu dịch vụ đã đăng ký đều là tài sản
của chủ sở hữu tương ứng.
Phiên bản: 23.03
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| 2
nội dung
Những sửa đổi gần đây đối với tài liệu này .................................................. .................................................... ................. 7
Về sự hướng dẫn này............................................... .................................................... ....................................................10
Yêu cầu về trang web ............................................................ .................................................... ..................................... 12
Tổng quan về tích hợp thanh toán được lưu trữ trên máy chủ chấp nhận an toàn............................................. ..................... 13
Các trình duyệt cần thiết ............................................................ .................................................... .................................................... ......13
Hồ sơ chấp nhận an toàn ............................................................ .................................................... ................................................14
Luồng giao dịch chấp nhận an toàn .................................................. .................................................... ..................... 15
Token thanh toán ................................................................ .................................................... .................................................... ............16
Mã thông báo chỉ đại diện cho một thẻ hoặc tài khoản ngân hàng ............................................ .....................................17
Thanh toán bằng một cú nhấp chuột ............................................................ .................................................... .................................................... ....... 17
Thanh toán đăng ký ................................................................ .................................................... ...................................................17
Dữ liệu cấp II và III .................................................. .................................................... .................................................... .......18
Xuất chi Mã thông báo thanh toán .................................................. .................................................... ...................................................19
Tạo mã thông báo thanh toán cho các khoản thanh toán.................................................. .................................................... ..........19
Phát trực tiếp với chấp nhận an toàn.................................................. .................................................... ....................................19
Cấu hình thanh toán ................................................................ .................................................... .................................... 20
Tạo hồ sơ chấp nhận an toàn .................................................. .................................................... ...................... 20
Cấu hình phương thức thanh toán.................................................. .................................................... ............................... 21
Thêm loại thẻ và đơn vị tiền tệ.................................................. .................................................... .................21
Cấu hình xác thực người thanh toán .................................................. .................................................... ............. 22
Kích hoạt đảo ngược ủy quyền tự động ................................................ ...................................................24
Kích hoạt Echeck.................................................................... .................................................... .................................................... 24
Cấu hình Nhấp để thanh toán của Visa.................................................. .................................................... ...................25
Kích hoạt PayPal Express Checkout.................................................. .................................................... ................27
Khóa bảo mật ................................................................ .................................................... .................................................... ..................28
Tạo khóa bảo mật............................................................. .................................................... ........................................28
Cấu hình thanh toán ................................................................ .................................................... ...................................................29
Định cấu hình biểu mẫu thanh toán .................................................. .................................................... ........................30
Định cấu hình các trường thông tin thanh toán .................................................. .................................................... .........30
Định cấu hình các trường thông tin vận chuyển.................................................. .................................................... ....31
Định cấu hình các trường thông tin Echeck.................................................. .................................................... ........32
Định cấu hình chi tiết xem lại đơn hàng.................................................. .................................................... ..................33
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Nội dung| 3
Nội dung| 4
Thông báo của người bán ................................................................ .................................................... ...................................................33
Định cấu hình thông báo của người bán.................................................. .................................................... ..............34
Phiếu thu của khách hàng ............................................................................ .................................................... .................................................... .......34
Định cấu hình thông báo khách hàng .................................................. .................................................... ............. 35
Trang phản hồi của khách hàng ............................................................ .................................................... ............................................. 36
Định cấu hình Trang phản hồi được lưu trữ trên Cybersource............................................. ................................................. 36
Định cấu hình Trang phản hồi được lưu trữ tùy chỉnh ................................................ .................................................... ...... 36
Định cấu hình Trang phản hồi được lưu trữ trên nguồn mạng tùy chỉnh............................................. ................................. 37
Định cấu hình Trang Phản hồi Hủy tùy chỉnh .................................................. .................................................... ....... 37
Giao diện thanh toán tùy chỉnh.................................................. .................................................... ..................................... 38
Thay đổi nội dung Header .............................................................. .................................................... ................................ 38
Thay đổi cài đặt màu cơ thể và phông chữ.................................................. .................................................... .39
Thay đổi nền tổng số tiền và màu văn bản............................................. ................................. 39
Thay đổi màu của thanh tiến trình.................................................. .................................................... .....................40
Thay đổi Màu sắc và Văn bản trên Nút Thanh toán hoặc Kết thúc............................................. ............................40
Thay đổi màu chân trang và tải lên một biểu trưng hoặc hình ảnh nhỏ............................................. ............41
Bản địa hóa ngôn ngữ thanh toán .................................................. .................................................... .................................42
Kích hoạt một hồ sơ ............................................................ .................................................... .................................................... .......44
Tùy chọn hồ sơ bổ sung.................................................. .................................................... ....................................44
Quản lý danh mục đầu tư cho người bán lại .............................................. .................................................... ............. 45
Người bán lại: Tạo Hồ sơ chấp nhận an toàn............................................. .................................................... .....45
Cấu hình phương thức thanh toán.................................................. .................................................... ............................... 46
Người bán lại: Thêm loại thẻ và đơn vị tiền tệ............................................. .................................................... 46
Cấu hình xác thực người thanh toán .................................................. .................................................... ............. 47
Người bán lại: Kích hoạt Echecks.................................................. .................................................... ................................ 49
Cấu hình Nhấp để thanh toán của Visa.................................................. .................................................... .........................50
Người bán lại: Kích hoạt PayPal Express Checkout............................................. ....................................................51
Phí dịch vụ................................................ .................................................... .................................................... ..........52
Khóa bảo mật ................................................................ .................................................... .................................................... ........52
Cấu hình thanh toán ................................................................ .................................................... .....................................54
Thông báo của người bán ................................................................ .................................................... .................................... 58
Phiếu thu của khách hàng ............................................................................ .................................................... ...................................................59
Trang phản hồi của khách hàng ............................................................ .................................................... ....................................60
Giao diện thanh toán tùy chỉnh.................................................. .................................................... ...................62
Người bán lại: Kích hoạt một Hồ sơ............................................. .................................................... .................................66
Machine Translated by Google Nội dung| 5
Ngôn ngữ kịch bản mẫu ............................................................ .................................................... ................................ 68
Quy trình giao dịch mẫu sử dụng JSP.................................................. .................................................... ................... 68
Giao dịch thanh toán ................................................................ .................................................... ....................................69
Điểm cuối và loại giao dịch .................................................. .................................................... .........................69
Các trường đã ký bắt buộc ............................................................ .................................................... ....................................................71
Token thanh toán ................................................................ .................................................... .................................................... ............72
Tạo mã thông báo thẻ thanh toán.................................................. .................................................... ....................72
Tạo mã thông báo Echeck .............................................................. .................................................... ....................................74
Giao dịch mã thông báo thanh toán .................................................. .................................................... .....................................75
Một lần bấm ............................................................. .................................................... .................................................... ................. 75
Kiểm tra thanh toán bằng mã thông báo.................................................. .................................................... ................................ 78
Thanh toán định kỳ ................................................................ .................................................... .................................................... ....79
Thanh toán từng lần................................................ .................................................... .................................................... 81
Cập nhật mã thông báo thanh toán.................................................. .................................................... ................................................. 83
Cập nhật mã thông báo thẻ thanh toán.................................................. .................................................... ......................83
Cập nhật Mã thông báo Echeck.................................................. .................................................... ....................................85
Nhà quản lý ra quyết định.................................................................... .................................................... ...................................................87
Kiểm tra và xem các giao dịch.................................................. .................................................... .............................. 89
Kiểm tra giao dịch ............................................................ .................................................... .................................................... ...89
Xem các giao dịch trong Trung tâm kinh doanh.................................................... .................................................... .......90
Các trường API tích hợp Checkout được lưu trữ............................................. .................................................... .......91
Định nghĩa kiểu dữ liệu .................................................................. .................................................... .................................................... .91
Các trường yêu cầu ................................................................ .................................................... .................................................... ............... 92
Các trường phản hồi ............................................................ .................................................... .................................................... ..........173
Mã SEC ............................................................. .................................................... .................................................... ..........226
Mã lý do ............................................................. .................................................... .................................................... ..227
Các loại thông báo.................................................................... .................................................... ..................................... 232
Mã AVS ............................................................. .................................................... .................................................... ......... 234
Mã AVS quốc tế ................................................................ .................................................... ...................................................234
Mã AVS nội địa Hoa Kỳ.................................................. .................................................... ...................................................234
Mã CVN ............................................................. .................................................... .................................................... ........238
Mã phản hồi SafeKey của American Express............................................. ...................................................239
Triển khai khung nội tuyến ................................................................ .................................................... ....................................240
Phòng chống clickjacking ............................................................ .................................................... ...................................................240
Điểm cuối giao dịch iframe.................................................. .................................................... ...................................241
Nội dung| 6
Mã phản hồi an toàn của Visa.................................................. .................................................... ................................242
Các sửa đổi gần đây đối với tài liệu này
23.03
Đã thêm trường yêu cầu mới payer_authentication_message_category (ở trang 142).
23.02
Thông tin cập nhật về các trường đã ký trong ghi chú cảnh báo tại Luồng giao dịch chấp nhận an toàn (ở trang 15), tại
Trường đã ký bắt buộc (ở trang 71) và trong một lưu ý quan trọng tại Trường yêu cầu (ở trang 92).
Đã cập nhật các giá trị trong trường sign_field_names trong các ví dụ về mã xuyên suốt hướng dẫn này.
Đã thêm tuyên bố rằng ID người bán của bạn phải được bật để xử lý các khoản thanh toán định kỳ và trả góp. Xem Thanh
toán Định kỳ (ở trang 79) và Thanh toán Trả góp (ở trang 81).
Cập nhật các nhiệm vụ này:
• Định cấu hình Trang phản hồi được lưu trữ tùy chỉnh (ở trang 36)
• Định cấu hình Trang phản hồi hủy tùy chỉnh (ở trang 37)
• Người bán lại: Định cấu hình Trang phản hồi được lưu trữ tùy chỉnh (ở trang 61)
• Người bán lại: Định cấu hình Trang phản hồi hủy tùy chỉnh (ở trang 62)
23.01
Đã cập nhật mô tả trường echeck_sec_code (ở trang 122) .
Đã thêm phần mới Mã SEC (trên trang 226).
22.01
Đã thêm giá trị China UnionPay cho trường card_type và làm loại thanh toán cho Cấu hình xác thực người trả
tiền (ở trang 22).
Đã thêm loại giao dịch create_payment_token vào Điểm cuối giao dịch Iframe. Xem Điểm cuối và Loại giao dịch (ở trang 69).
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Những sửa đổi gần đây đối với tài liệu này| 7
Đã cập nhật các giá trị cho trường payment_token và req_payment_token thành chuỗi 32 ký tự trong các ví dụ và mô
tả trường.
Đã cập nhật ví dụ phản hồi cho One-Click (ở trang 75).
Đã thêm transaction_type vào ví dụ về Cập nhật Mã thông báo Thẻ Thanh toán (ở trang 83).
Cập nhật Xem các Giao dịch trong Trung tâm Thương mại (ở trang 90).
Đã thêm trường yêu cầu credential_stored_on_file . Xem Trường yêu cầu (ở trang 92).
Đã thêm các trường phản hồi này. Xem Trường phản hồi (ở trang 173).
• auth_reconciliation_reference_number
• giải_pháp_thanh_toán
• ngày thanh toán_token_latest_card_expiry_date
• thanh toán_token_latest_card_suffix
Đã thêm mã lý do 101 và 478. Xem Mã lý do (ở trang 227).
Đã xóa hỗ trợ cho dịch vụ tra cứu BIN.
21.02
Đã thêm trường yêu cầu cryptocurrency_purchase. Xem Trường yêu cầu (ở trang 92).
21.01
Đã đổi tên Visa Checkout thành Visa Click to Pay và loại bỏ Visa Secure Remote Commerce.
Đã cập nhật lưu ý quan trọng đầu tiên trong Tổng quan về tích hợp thanh toán được lưu trữ trên máy chủ chấp nhận an toàn
(ở trang 13).
Đã cập nhật trường yêu cầu payer_authentication_challenge_code.
Đã thêm các trường profile_id và req_profile_id . Xem Giao dịch thanh toán (ở trang 69) và Các trường API
tích hợp Checkout được lưu trữ (ở trang 91).
20.05
Đã thêm các trường yêu cầu chăm sóc sức khỏe này. Xem Trường yêu cầu (ở trang 92).
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Những sửa đổi gần đây đối với tài liệu này| số 8
• chăm_sóc_#_số_lượng
• chăm sóc_sức_khỏe_#_số_lượng_loại
• ngành_dữ liệu
Đã cập nhật Lưu ý quan trọng đầu tiên trong Triển khai khung nội tuyến (trên trang 240).
Đã xóa hỗ trợ cho thẻ ghi nợ không có mã PIN.
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Những sửa đổi gần đây đối với tài liệu này| 9
về sự hướng dẫn này
Phần này cung cấp cho bạn thông tin về Tích hợp thanh toán được lưu trữ trên máy chủ được chấp nhận an toàn.
Đối tượng và Mục đích
Hướng dẫn này được viết cho những người bán muốn chấp nhận thanh toán bằng Secure Acceptance Hosted
Checkout Integration và những người không muốn xử lý hoặc lưu trữ thông tin thanh toán nhạy cảm trên
máy chủ riêng.
Việc sử dụng Tích hợp thanh toán được lưu trữ trên máy chủ để chấp nhận bảo mật yêu cầu các kỹ năng viết kịch bản tối
thiểu. Bạn phải tạo tập lệnh bảo mật và sửa đổi biểu mẫu HTML của mình để gọi Chấp nhận an toàn. Bạn cũng sẽ sử dụng Business
Center để xem xét và quản lý các đơn đặt hàng.
quy ước
Những tuyên bố đặc biệt này được sử dụng trong tài liệu này:
Quan trọng: Một tuyên bố quan trọng chứa thông tin cần thiết để thành công
hoàn thành một nhiệm vụ hoặc học một khái niệm.
Cảnh báo: Cảnh báo chứa thông tin hoặc hướng dẫn, nếu không chú ý, có thể dẫn đến
rủi ro bảo mật, mất dữ liệu không thể phục hồi hoặc chi phí đáng kể về thời gian hoặc doanh thu hoặc cả hai.
Tài liệu liên quan
Để có tài liệu bổ sung, hãy truy cập các trang web tài liệu này:
• Trung tâm nhà phát triển Cybersource/Hướng dẫn dành cho nhà phát triển : https://developer.cybersource.com/api/
developer-guides.html
• Trung tâm hỗ trợ Cybersource/Tài liệu kỹ thuật: https://www.cybersource.com/en-us/ support/technical-documentation.html
• Cổng tài liệu kỹ thuật Cybersource: https://docs.cybersource.com/en/index.html
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Giới thiệu về Hướng dẫn này| 10
Hỗ trợ khách hàng
Để biết thông tin hỗ trợ về bất kỳ dịch vụ nào, hãy truy cập Trung tâm hỗ trợ:
http://www.cybersource.com/support
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Giới thiệu về Hướng dẫn này| 11
Yêu cầu trang web
Trang web của bạn phải đáp ứng các yêu cầu sau:
• Phải có giỏ hàng, phần mềm tạo đơn hàng của khách hàng hoặc ứng dụng khởi tạo giải ngân để chuyển tiền
vào tài khoản thanh toán.
• Nó phải chứa các trang sản phẩm bằng một trong các ngôn ngữ kịch bản được hỗ trợ. Xem "Quy
trình Giao dịch Mẫu Sử dụng JSP," (ở trang 68).
• Cơ sở hạ tầng CNTT phải được bật Cơ sở hạ tầng khóa công khai (PKI) để sử dụng biểu mẫu dựa trên SSL
POST bài nộp.
• Cơ sở hạ tầng CNTT phải có khả năng ký điện tử dữ liệu khách hàng trước khi gửi cho
Chấp nhận an toàn.
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Yêu cầu trang web| 12
Tích hợp thanh toán được lưu trữ trên máy chủ chấp nhận an toàn
Tổng quan
Tích hợp thanh toán được lưu trữ trên máy chủ để chấp nhận bảo mật của Cybersource là trải nghiệm thanh toán dành
cho khách hàng được lưu trữ an toàn của bạn. Nó bao gồm các biểu mẫu thanh toán được quản lý an toàn hoặc dưới dạng
biểu mẫu thanh toán một trang để thu thập dữ liệu thẻ thanh toán, xử lý giao dịch, cho phép bạn đơn giản hóa việc
tuân thủ Tiêu chuẩn bảo mật dữ liệu ngành thẻ thanh toán (PCI DSS) và giảm thiểu rủi ro liên quan đến việc xử lý và/hoặc
lưu trữ thông tin thẻ thanh toán nhạy cảm. Bạn, người bán, thu thập và quản lý dữ liệu nhạy cảm của thẻ thanh toán bên
ngoài đối với Chấp nhận an toàn, được thiết kế để chấp nhận thanh toán bằng thẻ.
Cảnh báo: Chấp nhận an toàn được thiết kế để xử lý các yêu cầu giao dịch trực tiếp từ trình duyệt của khách hàng
để dữ liệu thanh toán nhạy cảm không chuyển qua máy chủ của bạn. Nếu bạn định gửi dữ liệu thanh toán từ máy chủ của
mình, hãy sử dụng API REST, Bộ công cụ SOAP API, hoặc API đặt hàng đơn giản . Việc gửi thanh toán phía máy chủ bằng Chấp
nhận an toàn phát sinh chi phí không cần thiết và có thể dẫn đến việc hồ sơ Chấp nhận an toàn của bạn bị tạm ngưng và
giao dịch không thành công sau đó.
Để tạo trải nghiệm thanh toán cho khách hàng của bạn, hãy thực hiện các bước sau:
1. Tạo và cấu hình hồ sơ Chấp nhận an toàn.
2. Cập nhật mã trên trang web của bạn để hiển thị Tích hợp thanh toán được lưu trữ và xử lý ngay các giao dịch thẻ. Xem
Mẫu ngôn ngữ viết kịch bản (ở trang 68). Dữ liệu thẻ nhạy cảm bỏ qua mạng của bạn và được Chấp nhận an toàn
chấp nhận trực tiếp từ khách hàng.
Cybersource thay mặt bạn xử lý giao dịch bằng cách gửi yêu cầu phê duyệt tới bộ xử lý thanh toán của bạn trong thời
gian thực. Xem Luồng giao dịch chấp nhận an toàn (ở trang 15).
3. Sử dụng thông tin phản hồi để hiển thị trang phản hồi giao dịch thích hợp cho khách hàng. Bạn có thể xem
và quản lý tất cả các đơn đặt hàng trong Business Center. Xem Xem giao dịch trong Business Center (ở trang
90).
Trình duyệt bắt buộc
Bạn phải sử dụng một trong những trình duyệt này để đảm bảo rằng quy trình thanh toán Chấp nhận an toàn diễn ra nhanh chóng
và an toàn.
Trình duyệt máy tính để bàn:
• IE 10 trở lên
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Tổng quan về tích hợp thanh toán được lưu trữ trên máy chủ chấp nhận an toàn| 13
• Cạnh 13 trở lên
• Firefox 42 trở lên
• Chrome 48 trở lên
• Safari 7.1 trở lên
• Opera 37 trở lên
Trình duyệt di động:
• iOS Safari 7.1 trở lên
• Trình duyệt Android 4.4 trở lên
• Chrome Mobile 48 trở lên
Hồ sơ chấp nhận an toàn
Cấu hình Chấp nhận an toàn bao gồm các cài đặt mà bạn định cấu hình để tạo trải nghiệm thanh toán cho khách
hàng. Bạn có thể tạo và chỉnh sửa nhiều hồ sơ, mỗi hồ sơ cung cấp trải nghiệm thanh toán tùy chỉnh.
Xem Giao diện thanh toán tùy chỉnh (trên trang 38). Ví dụ: bạn có thể cần nhiều hồ sơ để xây dựng thương
hiệu bản địa hóa cho các trang web của mình. Bạn có thể hiển thị quy trình thanh toán nhiều bước hoặc thanh
toán một trang cho khách hàng cũng như định cấu hình giao diện và nhãn hiệu, tùy chọn thanh toán, ngôn ngữ và
thông báo cho khách hàng. Xem Cấu hình thanh toán (ở trang 29)
Luồng giao dịch chấp nhận an toàn

Luồng giao dịch tích hợp Checkout được lưu trữ
1. Khách hàng nhấp vào nút thanh toán trên trang web của bạn, thao tác này sẽ kích hoạt HTTPS POST
hướng khách hàng đến trang Chấp nhận an toàn được lưu trữ mà bạn đã định cấu hình trong Business Center.
HTTPS POST bao gồm chữ ký và các trường dữ liệu đã ký chứa thông tin đơn đặt hàng.
Tích hợp Checkout được lưu trữ hoạt động tốt nhất với JavaScript và cookie được bật trong trình duyệt của
khách hàng.
Cảnh báo: Hệ thống của bạn phải ký tất cả các trường yêu cầu ngoại trừ các trường chứa dữ liệu mà
khách hàng đang nhập. Để ngăn chặn các tác nhân độc hại mạo danh Cybersource, không cho phép truy cập
trái phép vào chức năng ký. Xem Các trường được ký bắt buộc (ở trang 71).
2. Chấp nhận an toàn xác minh chữ ký để đảm bảo rằng chi tiết đơn đặt hàng không bị sửa đổi hoặc giả mạo và
hiển thị trang Tích hợp thanh toán được lưu trữ. Khách hàng nhập và gửi chi tiết thanh toán cũng như thông
tin thanh toán và giao hàng của họ. Khách hàng xác nhận thanh toán và giao dịch được xử lý.
3. Cybersource khuyên bạn nên định cấu hình trang biên nhận tùy chỉnh trong Business Center để phản hồi giao
dịch đã ký được gửi trở lại máy chủ người bán của bạn thông qua trình duyệt. Xem Thông báo của người
bán (ở trang 33). Bạn phải xác thực chữ ký phản hồi
để xác nhận rằng dữ liệu phản hồi không bị sửa đổi hoặc giả mạo. Tích hợp Hosted Checkout cũng có
thể hiển thị trang biên nhận tiêu chuẩn cho khách hàng của bạn và bạn có thể xác minh kết quả tìm kiếm
giao dịch trong Business Center hoặc báo cáo Nguồn điện tử tiêu chuẩn.
Cảnh báo: Nếu chữ ký phản hồi trong trường phản hồi không khớp với chữ ký được tính toán dựa
trên dữ liệu phản hồi, hãy coi POST là độc hại và bỏ qua nó. Chấp nhận an toàn ký vào mọi trường phản
hồi. Bỏ qua bất kỳ trường phản hồi nào trong POST không có trong trường sign_fields .
4. Cybersource khuyên bạn nên triển khai thông báo POST URL của người bán làm phương tiện dự phòng
để xác định kết quả giao dịch. Phương pháp này không phụ thuộc vào trình duyệt của khách hàng
của bạn. Bạn nhận được kết quả giao dịch ngay cả khi khách hàng của bạn bị mất kết nối sau khi xác nhận
thanh toán. Xem Thông báo của người bán (ở trang 33).
Nếu loại giao dịch là bán, nó được gửi ngay lập tức để giải quyết. Nếu loại giao dịch là ủy quyền,
hãy sử dụng API Đơn đặt hàng đơn giản của Cybersource để gửi yêu cầu chụp khi hàng hóa được vận chuyển.
Mã thông báo thanh toán
Quan trọng: Liên hệ với bộ phận Hỗ trợ khách hàng của Cybersource để kích hoạt tài khoản người bán của
bạn cho Dịch vụ quản lý mã thông báo (TMS). Bạn không thể sử dụng mã thông báo thanh toán cho đến khi tài
khoản của bạn được kích hoạt và bạn đã bật mã thông báo thanh toán cho Chấp nhận an toàn. Xem Tạo Hồ sơ
Chấp nhận An toàn (ở trang 20).
Mã thông báo thanh toán là số nhận dạng duy nhất thay thế thông tin thanh toán nhạy cảm và không thể đảo ngược
về mặt toán học. Cybersource lưu trữ an toàn tất cả thông tin thẻ, thay thế bằng mã thông báo thanh toán. Mã
thông báo còn được gọi là ID đăng ký mà bạn lưu trữ trên máy chủ của mình.
Giải pháp mã thông báo thanh toán tương thích với dịch vụ Visa và Mastercard Account Updater. Dữ liệu thẻ
được lưu trữ với Cybersource được cập nhật tự động bởi các ngân hàng tham gia, do đó giảm thiểu các lỗi thanh
toán. Xem Hướng dẫn sử dụng Trình cập nhật tài khoản (PDF| HTML).
Mã thông báo thanh toán thay thế thẻ hoặc số tài khoản ngân hàng séc điện tử và tùy chọn thông tin thanh toán,
vận chuyển và thẻ liên quan. Không có thông tin thẻ nhạy cảm nào được lưu trữ trên máy chủ của bạn, do đó
làm giảm nghĩa vụ PCI DSS của bạn.
Mã thông báo chỉ đại diện cho thẻ hoặc tài khoản ngân hàng
Mã thông báo nhận dạng công cụ được tạo bằng Dịch vụ quản lý mã thông báo (TMS) và mã thông báo của bên thứ ba
đại diện cho số thẻ thanh toán hoặc số tài khoản ngân hàng. Số thẻ hoặc số tài khoản ngân hàng giống nhau được
gửi trong nhiều lệnh gọi tạo mã thông báo dẫn đến việc trả lại cùng một mã thông báo thanh toán. Không thể
cập nhật số nhận dạng công cụ TMS và mã thông báo của bên thứ ba. Nếu tài khoản người bán của bạn được định
cấu hình cho một trong các loại mã thông báo này, thì bạn sẽ gặp lỗi nếu cố cập nhật mã thông báo.
Khi sử dụng Chấp nhận an toàn với mã thông báo chỉ đại diện cho số thẻ hoặc tài khoản ngân hàng, bạn phải bao
gồm dữ liệu liên quan, chẳng hạn như ngày hết hạn và dữ liệu địa chỉ thanh toán, trong yêu cầu giao dịch
của mình.
Thanh toán bằng một cú nhấp chuột
Với thanh toán bằng một cú nhấp chuột, khách hàng có thể mua sản phẩm chỉ bằng một cú nhấp chuột. Chấp nhận
an toàn được tích hợp với mã thông báo Cybersource, vì vậy khách hàng quay lại không bắt buộc phải nhập chi
tiết thanh toán của họ. Trước khi khách hàng có thể sử dụng tính năng thanh toán bằng một cú nhấp chuột, họ phải
tạo mã thông báo thanh toán trong lần giao dịch đầu tiên trên trang web của người bán. Xem Giao dịch mã thông
báo thanh toán (ở trang 75). Mã thông báo thanh toán là mã định danh cho chi tiết thanh toán; do đó, không có
giao dịch mua nào yêu cầu bạn nhập bất kỳ thông tin nào. Khi mã thông báo thanh toán được bao gồm trong một yêu cầu
thanh toán, nó sẽ truy xuất thông tin về thẻ, thanh toán và giao hàng liên quan đến yêu cầu thanh toán ban đầu từ
kho lưu trữ thanh toán.
Để sử dụng thanh toán bằng một lần nhấp, bạn phải bao gồm điểm cuối thanh toán bằng một lần nhấp để xử
lý giao dịch. Xem Điểm cuối và Loại giao dịch (ở trang 69).
Thanh toán đăng ký
Đăng ký khách hàng chứa thông tin mà bạn lưu trữ trong cơ sở dữ liệu Cybersource và sử dụng để thanh toán trong
tương lai. Bất cứ lúc nào, bạn có thể gửi yêu cầu lập hóa đơn cho khách hàng với số tiền bạn chỉ định và
Cybersource sử dụng mã thông báo thanh toán để truy xuất thẻ, hóa đơn và thông tin giao hàng nhằm xử lý giao dịch.
Bạn cũng có thể xem đăng ký của khách hàng trong Business Center. Xem Xem giao dịch trong Business Center (ở
trang 90).
Một thuê bao khách hàng bao gồm:
• Thông tin liên hệ của khách hàng, chẳng hạn như thông tin thanh toán và giao hàng.
• Thông tin thanh toán của khách hàng, chẳng hạn như loại thẻ, số tài khoản ẩn và ngày hết hạn
ngày.
• Thông tin đặt hàng của khách hàng, chẳng hạn như số tham chiếu giao dịch và do người bán xác định
các trường dữ liệu.
Loại đăng ký
Loại đăng ký Sự miêu tả
Định kỳ Dịch vụ thanh toán định kỳ không có ngày kết thúc cụ thể. Bạn phải chỉ
định số tiền và tần suất của mỗi khoản thanh toán và ngày bắt đầu xử
lý các khoản thanh toán. Cybersource tạo lịch trình dựa trên thông tin
này và tự động lập hóa đơn cho khách hàng theo lịch trình. Ví dụ: bạn
có thể cung cấp dịch vụ trực tuyến mà khách hàng đăng ký và có thể
tính phí hàng tháng cho dịch vụ này.
Xem "Thanh toán Định kỳ" (ở trang 79).
trả góp Dịch vụ thanh toán định kỳ với số lần thanh toán cố định theo
lịch trình. Bạn phải chỉ định số lần thanh toán, số tiền và tần suất
của từng khoản thanh toán cũng như ngày bắt đầu xử lý các khoản thanh
toán. Cybersource tạo lịch trình dựa trên thông tin này và tự động lập
hóa đơn cho khách hàng theo lịch trình. Ví dụ: bạn có thể cung cấp một
sản phẩm với giá 75,00 và cho phép khách hàng thanh toán thành ba đợt là
25,00. Xem phần "Trả góp" (ở trang 81).
Dữ liệu cấp II và III
Chấp nhận an toàn hỗ trợ dữ liệu Cấp II và III. Thẻ cấp II hay còn gọi là thẻ loại II cung cấp cho khách
hàng những thông tin bổ sung trên sao kê thẻ thanh toán của họ. Thẻ kinh doanh và thẻ công ty cùng với
thẻ mua hàng được coi là thẻ Cấp II.
Dữ liệu cấp III có thể được cung cấp cho thẻ mua hàng, là thẻ thanh toán được nhân viên sử dụng để mua
hàng cho công ty của họ. Bạn cung cấp thông tin chi tiết bổ sung—dữ liệu Cấp độ III— về đơn đặt hàng mua
thẻ trong quá trình thanh toán. Dữ liệu cấp III được chuyển tiếp đến công ty đã mua hàng và nó cho phép
công ty quản lý các hoạt động mua hàng của mình.
Để biết mô tả chi tiết về từng trường Cấp II và Cấp III, xem Xử lý Cấp II và Cấp III Sử dụng Chấp
nhận An toàn (PDF| HTML). Hướng dẫn này cũng mô tả cách yêu cầu bán và nắm bắt các giao dịch.
Xuất chi Token thanh toán
Sử dụng Chấp nhận an toàn để tạo mã thông báo thanh toán có thể được sử dụng với API xuất chi hoặc gửi hàng loạt.
Tạo mã thông báo thanh toán cho các khoản thanh toán
1. Tạo Hồ sơ chấp nhận an toàn và xác định trang thanh toán của bạn. Xem cấu hình thanh toán
(ở trang 20) hoặc Quản lý danh mục đầu tư dành cho người bán lại (ở trang 45).
2. Để xử lý giao dịch, hãy tạo mã thông báo thanh toán. Xem "Mã thông báo thanh toán" (ở trang 72).
3. Đặt trường ID đăng ký Xuất chi thành giá trị của mã thông báo thanh toán.
Xem Xuất chi bằng cách sử dụng API đặt hàng đơn giản (PDF| HTML) hoặc Xuất chi bằng API SCMP (PDF| HTML).
Go-Live với chấp nhận an toàn
Cybersource khuyên bạn nên gửi tất cả thông tin ngân hàng và các dịch vụ tích hợp bắt buộc trước khi hoạt động. Làm như
vậy sẽ tăng tốc cấu hình tài khoản người bán của bạn.
Khi bạn đã sẵn sàng triển khai Chấp nhận an toàn trong môi trường trực tiếp của mình, bạn phải liên hệ với bộ phận
Hỗ trợ khách hàng của Cybersource và yêu cầu Go-Live. Khi Cybersource đã nhận được tất cả thông tin ngân hàng, quy
trình Go-Live có thể cần ba ngày để hoàn tất. Không có triển khai Go-Live nào diễn ra vào Thứ Sáu.
Cấu hình thanh toán
Tạo một hồ sơ chấp nhận an toàn
Liên hệ với bộ phận Hỗ trợ khách hàng của Cybersource để kích hoạt tài khoản của bạn để Chấp nhận an toàn.
Bạn phải kích hoạt một hồ sơ để sử dụng nó. Xem Kích hoạt Hồ sơ (ở trang 44).
1. Đăng nhập vào Business Center:
• Sản xuất: https://businesscenter.cybersource.com
• Sản xuất tại Ấn Độ: https://businesscenter.in.cybersource.com
• Kiểm tra: https://businesscentertest.cybersource.com
2. Trong bảng điều hướng bên trái, hãy chọn Cấu hình thanh toán > Cài đặt chấp nhận an toàn.
Trang Cài đặt chấp nhận an toàn xuất hiện.
3. Nhấp vào Hồ sơ mới. Trang Tạo hồ sơ xuất hiện.
4. Nhập hoặc xác minh các chi tiết hồ sơ này.
Chi tiết hồ sơ
Chi tiết hồ sơ Sự miêu tả
Tên hồ sơ Tên hồ sơ Chấp nhận An toàn là bắt buộc và không được

vượt quá 40 ký tự chữ và số.
Mô tả tiểu sử Mô tả hồ sơ không được vượt quá 255 ký tự.
Phương pháp tích hợp Kiểm tra tích hợp thanh toán được lưu trữ.
Tên công ty Tên công ty là bắt buộc và không được vượt quá 40 ký tự
chữ và số.
Tên liên hệ công ty Nhập thông tin liên hệ của công ty: tên, email và số điện
thoại.
Email liên hệ công ty
Số điện thoại công ty
Token hóa thanh toán Kiểm tra mã thông báo thanh toán. Để biết thêm thông tin,
hãy xem Giao dịch thanh toán (ở trang 69).
quản lý quyết định Kiểm tra Quyết định quản lý. Để biết thêm thông tin, hãy xem
Trình quản lý Quyết định (ở trang 87).
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Cấu hình Thanh toán| 20
Chi Tiết Hồ Sơ (tiếp theo)

Dữ liệu chi tiết Kiểm tra dữ liệu chi tiết. Để biết thêm thông tin, hãy xem
Tạo thiết bị Kiểm tra Tạo vân tay thiết bị. Để biết thêm thông tin,
vân tay hãy xem Trình quản lý Quyết định (ở trang 87).
5. Nhấp vào Gửi.
Cấu hình phương thức thanh toán
Bạn phải định cấu hình ít nhất một phương thức thanh toán trước khi có thể kích hoạt hồ sơ.
Trang lựa chọn phương thức thanh toán được hiển thị như một phần của quy trình thanh toán cho bất kỳ trường hợp
nào sau đây:
• Nhiều phương thức thanh toán được bật cho cấu hình và không có trường phương thức thanh toán nào được
bao gồm trong yêu cầu.
• payment_method=visacheckout được bao gồm trong yêu cầu.
• Visa Click to Pay là phương thức thanh toán duy nhất được kích hoạt cho hồ sơ. Xem Kích hoạt Phương thức Thanh
toán cho Visa Click to Pay (ở trang 26).
Quan trọng: Visa Click to Pay sử dụng các trường API và dịch vụ Visa Checkout.
Bạn có thể bỏ qua việc hiển thị trang lựa chọn phương thức thanh toán bằng cách chỉ định thẻ hoặc séc làm phương thức
thanh toán khả dụng duy nhất. Xem Kích hoạt kiểm tra điện tử (ở trang 24).
Khách hàng có thể thay đổi phương thức thanh toán trong quá trình thanh toán.
Thêm loại thẻ và tiền tệ
Đối với mỗi loại thẻ bạn chọn, bạn cũng có thể quản lý tiền tệ và các tùy chọn xác thực người trả tiền.
Chỉ chọn các loại thẻ thanh toán và đơn vị tiền tệ mà nhà cung cấp tài khoản người bán của bạn cho phép.
Số xác minh thẻ (CVN) là một số có ba hoặc bốn chữ số giúp đảm bảo rằng khách hàng sở hữu thẻ tại thời điểm giao
dịch.
2. Chọn một hồ sơ. Trang Cài đặt chung xuất hiện.
3. Nhấp vào Cài đặt thanh toán. Trang Cài đặt thanh toán xuất hiện.
4. Nhấp vào Thêm loại thẻ. Danh sách các loại thẻ xuất hiện.
5. Kiểm tra từng loại thẻ mà bạn muốn cung cấp cho khách hàng làm phương thức thanh toán. Của bạn
bộ xử lý thanh toán phải hỗ trợ các loại thẻ.
6. Nhấp vào biểu tượng cài đặt cho từng loại thẻ. Cài đặt thẻ và danh sách tiền tệ xuất hiện.
7. Kiểm tra Hiển thị CVN để hiển thị trường CVN trên Chấp nhận An toàn. khách hàng quyết định
có nên vào CVN không. Cybersource khuyên bạn nên hiển thị CVN để giảm gian lận.
8. Kiểm tra CVN Bắt buộc. Tùy chọn Hiển thị CVN cũng phải được chọn. Nếu tùy chọn này được chọn, khách hàng được
yêu cầu nhập CVN. Cybersource khuyên bạn nên yêu cầu CVN giảm gian lận.
9. Kiểm tra xác thực người trả tiền.
10. Kiểm tra các loại tiền tệ cho mỗi thẻ.
Theo mặc định, tất cả các loại tiền tệ được liệt kê là bị vô hiệu hóa. Bạn phải chọn ít nhất một loại tiền tệ.
Liên hệ với nhà cung cấp tài khoản người bán của bạn để biết danh sách các đơn vị tiền tệ được hỗ trợ. Nếu
bạn chọn loại thẻ Elo hoặc Hipercard, chỉ có loại tiền thực của Brazil được hỗ trợ.
11. Nhấp vào Gửi. Các loại thẻ được thêm làm loại thanh toán được chấp nhận.
12. Nhấp vào Lưu.
Cấu hình xác thực người trả tiền
Trước khi có thể sử dụng Xác thực người thanh toán, bạn phải liên hệ với bộ phận Hỗ trợ khách hàng để định cấu hình
tài khoản của mình. ID người bán của bạn phải được kích hoạt để xác thực người trả tiền. Để biết thêm thông
tin về xác thực người trả tiền, hãy xem Xác thực người trả tiền bằng API SCMP (PDF| HTML) và Xác thực Người thanh toán
bằng API Đặt hàng Đơn giản (PDF| HTML).
Xác thực người trả tiền là triển khai 3D Secure. Nó ngăn chặn việc sử dụng thẻ trái phép và cung cấp khả năng bảo vệ
bổ sung khỏi hoạt động bồi hoàn gian lận. Chấp nhận an toàn hỗ trợ 3D Secure 1.0 và 2.0.
Đối với Chấp nhận an toàn, Cybersource hỗ trợ các loại xác thực người trả tiền sau:
• Khóa an toàn American Express
• China UnionPay (chỉ 3D Secure 2.0)
• Diners ProtectBuy
• J/Secure của JCB
• Kiểm tra danh tính Mastercard
• Visa an toàn
Đối với mỗi giao dịch, bạn sẽ nhận được thông tin chi tiết trong các câu trả lời và trong trang chi tiết
giao dịch của Business Center. Bạn có thể lưu trữ thông tin này trong 12 tháng. Cybersource khuyên bạn nên
lưu trữ dữ liệu xác thực người thanh toán vì bạn có thể được yêu cầu hiển thị thông tin này dưới dạng xác
minh đăng ký cho bất kỳ giao dịch xác thực người thanh toán nào mà bạn xuất trình lại do khoản bồi hoàn.
Nhà cung cấp tài khoản người bán của bạn có thể yêu cầu bạn cung cấp tất cả dữ liệu ở định dạng mà con người có thể đọc được.
Ngôn ngữ được sử dụng trên mỗi trang xác thực người thanh toán do ngân hàng phát hành của bạn xác
định và ghi đè ngôn ngữ bạn đã chỉ định. Nếu bạn sử dụng số thẻ kiểm tra cho mục đích kiểm tra, ngôn ngữ
mặc định được sử dụng trên trang xác thực người trả tiền là tiếng Anh và sẽ ghi đè ngôn ngữ bạn đã chỉ định.
Xem Kiểm tra và Xem giao dịch (ở trang 89).
Định cấu hình xác thực người trả tiền
4. Chọn phiên bản 3D Secure. Nếu bạn chọn 3D Secure 2.0 và nhà phát hành thẻ chưa sẵn sàng cho
3D Secure 2.0, thì một số giao dịch vẫn có thể xác thực qua 3D Secure 1.0. Trường phản hồi
payer_authentication_specution_version cho biết phiên bản nào đã được sử dụng.
5. Nhấp vào Lưu. Các loại thẻ hỗ trợ xác thực người thanh toán là:
• Amex
• Cartes Bancaires
• China UnionPay
• Câu lạc bộ thực khách
• JCB
• Thẻ Mastercard
• Nhạc trưởng (Nội địa hoặc Quốc tế tại Vương quốc Anh)
• Hộ chiếu
Kích hoạt đảo ngược ủy quyền tự động
Đối với các giao dịch không trả về Hệ thống xác minh địa chỉ (AVS) hoặc Số xác minh thẻ (CVN) khớp, bạn có thể bật
Chấp nhận an toàn để thực hiện đảo ngược ủy quyền tự động. Việc đảo ngược tự động sẽ giải phóng số tiền dự trữ được
giữ trên thẻ của khách hàng.
4. Kiểm tra Thất bại Kiểm tra AVS. Ủy quyền được tự động đảo ngược trên một giao dịch không thành công
AV kiểm tra.
5. Kiểm tra Không kiểm tra CVN. Ủy quyền được tự động đảo ngược trên một giao dịch không thành công
CVN kiểm tra.
Quan trọng: Khi các tùy chọn AVS và CVN bị tắt và giao dịch không thành công
AVS hoặc CVN kiểm tra, khách hàng được thông báo rằng giao dịch đã được chấp nhận. Bạn được thông báo
để xem lại các chi tiết giao dịch. Xem Các loại thông báo (ở trang 232).
Kích hoạt kiểm tra điện tử
Séc điện tử là khoản thanh toán được thực hiện trực tiếp từ tài khoản ngân hàng ở Hoa Kỳ hoặc Canada của khách hàng của
bạn. Là một phần của quy trình thanh toán, bạn phải hiển thị tuyên bố điều khoản và điều kiện để kiểm tra. Để biết thêm
thông tin, hãy xem hướng dẫn kích hoạt TeleCheck .
Khách hàng phải chấp nhận các điều khoản và điều kiện trước khi gửi đơn đặt hàng. Trong tuyên bố điều khoản và điều kiện,
bạn nên bao gồm liên kết đến bảng phí hàng bị trả lại. Bảng liệt kê theo tiểu bang số tiền mà khách hàng của bạn phải trả
khi séc được trả lại.
4. Kiểm tra Kích hoạt Thanh toán Echeck. Danh sách các loại tài khoản xuất hiện.
5. Kiểm tra (các) loại tài khoản:
• Kiểm tra
• Tiết kiệm
• Kiểm tra doanh nghiệp
• Sổ Cái
6. Nhấp vào Thêm tiền tệ. Trang cài đặt echeck xuất hiện.
7. Kiểm tra Chọn tất cả hoặc kiểm tra từng loại tiền tệ.
Bạn phải định cấu hình các trường thông tin kiểm tra điện tử. Xem Định cấu hình trường thông tin Echeck (ở trang
32).
Cấu hình Click to Pay của Visa
Bạn phải đăng ký Visa Click to Pay và tạo hồ sơ Visa Click to Pay trước khi có thể kích hoạt nó làm phương thức thanh
toán. Xem Bắt đầu với Visa Click to Pay (PDF| HTML). Chỉ các loại giao dịch ủy quyền và bán hàng mới được hỗ trợ cho các
giao dịch Visa Click to Pay.
Trang lựa chọn phương thức thanh toán được hiển thị như một phần của quy trình thanh toán cho các tình huống sau:
• Visa Click to Pay là phương thức thanh toán duy nhất được kích hoạt cho hồ sơ.
Visa Click to Pay yêu cầu khách hàng chỉ nhập tên người dùng và mật khẩu để thanh toán hàng hóa.
Nó loại bỏ nhu cầu nhập thông tin tài khoản, vận chuyển và thanh toán. Khách hàng đăng nhập vào tài khoản Visa Click
to Pay của họ và chọn thẻ mà họ muốn thanh toán. Nếu cấu hình Chấp nhận an toàn được bật để yêu cầu dịch vụ xác thực
người thanh toán cho một loại thẻ cụ thể, khách hàng sẽ được chuyển hướng đến màn hình xác thực người thanh toán
có liên quan trước khi Chấp nhận an toàn xử lý giao dịch và chuyển hướng khách hàng đến trang web của bạn.
Định cấu hình Visa Nhấp để thanh toán
1. Trong bảng điều hướng bên trái, hãy chọn Cấu hình thanh toán > Giải pháp thanh toán kỹ thuật số. Các
Trang Giải pháp thanh toán kỹ thuật số xuất hiện.
2. Nhấp vào Định cấu hình. Thỏa thuận dịch vụ người bán của Visa xuất hiện.
3. Xem lại Thỏa thuận Dịch vụ Nhấp chuột để Thanh toán của Visa, sau đó nhấp vào Đồng ý và Tạo Tài khoản. Bảng Cấu
hình Nhấp để Thanh toán của Visa mở ra phần Cấu hình Người bán.
4. Nhập chi tiết thanh toán của bạn.
Kích hoạt phương thức thanh toán cho Visa Nhấp để thanh toán
4. Kiểm tra Bật Visa Nhấp để thanh toán.
5. Nhập tên của hồ sơ Visa Click to Pay sẽ được sử dụng. Nếu không có tên hồ sơ nào được nhập, hồ sơ Visa
Click to Pay mặc định sẽ được sử dụng.
6. Kiểm tra các loại thẻ để yêu cầu dịch vụ xác thực đối tượng thanh toán:
• Visa—dịch vụ Visa Secure được yêu cầu.
• Mastercard—dịch vụ Kiểm tra Danh tính Mastercard được yêu cầu.
• American Express—dịch vụ American Express SafeKey được yêu cầu.
Xem Cấu hình xác thực người trả tiền (ở trang 22).
7. Cho biết thời điểm từ chối giao dịch dựa trên một tiêu chí nhất định:
• Chi tiết địa chỉ thanh toán không chính xác (AVS không thành công).
• Mã bảo mật không đúng (CVV/CVN fail).
• Điểm rủi ro Nhấp để thanh toán của Visa cao hơn điểm quy định của bạn. Chọn điểm rủi ro để
sử dụng với mô hình gian lận của bạn. Giá trị bằng 0 cho biết điểm rủi ro sẽ không được tính đến
và điểm rủi ro cao hơn cho biết rủi ro gian lận được nhận thức cao hơn.
Kích hoạt PayPal Express Checkout
PayPal Express Checkout không được hỗ trợ trên tích hợp iframe Chấp nhận an toàn.
Liên hệ với bộ phận Hỗ trợ khách hàng của Cybersource để định cấu hình tài khoản của bạn cho tính năng này.
Bạn cũng phải tạo một tài khoản doanh nghiệp PayPal. Xem Dịch vụ PayPal Express Checkout Sử dụng API SCMP (PDF |
HTML) hoặc Dịch vụ PayPal Express Checkout Sử dụng API Đặt hàng Đơn giản (PDF| HTML).
Thêm phương thức thanh toán PayPal Express Checkout vào trang lựa chọn phương thức thanh toán Tích hợp
Checkout được lưu trữ. Chuyển hướng khách hàng đến đăng nhập tài khoản PayPal của họ. Khi đăng nhập vào
tài khoản PayPal, họ có thể xem lại đơn đặt hàng và chỉnh sửa chi tiết giao hàng hoặc thanh toán trước khi
hoàn tất giao dịch.
Trang lựa chọn phương thức thanh toán được hiển thị như một phần của quy trình thanh toán khi nhiều
phương thức thanh toán được bật cho cấu hình và không có trường phương thức thanh toán nào được đưa
vào yêu cầu. Nếu bạn bao gồm payment_method=paypal trong yêu cầu, trang lựa chọn phương thức thanh toán
sẽ không được hiển thị và khách hàng được chuyển hướng đến PayPal.
4. Kiểm tra Bật PayPal Express Checkout.
5. Kiểm tra Cho phép khách hàng chọn hoặc chỉnh sửa địa chỉ giao hàng của họ trong PayPal để cho phép
khách hàng chỉnh sửa chi tiết địa chỉ giao hàng mà họ đã cung cấp trong yêu cầu giao dịch để Chấp nhận
an toàn. Khách hàng chọn địa chỉ mới hoặc chỉnh sửa địa chỉ khi đăng nhập vào tài khoản PayPal.
6. Khi loại giao dịch là ủy quyền, hãy chọn một trong các tùy chọn sau:
• Yêu cầu ủy quyền PayPal và bao gồm các giá trị phản hồi ủy quyền trong phản hồi—chọn tùy chọn
này để tạo và ủy quyền đơn đặt hàng PayPal.
Quan trọng: Tiền của khách hàng không bị thu hồi khi sử dụng tùy chọn này. Bạn phải yêu cầu
chụp PayPal; xem hướng dẫn PayPal. Nếu loại giao dịch là bán, Chấp nhận an toàn sẽ ủy quyền và
thu hồi tiền của khách hàng.
• Yêu cầu thiết lập đơn hàng PayPal và bao gồm các giá trị phản hồi thiết lập đơn hàng trong phản hồi
—chọn tùy chọn này để tạo đơn hàng PayPal.
Quan trọng: Tiền của khách hàng không được ủy quyền hoặc thu hồi bằng cách sử dụng tùy chọn này.
Bạn phải yêu cầu ủy quyền PayPal, sau đó là yêu cầu chụp PayPal; xem hướng dẫn PayPal. Nếu loại
giao dịch là bán, Chấp nhận an toàn sẽ ủy quyền và thu hồi tiền của khách hàng.
Khóa bảo mật
Bạn phải tạo khóa bảo mật trước khi có thể kích hoạt cấu hình.
Bạn không thể sử dụng cùng một khóa bảo mật cho cả giao dịch thử nghiệm và sản xuất. Bạn phải tải xuống khóa bảo mật
cho từng phiên bản Chấp nhận an toàn để thử nghiệm và sản xuất.
Trên trang Cài đặt Cấu hình, nhấp vào Bảo mật. Trang Khóa bảo mật xuất hiện. Tập lệnh bảo mật ký vào các trường yêu
cầu bằng khóa bí mật và thuật toán HMAC SHA256. Để xác minh dữ liệu, tập lệnh bảo mật tạo chữ ký để so sánh với chữ
ký được trả về từ máy chủ Chấp nhận an toàn. Khóa bảo mật sẽ hết hạn sau hai năm và bảo vệ từng giao dịch khỏi
bị giả mạo dữ liệu.
Tạo khóa bảo mật

1. Đăng nhập vào Business Center.
4. Nhấp vào Bảo mật. Trang khóa bảo mật xuất hiện.
5. Nhấp vào nút Tạo khóa dấu cộng (+).
6. Nhập tên khóa (bắt buộc).
7. Chọn phiên bản chữ ký 1 (mặc định).
8. Chọn phương thức chữ ký HMAC-SHA256 (mặc định).
9. Nhấp vào Tạo.
10. Nhấp vào Xác nhận. Cửa sổ Tạo khóa mới mở rộng và hiển thị khóa truy cập mới và
chìa khoá bí mật. Bảng điều khiển này sẽ đóng sau 30 giây.
11. Sao chép và lưu hoặc tải xuống khóa truy cập và khóa bí mật.
• Khóa truy cập: Xác thực Lớp cổng bảo mật (SSL) với Chấp nhận an toàn. Bạn có thể có nhiều khóa truy
cập cho mỗi hồ sơ. Xem Mẫu ngôn ngữ viết kịch bản (ở trang 68).
• Khóa bí mật: ký dữ liệu giao dịch và bắt buộc phải có cho mỗi giao dịch. Sao chép và dán khóa bí
mật này vào tập lệnh bảo mật của bạn. Xem "Mẫu trong Ngôn ngữ Tập lệnh" (ở trang 68).
Quan trọng: Hãy nhớ xóa các khóa đã sao chép khỏi khay nhớ tạm hoặc bộ nhớ đệm
ký ức.
Theo mặc định, khóa bảo mật mới sẽ hoạt động. Các tùy chọn khác cho mỗi khóa bảo mật là:
• Hủy kích hoạt: hủy kích hoạt khóa bảo mật. Khóa bảo mật không hoạt động.
• Kích hoạt: kích hoạt khóa bảo mật không hoạt động.
• Xem: hiển thị khóa truy cập và khóa bảo mật.
Khi bạn tạo khóa bảo mật, khóa đó sẽ hiển thị trong bảng khóa bảo mật. Bạn có thể chọn một hàng trong bảng để hiển thị
khóa truy cập và khóa bí mật cho khóa bảo mật cụ thể đó.

Hình thức thanh toán là trải nghiệm thanh toán của khách hàng. Nó bao gồm một loạt trang hoặc dưới dạng một trang
thanh toán duy nhất trong đó khách hàng nhập hoặc xem lại thông tin trước khi gửi giao dịch. Chọn các trường mà
bạn muốn hiển thị trên một trang thanh toán hoặc trên mỗi trang của quy trình thanh toán nhiều bước: lập hóa đơn,
giao hàng, thanh toán và xem xét đơn hàng.
Định cấu hình biểu mẫu thanh toán
3. Nhấp vào Hình thức thanh toán. Trang Biểu mẫu thanh toán xuất hiện.
4. Chọn quy trình hình thức thanh toán:
• Hình thức thanh toán nhiều bước —quy trình thanh toán bao gồm một chuỗi các trang mà khách hàng nhập
hoặc xem xét thông tin trước khi gửi giao dịch. Trình tự mặc định là lựa chọn thanh toán (nếu nhiều
phương thức thanh toán được bật), thanh toán, vận chuyển, thanh toán, xem xét và nhận.
• Biểu mẫu một trang —quy trình thanh toán bao gồm một trang mà khách hàng nhập hoặc xem lại thông tin
trước khi gửi giao dịch.
Không nhấp vào Lưu cho đến khi bạn đã chọn các trường thanh toán hoặc vận chuyển hoặc cả hai.
5. Kiểm tra Hiển thị tổng số tiền thuế trong từng bước của quy trình kiểm tra.
Tổng số tiền thuế phải được bao gồm trong mỗi giao dịch. Tính toán và bao gồm tổng số tiền thuế trong trường
tax_amount .
Định cấu hình trường thông tin thanh toán
Quan trọng: Chọn các trường thông tin thanh toán mà nhà cung cấp thương gia của bạn yêu cầu.
Nếu quốc gia thanh toán là Hoa Kỳ hoặc Canada, bạn có thể chọn trường mã tiểu bang làm trường bắt buộc.
Cybersource khuyến nghị rằng nếu quốc gia thanh toán là Hoa Kỳ hoặc Canada, thì các trường mã tiểu bang và mã
bưu chính sẽ được chọn theo yêu cầu. Nếu quốc gia thanh toán nằm ở phần còn lại của thế giới, bạn cũng có thể chọn
trường mã tiểu bang làm trường bắt buộc.
Chọn các trường thông tin thanh toán của khách hàng mà bạn muốn hiển thị trên Chấp nhận an toàn. Nếu các trường này
được ghi lại ở giai đoạn trước của quy trình đặt hàng (ví dụ: trên trang web của bạn), chúng có thể được chuyển vào
Chấp nhận an toàn dưới dạng các trường biểu mẫu ẩn. Xem Trường yêu cầu (ở trang 92). Bạn có thể rút ngắn quá trình
thanh toán bằng cách không chọn thông tin thanh toán.
4. Kiểm tra thông tin thanh toán. Các trường thông tin thanh toán xuất hiện.
5. Kiểm tra các trường thông tin thanh toán mà nhà cung cấp thương gia của bạn yêu cầu. Các tùy chọn cho mỗi
trường là:
• Hiển thị: khách hàng có thể xem thông tin hiển thị trong trường này. Chọn tùy chọn này nếu bạn muốn điền trước
các trường thông tin thanh toán khi Thanh toán trên máy chủ được chấp nhận an toàn được hiển thị—các
trường này phải được chuyển vào Chấp nhận an toàn dưới dạng các trường biểu mẫu ẩn.
• Chỉnh sửa: khách hàng có thể xem và chỉnh sửa thông tin thanh toán trên Thanh toán được lưu trữ trên máy
chủ được chấp nhận an toàn. Khi bạn chọn tùy chọn này, tùy chọn hiển thị sẽ tự động được chọn.
• Yêu cầu: khách hàng được yêu cầu nhập thông tin thanh toán trên Thanh toán được lưu trữ trên máy
chủ được chấp nhận an toàn trước khi gửi giao dịch. Khi bạn chọn tùy chọn này, tất cả các tùy chọn khác sẽ
tự động được chọn.
Không nhấp vào Lưu cho đến khi bạn đã chọn các trường thanh toán và xem lại đơn đặt hàng.
6. Cho biết có nên ẩn các trường nhạy cảm hay không.
Định cấu hình các trường thông tin vận chuyển
Chọn các trường thông tin vận chuyển mà nhà cung cấp thương gia của bạn yêu cầu.
Chọn các trường thông tin vận chuyển của khách hàng mà bạn muốn hiển thị trên Chấp nhận an toàn. Các trường này là tùy chọn.
Nếu bạn không thêm các trường này, bước thông tin vận chuyển sẽ bị xóa khỏi Chấp nhận an toàn. Nếu các trường này
được ghi lại ở giai đoạn trước của quy trình đặt hàng (ví dụ: trên trang web của bạn), chúng có thể được chuyển vào Chấp
nhận an toàn dưới dạng các trường biểu mẫu ẩn. Xem Trường yêu cầu (ở trang 92). Bạn có thể rút ngắn quy trình thanh
toán bằng cách không chọn thông tin giao hàng.
4. Kiểm Tra Thông Tin Vận Chuyển.
5. Kiểm tra các trường thông tin vận chuyển mà nhà cung cấp thương gia của bạn yêu cầu. Các tùy chọn cho
mỗi lĩnh vực là:
• Hiển thị: khách hàng có thể xem thông tin hiển thị trong trường này. Chọn tùy chọn này nếu bạn muốn điền sẵn các
trường thông tin vận chuyển khi Thanh toán trên máy chủ được chấp nhận an toàn được hiển thị—các trường này
phải được chuyển vào Chấp nhận an toàn dưới dạng các trường biểu mẫu ẩn.
• Chỉnh sửa: khách hàng có thể xem và chỉnh sửa thông tin giao hàng trên Thanh toán được lưu trữ trên máy chủ chấp
nhận an toàn. Khi bạn chọn tùy chọn này, tùy chọn hiển thị sẽ tự động được chọn.
• Yêu cầu: khách hàng được yêu cầu nhập thông tin giao hàng trên Thanh toán được lưu trữ trên máy chủ
được chấp nhận an toàn trước khi họ gửi giao dịch. Khi bạn chọn tùy chọn này, tất cả các tùy chọn khác sẽ tự
động được chọn.
Không nhấp vào Lưu cho đến khi bạn đã chọn các trường đánh giá vận chuyển và đơn hàng.
Định cấu hình trường thông tin Echeck
Chọn các trường thông tin tài khoản kiểm tra điện tử mà nhà cung cấp thương gia của bạn yêu cầu.
Chọn các trường thông tin tài khoản kiểm tra điện tử của khách hàng mà bạn muốn hiển thị trên Chấp nhận an toàn.
4. Kiểm tra thông tin tài khoản echeck để được đưa vào Chấp nhận an toàn. Các tùy chọn cho
các trường thông tin kiểm tra điện tử khi Thanh toán được lưu trữ trên máy chủ được chấp nhận an toàn được
hiển thị.
• Chỉnh sửa: khách hàng có thể xem và chỉnh sửa thông tin séc điện tử trên Thanh toán được lưu trữ trên máy chủ
được chấp nhận an toàn. Khi bạn chọn tùy chọn này, tùy chọn hiển thị sẽ tự động được chọn.
• Yêu cầu: khách hàng được yêu cầu nhập thông tin kiểm tra điện tử trên Thanh toán được lưu trữ trên
máy chủ được chấp nhận an toàn trước khi gửi giao dịch. Khi bạn chọn tùy chọn này, tất cả các tùy chọn khác
sẽ tự động được chọn.
Định cấu hình chi tiết đánh giá đơn hàng
Chọn các trường mà bạn muốn hiển thị trên trang Đánh giá đơn hàng của thanh toán Chấp nhận an toàn. Khách hàng xem
xét thông tin này trước khi gửi giao dịch.
4. Kiểm tra các trường bạn muốn hiển thị trên trang Đánh giá đơn hàng của Chấp nhận an toàn
Thanh toán được lưu trữ. Các tùy chọn cho từng trường là:
• Hiển thị: khách hàng có thể xem thông tin chứa trong trường này. Chỉ có sẵn cho thông tin thanh toán và vận
chuyển.
• Chỉnh sửa: khách hàng có thể xem và chỉnh sửa thông tin có trong trường này.
Thông báo của người bán
Chấp nhận an toàn gửi thông báo cho người bán và khách hàng để phản hồi các giao dịch. Bạn có thể nhận được thông báo
của người bán qua email hoặc dưới dạng HTTPS POST tới một URL cho mỗi giao dịch được xử lý. Cả hai thông báo đều chứa
dữ liệu kết quả giao dịch giống nhau.
Đảm bảo rằng hệ thống của bạn xác nhận thông báo POST (ngay cả khi đang tải) nhanh nhất có thể. Sự chậm trễ hơn 10 giây
có thể dẫn đến sự chậm trễ đối với các thông báo POST trong tương lai.
Quan trọng: Cybersource khuyên bạn nên triển khai URL POST của người bán để nhận
thông báo về từng giao dịch. Phân tích cú pháp phản hồi giao dịch được gửi tới URL POST của người bán và lưu trữ dữ
liệu trong hệ thống quản lý đơn đặt hàng của bạn. Điều này đảm bảo tính chính xác của các giao dịch và thông báo
cho bạn khi giao dịch được xử lý thành công.
Định cấu hình thông báo của người bán
3. Nhấp vào Thông báo. Trang Thông báo xuất hiện.
4. Chọn thông báo người bán theo một trong hai cách sau:
• Kiểm tra URL BÀI ĐĂNG của Người bán. Nhập URL HTTPS.
Cybersource gửi thông tin giao dịch tới URL này. Để biết thêm thông tin, hãy xem Trường
phản hồi (ở trang 173). Chỉ nên sử dụng URL HTTPS hỗ trợ TLS 1.2 trở lên cho URL POST của
người bán. Nếu bạn gặp phải bất kỳ sự cố nào, hãy liên hệ với bộ phận Hỗ trợ khách hàng của
Cybersource.
• Kiểm tra Email POST của Người bán. Nhập địa chỉ email của bạn.
Cybersource gửi thông tin phản hồi giao dịch đến địa chỉ email này bao gồm thông tin thanh
toán, mã trả lại và tất cả thông tin đặt hàng có liên quan. Xem Trường phản hồi (ở trang 173).
5. Chọn các chữ số của số thẻ mà bạn muốn hiển thị trong biên lai của người bán hoặc khách hàng:
• Trả lại thẻ thanh toán BIN: hiển thị Số nhận dạng ngân hàng (BIN) của thẻ, là tám chữ số đầu tiên
của số thẻ. Tất cả các chữ số khác được che dấu: 12345678xxxxxxxx
• Trả về bốn số cuối của số thẻ thanh toán: hiển thị bốn số cuối của số thẻ. Tất cả các chữ số
khác được che dấu: xxxxxxxxxxxx1234
• Trả về BIN và bốn số cuối của số thẻ thanh toán: hiển thị BIN và bốn số cuối của số thẻ. Tất
cả các chữ số khác được che dấu: 12345678xxxx1234
Biên lai khách hàng
Bạn có thể gửi email biên nhận mua hàng cho khách hàng của mình và một bản sao đến địa chỉ email của chính bạn. Cả hai đều
là tùy chọn. Khách hàng có thể trả lời các câu hỏi liên quan đến việc mua hàng của họ, vì vậy hãy sử dụng tài khoản email
đang hoạt động. Định dạng email là HTML trừ khi email khách hàng của bạn ở định dạng văn bản có định dạng (RTF).
Định cấu hình thông báo khách hàng
4. Kiểm tra Email đã nhận cho khách hàng.
5. Nhập địa chỉ email của người gửi sẽ được hiển thị trên biên lai của khách hàng. khách hàng sẽ
trả lời email này với bất kỳ câu hỏi nào.
6. Nhập tên người gửi của doanh nghiệp bạn. Nó được hiển thị trên biên nhận của khách hàng.
7. Chọn Gửi một bản sao đến. Cài đặt này là tùy chọn.
8. Nhập địa chỉ email của bạn để nhận bản sao biên lai của khách hàng.
Bản sao biên lai khách hàng của bạn sẽ chứa thông tin phản hồi giao dịch bổ sung.
9. Kiểm tra Logo thông báo hiển thị.
10. Nhấp vào Tải lên Logo Công ty. Tìm và tải lên hình ảnh mà bạn muốn hiển thị trên biên lai và email của khách
hàng.
Tệp hình ảnh không được vượt quá 840 (w) x 60 (h) pixel và phải là GIF, JPEG hoặc PNG. Tên tệp biểu trưng không
được chứa bất kỳ ký tự đặc biệt nào, chẳng hạn như dấu gạch nối (-).
11. Kiểm tra biên nhận email tùy chỉnh.
Cybersource khuyên bạn nên triển khai cấu hình DNS để bật Cybersource thay mặt bạn gửi biên nhận qua email.
12. Kiểm tra loại biên nhận email bạn muốn gửi cho khách hàng:
• Nhận email tiêu chuẩn: email này được dịch tự động dựa trên ngôn ngữ được sử dụng cho
sự giao dịch.
• Nhận email tùy chỉnh: email này có thể được tùy chỉnh bằng văn bản và tham chiếu dữ liệu. Phần nội dung
email chứa chi tiết giao dịch xuất hiện giữa đầu trang và chân trang. Văn bản tùy chỉnh không được dịch
khi bạn sử dụng các ngôn ngữ khác nhau.
13. Kiểm tra Chủ đề email tùy chỉnh và nhập tối đa 998 ký tự. Khi số lượng tối đa của
ký tự bị vượt quá, tiêu đề chủ đề mặc định là Xác nhận đơn hàng.
Bạn có thể chèn thẻ thông minh email vào phần chủ đề email, đầu trang và chân trang để bao gồm thông tin cụ
thể. Chọn từng thẻ thông minh từ danh sách thả xuống và nhấp vào Chèn.
Trang phản hồi của khách hàng
Bạn phải định cấu hình trang phản hồi của khách hàng trước khi có thể kích hoạt hồ sơ.
Bạn có thể chọn hiển thị trang phản hồi giao dịch cho khách hàng khi kết thúc quá trình thanh toán và
trang phản hồi hủy hiển thị trong quá trình thanh toán. Nhập URL cho trang phản hồi khách hàng của riêng bạn
hoặc sử dụng các trang phản hồi được lưu trữ trên Cybersource. Tùy thuộc vào kết quả giao dịch, các trang
phản hồi được lưu trữ trên Cybersource là Chấp nhận, Từ chối hoặc Lỗi. Xem lại các đơn đặt hàng bị từ chối
càng sớm càng tốt vì bạn có thể khắc phục các sự cố liên quan đến xác minh địa chỉ hoặc thẻ hoặc bạn có thể nhận
được ủy quyền bằng lời nói. Bạn cũng có thể chọn hiển thị trang web cho khách hàng sau khi quá trình thanh
toán hoàn tất.
Định cấu hình Trang phản hồi được lưu trữ trên Cybersource
3. Nhấp vào Phản hồi của khách hàng. Trang Phản hồi của Khách hàng xuất hiện.
4. Dưới tiêu đề Trang phản hồi giao dịch, hãy kiểm tra Được lưu trữ bởi Cybersource.
5. Dưới tiêu đề Thông báo phản hồi giao dịch, hãy chọn một số từ Giới hạn thử lại
danh sách thả xuống. Số lần tối đa một khách hàng có thể thử lại một giao dịch bị từ chối là năm lần.
6. Trong tiêu đề Chuyển hướng của khách hàng sau khi thanh toán, hãy nhập URL chuyển hướng của trang web.
Trang web này được hiển thị cho khách hàng sau khi quá trình thanh toán hoàn tất.
7. Nhấp vào Lưu. Trang Cài đặt Cấu hình xuất hiện.
Định cấu hình Trang phản hồi được lưu trữ tùy chỉnh
4. Bên dưới tiêu đề Trang phản hồi giao dịch, hãy chọn Do bạn lưu trữ.
5. Nhập URL cho trang phản hồi khách hàng của bạn. Sử dụng cổng 80, 443 hoặc 8080 trong URL của bạn.
Chỉ nên sử dụng cổng 443 với URL HTTPS.
Yêu cầu POST với dữ liệu giao dịch được cung cấp cho URL này sau khi khách hàng hoàn tất thanh toán.
Yêu cầu POST chứa giá trị mã lý do của giao dịch, giúp bạn xác định các hành động có thể thực
hiện đối với giao dịch.
Xem Mã lý do (ở trang 227).
danh sách thả xuống. Số lần tối đa một khách hàng có thể thử lại một giao dịch bị từ chối là 5 lần.
Định cấu hình Trang phản hồi được lưu trữ trên nguồn mạng tùy chỉnh
4. Bên dưới tiêu đề Trang phản hồi hủy tùy chỉnh, hãy chọn Được lưu trữ bởi Cybersource.
Định cấu hình Trang phản hồi hủy tùy chỉnh
4. Bên dưới tiêu đề Trang phản hồi hủy tùy chỉnh, hãy chọn Do bạn lưu trữ.
Yêu cầu POST chứa giá trị mã lý do của giao dịch, giúp bạn xác định các hành động có thể thực hiện đối với
giao dịch.
Giao diện thanh toán tùy chỉnh
Tùy chỉnh giao diện và thương hiệu của các trang thanh toán Chấp nhận an toàn bằng cách chọn màu nền, phông chữ và màu
văn bản. Tải lên biểu trưng hoặc hình ảnh và căn chỉnh nó trong đầu trang hoặc chân trang.
Cybersource khuyên bạn nên xem trước các thay đổi của mình trong cửa sổ Xem trước hình ảnh.
Để hiển thị hình ảnh dưới dạng biểu ngữ tiêu đề của biểu mẫu thanh toán, kích thước hình ảnh không được vượt quá 840
(w) x 60 (h) pixel và kích thước hình ảnh không được vượt quá 100 kB. Để hiển thị một biểu trưng nhỏ trong biểu ngữ
tiêu đề, chiều cao của biểu trưng không được vượt quá 60 pixel. Tệp hình ảnh phải là GIF, JPEG hoặc PNG.
Thay đổi nội dung tiêu đề
3. Nhấp vào Xây dựng thương hiệu. Trang Xây dựng thương hiệu xuất hiện.
4. Kiểm tra Tiêu đề Hiển thị.
5. Nhấp vào biểu tượng màu tiêu đề.
6. Chọn màu theo một trong hai cách sau:
• Nhập giá trị thập lục phân cho màu tiêu đề của biểu mẫu thanh toán.
• Nhấp vào trong bảng màu tiêu đề để chọn màu. Nhấp vào biểu tượng màu để xác nhận lựa chọn của bạn.
7. Nhấp vào Duyệt để tải lên hình ảnh để hiển thị dưới dạng biểu ngữ tiêu đề hoặc biểu trưng trong
biểu ngữ tiêu đề.
8. Chọn tùy chọn căn chỉnh cho hình ảnh hoặc logo: căn trái, căn giữa hoặc căn phải.
Thay đổi cài đặt màu cơ thể và phông chữ
4. Chọn màu nền cho phần thân chính theo một trong hai cách sau:
• Nhập giá trị thập lục phân cho màu nền.
5. Chọn phông chữ văn bản từ danh sách thả xuống.
6. Chọn màu văn bản theo một trong hai cách sau:
• Nhập giá trị thập lục phân cho màu văn bản.
8. Nhấp vào Đặt thành mặc định để khôi phục tất cả các cài đặt mặc định trên trang này.
Thay đổi Tổng số tiền Nền và Màu văn bản
Quan trọng: Nếu bạn đang triển khai phiên bản nhúng iframe, thì tổng số tiền không được hiển thị trong iframe. Bất kỳ
cài đặt nào bạn chọn bên dưới đều bị bỏ qua.
4. Chọn màu nền theo một trong hai cách sau:
• Nhập giá trị thập lục phân cho màu văn bản của tổng số tiền.
7. Nhấp vào Đặt thành mặc định để khôi phục tất cả cài đặt mặc định trên trang này.
Thay đổi màu thanh tiến trình
• Nhập giá trị thập lục phân cho màu của thanh tiến trình.
Thay đổi Màu sắc và Văn bản trên Nút Thanh toán hoặc Kết thúc
4. Chọn màu nền của nút thanh toán hoặc nút kết thúc theo một trong hai cách sau:
5. Chọn màu của văn bản thanh toán hoặc nút kết thúc theo một trong hai cách sau:
• Nhập giá trị thập lục phân cho văn bản.
• Nhấp vào trong bảng màu tiêu đề để chọn màu. Nhấp vào biểu tượng ở dưới cùng bên phải để xác nhận lựa chọn
của bạn.
6. Kiểm tra Thay đổi nút văn bản. Một hộp văn bản xuất hiện cho nút thanh toán.
7. Nhập văn bản bạn muốn hiển thị trên nút thanh toán. Văn bản nút này là bắt buộc.
8. Nhập văn bản bạn muốn hiển thị trên nút kết thúc. Văn bản nút này là bắt buộc.
Thay đổi màu chân trang và tải lên một biểu trưng hoặc hình ảnh nhỏ
4. Kiểm tra chân trang hiển thị.
• Nhập giá trị thập lục phân cho màu chân trang của biểu mẫu thanh toán.
6. Nhấp vào Duyệt để tải lên logo chân trang. Tải lên hình ảnh mà bạn muốn hiển thị ở chân trang của biểu mẫu thanh
toán.
Để hiển thị logo hoặc hình ảnh nhỏ ở chân trang của biểu mẫu thanh toán, tệp không được vượt quá 840 (w) x 60 (h)
pixel. Tệp hình ảnh phải là GIF, JPEG hoặc PNG.
7. Chọn tùy chọn căn chỉnh cho hình ảnh: căn trái, căn giữa hoặc căn phải.
Bản địa hóa ngôn ngữ thanh toán
Chấp nhận an toàn hỗ trợ nhiều ngôn ngữ. Bảng này liệt kê tất cả các ngôn ngữ được hỗ trợ và mã ngôn ngữ
mà bạn phải đưa vào biểu mẫu thanh toán của mình.
Từ danh sách, bao gồm mã ngôn ngữ trong trường yêu cầu ngôn ngữ trên biểu mẫu thanh toán của bạn. Xem
Quy trình Giao dịch Mẫu Sử dụng JSP (ở trang 68).
Ví dụ: tiếng Anh Mỹ
<input type="hidden" name="locale" value="en-us">
Mã địa phương
Ngôn ngữ Mã địa phương
tiếng Ả Rập ar-xn
tiếng Catalunya ca-es
Trung Quốc—Hồng Kông zh-hk
Trung Quốc—Macau zh-mo
Trung Quốc—Đại lục zh-cn
Trung Quốc—Singapore zh-sg
Trung Quốc—Đài Loan zh-tw
tiếng Croatia giờ-giờ
tiếng séc cs-cz
người Đan Mạch da-dk
tiếng Hà Lan nl-nl
Anh—Hoa Kỳ en-us
Anh—Úc en-au
Anh—Vương quốc Anh en-gb
Anh—Canada en-ca
Anh—Ireland tức là
Anh—New Zealand en-nz
Phần Lan viễn tưởng
Mã vùng (tiếp theo)
người Pháp f RFR
Tiếng Pháp—Canada fr-ca
tiếng Đức de-de
Tiếng Đức—Áo hủy bỏ
người Hy Lạp
el-gr
tiếng Do Thái he-il
Hungary hu-hu
tiếng Indonesia tôi đã làm
người Ý nó nó
tiếng Nhật ja-jp
Hàn Quốc ko-kr
Cộng hòa Dân chủ nhân dân Lào lo la
tiếng Bahasa Malaysia ms-my
tiếng Nauy (Bokmal) nb-không
Tiếng Tagalog của Philippines tl-ph
Đánh bóng làm ơn làm ơn
Tiếng Bồ Đào Nha—Brasil pt-br
tiếng Nga ru-ru
tiếng Slovakia sk-sk
người Tây Ban Nha

es-es
Tây Ban Nha—Argentina es-ar
Tiếng Tây Ban Nha—Chile es-cl
Tiếng Tây Ban Nha—Colombia es-co
Tây Ban Nha—Mexico es-mx
Tây Ban Nha—Peru đặc biệt
Tiếng Tây Ban Nha—Hoa Kỳ es-us
Thụy Điển sv-se
tiếng Thái th-th
Thổ Nhĩ Kỳ tr-tr
Mã vùng (tiếp theo)
Tiếng Việt vi-vn
Kích hoạt một hồ sơ
Bạn phải hoàn thành các cài đặt bắt buộc được mô tả trong từng phần này trước khi có thể kích hoạt cấu hình:
• Cấu hình phương thức thanh toán (ở trang 21)
• Khóa bảo mật (ở trang 28)
• Trang Phản hồi của Khách hàng (ở trang 36)
1. Trên ngăn điều hướng bên trái, nhấp vào Cấu hình thanh toán > Cài đặt chấp nhận an toàn.
2. Thực hiện một trong các bước sau:
• Trên tab Cấu hình Hoạt động, hãy chọn cấu hình mà bạn muốn kích hoạt và nhấp vào biểu tượng
Biểu tượng Quảng cáo Hồ sơ .
• Trên trang Chỉnh sửa Hồ sơ, hãy nhấp vào biểu tượng Quảng cáo Hồ sơ .
3. Nhấp vào Xác nhận.
Tùy chọn hồ sơ bổ sung
• Hủy kích hoạt—hủy kích hoạt cấu hình đang hoạt động. Hồ sơ hiện được liệt kê trong danh sách hồ sơ không hoạt động.
Tùy chọn này chỉ khả dụng cho một cấu hình đang hoạt động.
• Tạo Phiên bản Có thể Chỉnh sửa—sao chép cấu hình đang hoạt động và tạo một phiên bản có thể chỉnh sửa. Phiên bản
có thể chỉnh sửa được liệt kê trong danh sách hồ sơ không hoạt động. Tùy chọn này chỉ khả dụng cho một cấu hình
đang hoạt động.
• Quảng cáo thành Hoạt động—kích hoạt cấu hình không hoạt động. Tùy chọn này chỉ khả dụng cho một cấu hình không hoạt
động.
Quản lý danh mục đầu tư cho các đại lý
Người bán lại: Tạo Hồ sơ chấp nhận an toàn
Liên hệ với bộ phận Hỗ trợ khách hàng của Cybersource để kích hoạt tài khoản của bạn để Chấp nhận an toàn.
Bạn phải kích hoạt một hồ sơ để sử dụng nó. Xem Kích hoạt Hồ sơ (ở trang 44).
2. Trong bảng điều hướng bên trái, chọn Quản lý danh mục đầu tư > Cài đặt chấp nhận an toàn.
3. Nhấp vào Hồ sơ mới. Trang Tạo hồ sơ xuất hiện.
4. Nhập hoặc xác minh các chi tiết hồ sơ này.
Chi tiết hồ sơ
Tên hồ sơ Tên hồ sơ Chấp nhận An toàn là bắt buộc và không được

vượt quá 40 ký tự chữ và số.
Mô tả tiểu sử Mô tả hồ sơ không được vượt quá 255 ký tự.
Phương pháp tích hợp Kiểm tra tích hợp thanh toán được lưu trữ.
Tên công ty Tên công ty là bắt buộc và không được vượt quá 40 ký tự
chữ và số.
Tên liên hệ công ty Nhập thông tin liên hệ của công ty: tên, email và số điện
thoại.
Email liên hệ công ty
Số điện thoại công ty
Token hóa thanh toán Kiểm tra mã thông báo thanh toán. Để biết thêm thông tin,
hãy xem Giao dịch thanh toán (ở trang 69).
quản lý quyết định Kiểm tra Quyết định quản lý. Để biết thêm thông tin, hãy xem
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Quản lý danh mục đầu tư cho đại lý| 45
Chi Tiết Hồ Sơ (tiếp theo)

Dữ liệu chi tiết Kiểm tra dữ liệu chi tiết. Để biết thêm thông tin, hãy xem
Tạo thiết bị Kiểm tra Tạo vân tay thiết bị. Để biết thêm thông tin,
vân tay hãy xem Trình quản lý Quyết định (ở trang 87).
Cấu hình phương thức thanh toán
Bạn phải định cấu hình ít nhất một phương thức thanh toán trước khi có thể kích hoạt hồ sơ.
Trang lựa chọn phương thức thanh toán được hiển thị như một phần của quy trình thanh toán cho bất kỳ trường hợp
nào sau đây:
• Visa Click to Pay là phương thức thanh toán duy nhất được kích hoạt cho hồ sơ. Xem Người bán lại: Định cấu hình
Nhấp để thanh toán Visa (ở trang 51).
Bạn có thể bỏ qua trang lựa chọn phương thức thanh toán bằng cách chỉ định thẻ hoặc séc làm phương thức thanh toán
khả dụng duy nhất. Xem Reseller: Kích hoạt Echecks (ở trang 49).
Khách hàng có thể thay đổi phương thức thanh toán trong quá trình thanh toán.
Người bán lại: Thêm loại thẻ và tiền tệ
Đối với mỗi loại thẻ bạn chọn, bạn cũng có thể quản lý tiền tệ và các tùy chọn xác thực người trả tiền.
Chỉ chọn các loại thẻ thanh toán và đơn vị tiền tệ mà nhà cung cấp tài khoản người bán của bạn cho phép.
Số Xác minh Thẻ (CVN) là một số có ba hoặc bốn chữ số giúp đảm bảo rằng khách hàng sở hữu thẻ tại thời điểm giao
dịch.
1. Trong bảng điều hướng bên trái, chọn Quản lý danh mục đầu tư > Hồ sơ chấp nhận an toàn.
Trang Hồ sơ chấp nhận an toàn xuất hiện.
4. Nhấp vào Thêm loại thẻ. Danh sách các loại thẻ xuất hiện.
5. Kiểm tra từng loại thẻ mà bạn muốn cung cấp cho khách hàng làm phương thức thanh toán. Của bạn
bộ xử lý thanh toán phải hỗ trợ các loại thẻ.
6. Nhấp vào Cài đặt cho từng loại thẻ. Cài đặt thẻ và danh sách tiền tệ xuất hiện.
7. Kiểm tra Hiển thị CVN để hiển thị trường CVN trên Chấp nhận An toàn. Khách hàng quyết định có vào CVN hay
không. Cybersource khuyên bạn nên hiển thị CVN để giảm gian lận.
8. Kiểm tra CVN Bắt buộc. Tùy chọn Hiển thị CVN cũng phải được chọn. Nếu tùy chọn này được chọn, khách hàng được
yêu cầu nhập CVN. Cybersource khuyến nghị yêu cầu CVN giảm gian lận.
9. Kiểm tra các loại tiền tệ cho mỗi thẻ.
Quan trọng: Theo mặc định, tất cả các đơn vị tiền tệ được liệt kê là bị vô hiệu hóa. Bạn phải chọn ít
nhất một loại tiền tệ. Liên hệ với nhà cung cấp tài khoản người bán của bạn để biết danh sách các đơn vị
tiền tệ được hỗ trợ. Nếu bạn chọn loại thẻ Elo hoặc Hipercard, chỉ có loại tiền Real của Brazil được hỗ trợ.
10. Nhấp vào Gửi. Các loại thẻ được thêm làm loại thanh toán được chấp nhận.
Cấu hình xác thực người trả tiền
Trước khi có thể sử dụng Xác thực người thanh toán của Cybersource, bạn phải liên hệ với bộ phận Hỗ trợ khách hàng
của Cybersource để Cybersource có thể định cấu hình tài khoản của bạn. ID người bán của bạn phải được kích hoạt để
xác thực người trả tiền. Để biết thêm thông tin về xác thực người trả tiền, hãy xem Xác thực người trả tiền bằng
API SCMP (PDF| HTML) và Xác thực Người thanh toán bằng API Đặt hàng Đơn giản (PDF| HTML).
Xác thực người thanh toán là triển khai Cybersource của 3D Secure. Nó ngăn chặn việc sử dụng thẻ trái phép và cung cấp
khả năng bảo vệ bổ sung khỏi hoạt động bồi hoàn gian lận. Chấp nhận an toàn hỗ trợ 3D Secure 1.0 và 2.0.
Đối với Chấp nhận an toàn, Cybersource hỗ trợ các loại xác thực người trả tiền sau:
• Khóa an toàn American Express
• China UnionPay (chỉ 3D Secure 2.0)
• Diners ProtectBuy
• J/Secure của JCB
• Kiểm tra danh tính Mastercard
• Visa an toàn
Đối với mỗi giao dịch, bạn sẽ nhận được thông tin chi tiết trong các câu trả lời và trong trang chi tiết giao dịch của
Business Center. Bạn có thể lưu trữ thông tin này trong 12 tháng. Cybersource khuyên bạn nên lưu trữ dữ liệu xác thực
người thanh toán vì bạn có thể được yêu cầu hiển thị thông tin này dưới dạng xác minh đăng ký cho bất kỳ giao dịch xác
thực người thanh toán nào mà bạn xuất trình lại do khoản bồi hoàn.
Nhà cung cấp tài khoản người bán của bạn có thể yêu cầu bạn cung cấp tất cả dữ liệu ở định dạng mà con người có thể đọc được.
Ngôn ngữ được sử dụng trên mỗi trang xác thực người thanh toán do ngân hàng phát hành của bạn xác định và ghi đè
ngôn ngữ mà bạn đã chỉ định. Nếu bạn sử dụng số thẻ kiểm tra, ngôn ngữ mặc định được sử dụng trên trang xác thực người
trả tiền là tiếng Anh và sẽ ghi đè ngôn ngữ bạn đã chỉ định. Xem Kiểm tra và Xem giao dịch (ở trang 89).
Người bán lại: Định cấu hình xác thực người trả tiền
4. Chọn phiên bản 3D Secure mà bạn muốn sử dụng. Nếu bạn chọn 3D Secure 2.0 và thẻ
nhà phát hành chưa sẵn sàng cho 3D Secure 2.0, một số giao dịch vẫn có thể xác thực qua 3D Secure 1.0.
Trường phản hồi payer_authentication_specution_version cho biết phiên bản nào đã được sử dụng.
5. Nhấp vào Lưu. Các loại thẻ hỗ trợ xác thực người thanh toán là:
• Amex
• Cartes Bancaires
• China UnionPay
• Câu lạc bộ thực khách
• JCB
• Thẻ Mastercard
• Nhạc trưởng (Nội địa hoặc Quốc tế tại Vương quốc Anh)
• Hộ chiếu
Người bán lại: Kích hoạt đảo ngược ủy quyền tự động
Đối với các giao dịch không trả về Hệ thống xác minh địa chỉ (AVS) hoặc Số xác minh thẻ (CVN) khớp, bạn có thể bật
Chấp nhận an toàn để thực hiện đảo ngược ủy quyền tự động. Việc đảo ngược tự động sẽ giải phóng số tiền dự trữ được
giữ trên thẻ của khách hàng.
4. Kiểm tra Thất bại Kiểm tra AVS. Ủy quyền được tự động đảo ngược trên một giao dịch không thành công
AV kiểm tra.
5. Kiểm tra Không kiểm tra CVN. Ủy quyền được tự động đảo ngược trên một giao dịch không thành công
CVN kiểm tra.
Quan trọng: Khi các tùy chọn AVS và CVN bị tắt và giao dịch không thành công
AVS hoặc CVN kiểm tra, khách hàng được thông báo rằng giao dịch đã được chấp nhận. Bạn được thông báo để
xem lại các chi tiết giao dịch. Xem Các loại thông báo (ở trang 232).
Người bán lại: Kích hoạt Echecks
Séc điện tử là khoản thanh toán được thực hiện trực tiếp từ tài khoản ngân hàng ở Hoa Kỳ hoặc Canada của khách hàng của
bạn. Là một phần của quy trình thanh toán, bạn phải hiển thị tuyên bố điều khoản và điều kiện để kiểm tra. Để biết thêm
thông tin, hãy xem hướng dẫn kích hoạt TeleCheck .
Khách hàng phải chấp nhận các điều khoản và điều kiện trước khi gửi đơn đặt hàng. Trong tuyên bố điều khoản và điều kiện,
bạn nên bao gồm một liên kết đến bảng phí trả lại hàng. Bảng liệt kê theo tiểu bang số tiền mà khách hàng của bạn phải trả khi
séc được trả lại.
4. Kiểm tra Kích hoạt Thanh toán Echeck. Danh sách các loại tài khoản xuất hiện.
5. Kiểm tra (các) loại tài khoản:
• Kiểm tra
• Tiết kiệm
• Kiểm tra doanh nghiệp
• Sổ Cái
6. Nhấp vào Thêm tiền tệ. Trang cài đặt echeck xuất hiện.
7. Kiểm tra Chọn tất cả hoặc chọn một loại tiền tệ.
Bạn phải định cấu hình các trường thông tin kiểm tra điện tử. Xem Reseller: Cấu hình trường thông tin Echeck(ở
trang 57).
Cấu hình Click to Pay của Visa
Bạn phải đăng ký Visa Click to Pay và tạo hồ sơ Visa Click to Pay trước khi có thể kích hoạt nó làm phương thức thanh
toán. Xem Bắt đầu với Visa Click to Pay (PDF| HTML). Chỉ các loại giao dịch ủy quyền và bán hàng mới được hỗ trợ cho các
giao dịch Visa Click to Pay.
Trang lựa chọn phương thức thanh toán được hiển thị như một phần của quy trình thanh toán cho một trong các trường
hợp sau:
• Nhiều phương thức thanh toán được bật cho cấu hình và không có trường phương thức thanh toán nào được đưa vào
yêu cầu.
• Visa Click to Pay là phương thức thanh toán duy nhất được kích hoạt cho hồ sơ.
Visa Click to Pay yêu cầu khách hàng chỉ nhập tên người dùng và mật khẩu để thanh toán hàng hóa.
Nó loại bỏ nhu cầu nhập thông tin tài khoản, vận chuyển và thanh toán. Khách hàng đăng nhập vào tài khoản Visa Click
to Pay của họ và chọn thẻ mà họ muốn thanh toán. Nếu cấu hình Chấp nhận an toàn được bật để yêu cầu dịch vụ xác thực
người thanh toán cho một loại thẻ cụ thể, khách hàng sẽ được chuyển hướng đến màn hình xác thực người thanh toán
có liên quan trước khi Chấp nhận an toàn xử lý giao dịch và chuyển hướng khách hàng đến trang web của bạn.
Người bán lại: Định cấu hình Visa Click to Pay
4. Kiểm tra Bật Visa Nhấp để thanh toán.
6. Trong bảng điều hướng bên trái, chọn Cấu hình thanh toán > Giải pháp thanh toán kỹ thuật số.
Để định cấu hình phương thức thanh toán cho Visa Click to Pay, hãy đăng nhập vào Business Center và đi đến Định cấu
hình Visa Nhấp để thanh toán.
Người bán lại: Kích hoạt PayPal Express Checkout
PayPal Express Checkout không được hỗ trợ trên tích hợp iframe Chấp nhận an toàn.
Liên hệ với bộ phận Hỗ trợ khách hàng của Cybersource để định cấu hình tài khoản Cybersource của bạn cho tính năng này.
Bạn cũng phải tạo một tài khoản doanh nghiệp PayPal; xem Dịch vụ PayPal Express Checkout Sử dụng API SCMP (PDF| HTML) hoặc
Dịch vụ PayPal Express Checkout Sử dụng API Đặt hàng Đơn giản (PDF| HTML).
Thêm phương thức thanh toán PayPal Express Checkout vào trang lựa chọn phương thức thanh toán Tích hợp thanh toán
được lưu trữ trên máy chủ được chấp nhận an toàn. Chuyển hướng khách hàng đến đăng nhập tài khoản PayPal của họ.
Khi đăng nhập vào tài khoản PayPal, họ có thể xem lại đơn đặt hàng và chỉnh sửa chi tiết giao hàng hoặc thanh toán trước khi
hoàn tất giao dịch.
Trang lựa chọn phương thức thanh toán được hiển thị như một phần của quy trình thanh toán khi nhiều phương thức thanh
toán được bật cho cấu hình và không có trường phương thức thanh toán nào được đưa vào yêu cầu. Nếu bạn bao gồm
payment_method=paypal trong yêu cầu, trang lựa chọn phương thức thanh toán sẽ không được hiển thị và khách hàng được
chuyển hướng đến PayPal.
4. Kiểm tra Bật PayPal Express Checkout.
Phí dịch vụ
Liên hệ với bộ phận Hỗ trợ khách hàng của Cybersource để định cấu hình tài khoản Cybersource của bạn cho tính năng này.
Phí dịch vụ chỉ được hỗ trợ nếu Wells Fargo là ngân hàng mua của bạn và FDC Nashville Global là bên xử lý thanh toán của
bạn.
Cài đặt phí dịch vụ áp dụng cho các phương thức thanh toán bằng thẻ và séc điện tử. Để chỉ áp dụng phí dịch vụ cho một
phương thức thanh toán, hãy tạo hai hồ sơ Chấp nhận an toàn với các phương thức thanh toán phù hợp được bật trên mỗi hồ
sơ: một có bật tính năng phí dịch vụ và một có tính năng phí dịch vụ bị tắt.
Là một phần của quy trình thanh toán, bạn phải hiển thị tuyên bố điều khoản và điều kiện cho phí dịch vụ. Khách hàng phải
chấp nhận các điều khoản và điều kiện trước khi gửi đơn đặt hàng.
Người bán lại: Kích hoạt phí dịch vụ
4. Phí dịch vụ kiểm tra áp dụng cho các giao dịch sử dụng hồ sơ này. URL điều khoản và điều kiện phí dịch vụ và số
tiền phí dịch vụ được thêm vào trang đánh giá của khách hàng.
Cảnh báo: Giao dịch không thành công nếu bạn tắt tính năng này. Không tắt tính năng này trừ khi
hướng dẫn để làm như vậy bởi người quản lý tài khoản của bạn.
Quan trọng: Sau khi lưu hồ sơ, bạn không thể tắt chức năng tính phí dịch vụ
cho hồ sơ đó. Tất cả các giao dịch sử dụng hồ sơ sẽ bao gồm số tiền phí dịch vụ.
Khóa bảo mật
Quan trọng: Bạn phải tạo khóa bảo mật trước khi có thể kích hoạt cấu hình.
Bạn không thể sử dụng cùng một khóa bảo mật cho cả giao dịch thử nghiệm và sản xuất. Bạn phải tải xuống khóa bảo mật cho từng
phiên bản Chấp nhận an toàn để thử nghiệm và sản xuất.
Trên trang Cài đặt Cấu hình, nhấp vào Bảo mật. Trang Khóa bảo mật xuất hiện. Tập lệnh bảo mật ký vào các
trường yêu cầu bằng khóa bí mật và thuật toán HMAC SHA256. Để xác minh dữ liệu, tập lệnh bảo mật tạo chữ ký
để so sánh với chữ ký được trả về từ máy chủ Chấp nhận an toàn. Bạn phải có khóa bảo mật đang hoạt động
để kích hoạt một cấu hình. Khóa bảo mật sẽ hết hạn sau hai năm và bảo vệ từng giao dịch khỏi bị giả mạo dữ
liệu.
Người bán lại: Tạo khóa bảo mật
1. Trong bảng điều hướng bên trái, hãy chọn Cấu hình thanh toán > Quản lý khóa.
2. Nhấp vào Tạo khóa.
3. Chọn loại khóa.
4. Nhấp vào Bước tiếp theo.
5. Chọn loại phụ chính Chấp nhận An toàn.
6. Nhấp vào Bước tiếp theo.
7. Nhập tên khóa (bắt buộc).
8. Chọn phiên bản chữ ký 1.
9. Chọn phương thức chữ ký HMAC-SHA256.
10. Chọn một cấu hình bảo mật.
12. Nhấp vào Tạo khóa. Cửa sổ Tạo khóa mới mở rộng và hiển thị khóa truy cập mới và
chìa khoá bí mật. Cửa sổ này đóng sau 30 giây.
13. Sao chép và lưu khóa truy cập và khóa bí mật.
• Khóa truy cập: Xác thực Lớp cổng bảo mật (SSL) với Chấp nhận an toàn. Bạn có thể có nhiều khóa
truy cập cho mỗi hồ sơ. Xem Mẫu ngôn ngữ viết kịch bản (ở trang 68).
• Khóa bí mật: ký dữ liệu giao dịch và bắt buộc phải có cho mỗi giao dịch. Sao chép và dán
khóa bí mật này vào tập lệnh bảo mật của bạn. Xem Mẫu ngôn ngữ viết kịch bản (ở trang 68).
Quan trọng: Hãy nhớ xóa các khóa đã sao chép khỏi khay nhớ tạm hoặc bộ nhớ đệm
ký ức.
Theo mặc định, khóa bảo mật mới sẽ hoạt động. Các tùy chọn khác cho mỗi khóa bảo mật là:
• Hủy kích hoạt: hủy kích hoạt khóa bảo mật. Khóa bảo mật không hoạt động.
• Kích hoạt: kích hoạt khóa bảo mật không hoạt động.
• Xem: hiển thị khóa truy cập và khóa bảo mật.
Khi bạn tạo khóa bảo mật, khóa đó sẽ hiển thị trong bảng khóa bảo mật. Bạn có thể chọn một hàng trong bảng để
hiển thị khóa truy cập và khóa bí mật cho khóa bảo mật cụ thể đó.
14. Nhấp vào Quản lý khóa. Trang Quản lý khóa xuất hiện.

Hình thức thanh toán là trải nghiệm thanh toán của khách hàng. Nó bao gồm một loạt trang hoặc dưới dạng một trang
thanh toán duy nhất trong đó khách hàng nhập hoặc xem lại thông tin trước khi gửi giao dịch. Chọn các trường mà bạn
muốn hiển thị trên một trang thanh toán hoặc trên mỗi trang của quy trình thanh toán nhiều bước: lập hóa đơn, giao
hàng, thanh toán và xem xét đơn hàng.
Người bán lại: Định cấu hình biểu mẫu thanh toán
4. Chọn quy trình hình thức thanh toán:
• Hình thức thanh toán nhiều bước—quy trình thanh toán bao gồm một chuỗi các trang mà khách hàng nhập
hoặc xem xét thông tin trước khi gửi giao dịch. Trình tự mặc định là lựa chọn thanh toán (nếu nhiều
phương thức thanh toán được bật), thanh toán, vận chuyển, thanh toán, xem xét và nhận.
• Biểu mẫu một trang—quy trình thanh toán bao gồm một trang mà khách hàng nhập hoặc xem lại thông tin
trước khi gửi giao dịch.
5. Kiểm tra Hiển thị tổng số tiền thuế trong từng bước của quy trình kiểm tra.
Tổng số tiền thuế phải được bao gồm trong mỗi giao dịch. Tính toán và bao gồm tổng số tiền thuế trong trường
tax_amount .
Người bán lại: Định cấu hình trường thông tin thanh toán
Quan trọng: Chọn các trường thông tin thanh toán mà nhà cung cấp thương gia của bạn yêu cầu.
Nếu quốc gia thanh toán là Hoa Kỳ hoặc Canada, bạn có thể chọn trường mã tiểu bang làm trường bắt buộc.
Cybersource khuyến nghị rằng nếu quốc gia thanh toán là Hoa Kỳ hoặc Canada, thì mã tiểu bang và các trường mã bưu
điện sẽ được chọn theo yêu cầu. Nếu quốc gia thanh toán nằm ở phần còn lại của thế giới, bạn cũng có thể chọn trường mã
tiểu bang làm trường bắt buộc.
Chọn các trường thông tin thanh toán của khách hàng mà bạn muốn hiển thị trên Chấp nhận an toàn. Nếu các trường này được
ghi lại ở giai đoạn trước của quy trình đặt hàng (ví dụ: trên trang web của bạn), chúng có thể được chuyển vào Chấp nhận
an toàn dưới dạng các trường biểu mẫu ẩn. Xem Trường yêu cầu (ở trang 92). Bạn có thể rút ngắn quá trình thanh toán
bằng cách không chọn thông tin thanh toán.
4. Kiểm tra thông tin thanh toán. Các trường thông tin thanh toán xuất hiện.
5. Kiểm tra các trường thông tin thanh toán mà nhà cung cấp thương gia của bạn yêu cầu. Các tùy chọn cho mỗi
trường là:
các trường thông tin thanh toán khi Thanh toán trên máy chủ được chấp nhận an toàn được hiển thị—các trường
này phải được chuyển vào Chấp nhận an toàn dưới dạng các trường biểu mẫu ẩn.
• Chỉnh sửa: khách hàng có thể xem và chỉnh sửa thông tin thanh toán trên Thanh toán được lưu trữ trên máy
• Yêu cầu: khách hàng được yêu cầu nhập thông tin thanh toán trên Thanh toán được lưu trữ trên máy
chủ được chấp nhận an toàn trước khi gửi giao dịch. Khi bạn chọn tùy chọn này, tất cả các tùy chọn khác sẽ
Không nhấp vào Lưu cho đến khi bạn đã chọn các trường thanh toán và xem lại đơn đặt hàng.
Người bán lại: Định cấu hình các trường thông tin vận chuyển
Chọn các trường thông tin vận chuyển mà nhà cung cấp thương gia của bạn yêu cầu.
Chọn các trường thông tin vận chuyển của khách hàng mà bạn muốn hiển thị trên Chấp nhận an toàn. Các trường này là tùy chọn.
Nếu bạn không thêm các trường này, bước thông tin vận chuyển sẽ bị xóa khỏi Chấp nhận an toàn. Nếu các trường này
được ghi lại ở giai đoạn trước của quy trình đặt hàng (ví dụ: trên trang web của bạn), chúng có thể được chuyển vào Chấp
nhận an toàn dưới dạng các trường biểu mẫu ẩn. Xem Trường yêu cầu (ở trang 92). Bạn có thể rút ngắn quá trình thanh
toán bằng cách không chọn thông tin thanh toán.
4. Kiểm Tra Thông Tin Vận Chuyển.
5. Kiểm tra các trường thông tin vận chuyển mà nhà cung cấp thương gia của bạn yêu cầu. các tùy chọn
cho mỗi lĩnh vực là:
các trường thông tin vận chuyển khi Tích hợp thanh toán được lưu trữ trên máy chủ của Chấp nhận an toàn
được hiển thị—các trường này phải được chuyển vào Chấp nhận an toàn dưới dạng các trường biểu mẫu ẩn.
• Chỉnh sửa: khách hàng có thể xem và chỉnh sửa thông tin giao hàng trên Thanh toán được lưu trữ trên máy chủ
chấp nhận an toàn. Khi bạn chọn tùy chọn này, tùy chọn hiển thị sẽ tự động được chọn.
• Yêu cầu: khách hàng được yêu cầu nhập thông tin giao hàng trên Thanh toán được lưu trữ trên máy chủ
được chấp nhận an toàn trước khi họ gửi giao dịch. Khi bạn chọn tùy chọn này, tất cả các tùy chọn khác sẽ
Không nhấp vào Lưu cho đến khi bạn đã chọn các trường đánh giá vận chuyển và đơn hàng.
Người bán lại: Định cấu hình các trường thông tin Echeck
Chọn các trường thông tin tài khoản kiểm tra điện tử mà nhà cung cấp thương gia của bạn yêu cầu.
Chọn các trường thông tin tài khoản kiểm tra điện tử của khách hàng mà bạn muốn hiển thị trên Chấp nhận an toàn.
4. Kiểm tra thông tin tài khoản echeck để được đưa vào Chấp nhận an toàn. Các tùy chọn cho
các trường thông tin kiểm tra điện tử khi Thanh toán được lưu trữ trên máy chủ được chấp nhận an toàn
được hiển thị.
• Chỉnh sửa: khách hàng có thể xem và chỉnh sửa thông tin séc điện tử trên Thanh toán được lưu trữ trên máy
• Yêu cầu: khách hàng được yêu cầu nhập thông tin kiểm tra điện tử trên Thanh toán được lưu trữ trên
máy chủ được chấp nhận an toàn trước khi gửi giao dịch. Khi bạn chọn tùy chọn này, tất cả các tùy chọn
khác sẽ tự động được chọn.
Không Lưu cho đến khi bạn đã chọn các trường kiểm tra thông tin tài khoản và đánh giá đơn hàng.
Người bán lại: Định cấu hình Chi tiết Đánh giá Đơn hàng
Chọn các trường mà bạn muốn hiển thị trên trang Đánh giá đơn hàng của Thanh toán được lưu trữ trên máy chủ được chấp
nhận an toàn. Khách hàng xem xét thông tin này trước khi gửi giao dịch.
4. Kiểm tra các trường bạn muốn hiển thị trên trang Đánh giá đơn hàng của Chấp nhận an toàn
Thanh toán được lưu trữ. Các tùy chọn cho từng trường là:
• Hiển thị: khách hàng có thể xem thông tin chứa trong trường này. Chỉ có sẵn cho thông tin thanh toán và vận
chuyển.
• Chỉnh sửa: khách hàng có thể xem và chỉnh sửa thông tin có trong trường này.
Thông báo của người bán
Chấp nhận an toàn gửi thông báo cho người bán và khách hàng để phản hồi các giao dịch. Bạn có thể nhận
được thông báo của người bán qua email hoặc dưới dạng HTTPS POST tới một URL cho mỗi giao dịch được xử
lý. Cả hai thông báo đều chứa dữ liệu kết quả giao dịch giống nhau.
Đảm bảo rằng hệ thống của bạn xác nhận thông báo POST (ngay cả khi đang tải) nhanh nhất có thể. Sự chậm
trễ hơn 10 giây có thể dẫn đến sự chậm trễ đối với các thông báo POST trong tương lai.
Quan trọng: Cybersource khuyên bạn nên triển khai URL POST của người bán để nhận
thông báo về từng giao dịch. Phân tích cú pháp phản hồi giao dịch được gửi tới URL POST của người bán
và lưu trữ dữ liệu trong hệ thống quản lý đơn đặt hàng của bạn. Điều này đảm bảo tính chính xác
của các giao dịch và thông báo cho bạn khi giao dịch được xử lý thành công.
Người bán lại: Định cấu hình Thông báo Người bán
4. Chọn thông báo người bán theo một trong hai cách sau:
• Kiểm tra URL BÀI ĐĂNG của Người bán. Nhập URL HTTPS. Cybersource gửi thông tin giao dịch
tới URL này. Để biết thêm thông tin, hãy xem Trường phản hồi (ở trang 173).
Chỉ nên sử dụng URL HTTPS hỗ trợ TLS 1.2 trở lên cho URL POST của người bán. Nếu bạn gặp phải
bất kỳ sự cố nào, hãy liên hệ với bộ phận Hỗ trợ khách hàng của Cybersource.
• Kiểm tra Email POST của Người bán. Nhập địa chỉ email của bạn.
Cybersource gửi thông tin phản hồi giao dịch đến địa chỉ email này bao gồm thông tin thanh
toán, mã trả lại và tất cả thông tin đặt hàng có liên quan. Xem Trường phản hồi (ở trang 173).
5. Chọn các chữ số của số thẻ mà bạn muốn hiển thị trong biên lai của người bán hoặc khách hàng:
• Trả lại thẻ thanh toán BIN: hiển thị Số nhận dạng ngân hàng (BIN) của thẻ, là tám chữ số đầu tiên
của số thẻ. Tất cả các chữ số khác được che dấu: 12345678xxxxxxxx
• Trả về bốn số cuối của số thẻ thanh toán: hiển thị bốn số cuối của số thẻ. Tất cả các chữ số khác được che
dấu: xxxxxxxxxxxx1234
• Trả về BIN và bốn số cuối của số thẻ thanh toán: hiển thị BIN và bốn số cuối của số thẻ. Tất cả các chữ số
khác được che dấu: 12345678xxxx1234
Biên lai khách hàng
Bạn có thể gửi email biên nhận mua hàng cho khách hàng của mình và một bản sao đến địa chỉ email của chính bạn. Cả hai đều là
tùy chọn. Khách hàng có thể trả lời các câu hỏi liên quan đến việc mua hàng của họ, vì vậy hãy sử dụng tài khoản email đang
hoạt động. Định dạng email là HTML trừ khi email khách hàng của bạn ở định dạng văn bản có định dạng (RTF).
Người bán lại: Định cấu hình thông báo khách hàng
4. Kiểm tra Email đã nhận cho khách hàng.
5. Nhập địa chỉ email của người gửi sẽ được hiển thị trên biên lai của khách hàng. khách hàng sẽ
trả lời email này với bất kỳ câu hỏi nào.
6. Nhập tên người gửi của doanh nghiệp bạn. Nó được hiển thị trên biên nhận của khách hàng.
7. Chọn Gửi một bản sao đến. Cài đặt này là tùy chọn.
8. Nhập địa chỉ email của bạn để nhận bản sao biên lai của khách hàng.
Bản sao biên lai khách hàng của bạn sẽ chứa thông tin phản hồi giao dịch bổ sung.
9. Kiểm tra Logo thông báo hiển thị.
10. Nhấp vào Tải lên Logo Công ty. Tìm và tải lên hình ảnh mà bạn muốn hiển thị trên biên lai và email của khách
hàng.
Tệp hình ảnh không được vượt quá 840 (w) x 60 (h) pixel và phải là GIF, JPEG hoặc PNG. Tên tệp biểu trưng không được
chứa bất kỳ ký tự đặc biệt nào, chẳng hạn như dấu gạch nối (-).
11. Kiểm tra biên nhận email tùy chỉnh.
Cybersource khuyên bạn nên triển khai cấu hình DNS để bật Cybersource thay mặt bạn gửi biên nhận qua
email.
12. Kiểm tra loại biên nhận email mà bạn muốn gửi cho khách hàng:
• Nhận email tiêu chuẩn: email này được dịch tự động dựa trên ngôn ngữ được sử dụng cho
sự giao dịch.
• Nhận email tùy chỉnh: email này có thể được tùy chỉnh bằng văn bản và tham chiếu dữ liệu. Phần
nội dung email chứa chi tiết giao dịch xuất hiện giữa đầu trang và chân trang. Văn bản tùy
chỉnh không được dịch khi sử dụng các ngôn ngữ khác nhau.
13. Kiểm tra chủ đề email tùy chỉnh và nhập tối đa 998 ký tự. Khi số lượng tối đa của
ký tự bị vượt quá, tiêu đề chủ đề mặc định là Xác nhận đơn hàng.
Bạn có thể chèn thẻ thông minh email vào phần chủ đề email, đầu trang và chân trang để bao gồm thông
tin cụ thể. Chọn từng thẻ thông minh từ danh sách thả xuống và nhấp vào Chèn.
Trang phản hồi của khách hàng
Bạn phải định cấu hình trang phản hồi của khách hàng trước khi có thể kích hoạt hồ sơ.
Bạn có thể chọn hiển thị trang phản hồi giao dịch cho khách hàng khi kết thúc quá trình thanh toán và
trang phản hồi hủy hiển thị trong quá trình thanh toán. Nhập URL cho trang phản hồi khách hàng của riêng bạn
hoặc sử dụng các trang phản hồi được lưu trữ trên Cybersource. Tùy thuộc vào kết quả giao dịch, các trang
phản hồi được lưu trữ trên Cybersource là Chấp nhận, Từ chối hoặc Lỗi. Xem lại các đơn đặt hàng bị từ chối
càng sớm càng tốt vì bạn có thể khắc phục các sự cố liên quan đến xác minh địa chỉ hoặc thẻ hoặc bạn có thể nhận
được ủy quyền bằng lời nói. Bạn cũng có thể chọn hiển thị trang web cho khách hàng sau khi quá trình thanh
toán hoàn tất.
Người bán lại: Định cấu hình Trang phản hồi được lưu trữ trên Cybersource
4. Dưới tiêu đề Trang phản hồi giao dịch, hãy kiểm tra Được lưu trữ bởi Cybersource.
danh sách thả xuống. Số lần tối đa một khách hàng có thể thử lại một giao dịch bị từ chối là năm lần.
Người bán lại: Định cấu hình Trang phản hồi được lưu trữ tùy chỉnh
4. Bên dưới tiêu đề Trang phản hồi giao dịch, hãy chọn Do bạn lưu trữ.
danh sách thả xuống. Số lần tối đa một khách hàng có thể thử lại một giao dịch bị từ chối là 5 lần.
Người bán lại: Định cấu hình Trang phản hồi được lưu trữ trên nguồn mạng tùy chỉnh
4. Bên dưới tiêu đề Trang phản hồi hủy tùy chỉnh, hãy chọn Được lưu trữ bởi Cybersource.
Người bán lại: Định cấu hình Trang phản hồi hủy tùy chỉnh
4. Bên dưới tiêu đề Trang phản hồi hủy tùy chỉnh, hãy chọn Do bạn lưu trữ.
Giao diện thanh toán tùy chỉnh
Tùy chỉnh giao diện và thương hiệu của các trang thanh toán Chấp nhận an toàn bằng cách chọn màu nền, phông
chữ và màu văn bản. Tải lên biểu trưng hoặc hình ảnh và căn chỉnh nó trong đầu trang hoặc chân trang.
Cybersource khuyên bạn nên xem trước các thay đổi của mình trong cửa sổ Xem trước hình ảnh.
Để hiển thị hình ảnh dưới dạng biểu ngữ tiêu đề của biểu mẫu thanh toán, kích thước hình ảnh không được
vượt quá 840 (w) x 60 (h) pixel và kích thước hình ảnh không được vượt quá 100 kB. Để hiển thị một biểu
trưng nhỏ trong biểu ngữ tiêu đề, chiều cao của biểu trưng không được vượt quá 60 pixel. Tệp hình ảnh phải là
GIF, JPEG hoặc PNG.
Người bán lại: Thay đổi nội dung tiêu đề
4. Kiểm tra Tiêu đề Hiển thị.
5. Nhấp vào màu tiêu đề.
• Nhập giá trị thập lục phân cho màu tiêu đề của biểu mẫu thanh toán.
• Nhấp vào trong bảng màu tiêu đề để chọn màu. Nhấp vào màu để xác nhận của bạn
tuyển chọn.
7. Nhấp vào Duyệt để tải lên hình ảnh để hiển thị dưới dạng biểu ngữ tiêu đề hoặc biểu trưng trong
biểu ngữ tiêu đề.
8. Chọn tùy chọn căn chỉnh cho hình ảnh hoặc logo: căn trái, căn giữa hoặc căn phải.
Người bán lại: Thay đổi cài đặt phông chữ và màu cơ thể
4. Chọn màu nền cho phần thân chính theo một trong hai cách sau:
tuyển chọn.
5. Chọn phông chữ văn bản từ danh sách thả xuống.
• Nhập giá trị thập lục phân cho màu văn bản.
tuyển chọn.
Người bán lại: Thay đổi Màu nền và Màu Văn bản của Tổng số tiền
Quan trọng: Nếu bạn đang triển khai phiên bản nhúng iframe của Thanh toán được lưu trữ trên máy chủ được chấp
nhận an toàn, thì tổng số tiền không được hiển thị trong iframe. Bất kỳ cài đặt nào bạn chọn bên dưới đều bị bỏ qua.
4. Chọn màu nền theo một trong hai cách sau:
tuyển chọn.
• Nhập giá trị thập lục phân cho màu văn bản của tổng số tiền.
tuyển chọn.
Người bán lại: Thay đổi màu thanh tiến trình
• Nhập giá trị thập lục phân cho màu của thanh tiến trình.
tuyển chọn.
Người bán lại: Thay đổi Màu sắc và Văn bản trên Nút Thanh toán hoặc Kết thúc
4. Chọn màu nền của nút thanh toán hoặc nút kết thúc theo một trong hai cách sau:
tuyển chọn.
5. Chọn màu của văn bản thanh toán hoặc nút kết thúc theo một trong hai cách sau:
• Nhập giá trị thập lục phân cho văn bản.
• Nhấp vào trong bảng màu tiêu đề để chọn màu. Nhấp vào ở dưới cùng bên phải để xác nhận lựa chọn của bạn.
6. Kiểm tra Thay đổi nút văn bản. Một hộp văn bản xuất hiện cho nút thanh toán.
7. Nhập văn bản bạn muốn hiển thị trên nút thanh toán. Văn bản nút này là bắt buộc.
8. Nhập văn bản bạn muốn hiển thị trên nút kết thúc. Văn bản nút này là bắt buộc.
Người bán lại: Thay đổi màu chân trang và tải lên một biểu trưng hoặc hình ảnh nhỏ
4. Kiểm tra chân trang hiển thị.
• Nhập giá trị thập lục phân cho màu chân trang của biểu mẫu thanh toán.
tuyển chọn.
6. Nhấp vào Duyệt để tải lên logo chân trang. Tải lên hình ảnh mà bạn muốn hiển thị ở chân trang của biểu mẫu thanh
toán.
Để hiển thị logo hoặc hình ảnh nhỏ ở chân trang của biểu mẫu thanh toán, tệp không được vượt quá 840 (w) x 60 (h) pixel. Tệp
hình ảnh phải là GIF, JPEG hoặc PNG.
7. Chọn tùy chọn căn chỉnh cho hình ảnh: căn trái, căn giữa hoặc căn phải.
Người bán lại: Kích hoạt một Hồ sơ
Quan trọng: Bạn phải hoàn thành các cài đặt bắt buộc được mô tả trong từng phần này trước khi kích hoạt cấu hình:
• Cấu hình Phương thức Thanh toán (ở trang 46)
• Khóa bảo mật (ở trang 52)
• Trang Phản hồi của Khách hàng (ở trang 60)
2. Thực hiện một trong các bước sau:
• Trên tab Cấu hình Hoạt động, chọn một cấu hình và nhấp vào Xuất bản Cấu hình.
• Trên trang Chỉnh sửa Hồ sơ, hãy nhấp vào Xuất bản Hồ sơ.
3. Nhấp vào Xác nhận.
Người bán lại: Tùy chọn hồ sơ bổ sung
• Sao chép—sao chép cấu hình đang hoạt động và tạo một phiên bản có thể chỉnh sửa. Phiên bản có thể chỉnh sửa được
liệt kê trong danh sách hồ sơ không hoạt động. Tùy chọn này chỉ khả dụng cho một cấu hình đang hoạt động.
• Hủy kích hoạt—hủy kích hoạt cấu hình đang hoạt động. Hồ sơ hiện được liệt kê trong danh sách hồ sơ không hoạt động.
Tùy chọn này chỉ khả dụng cho một cấu hình đang hoạt động.
• Xuất bản lên Hoạt động—kích hoạt cấu hình không hoạt động. Tùy chọn này chỉ khả dụng cho một cấu hình không hoạt
động.
Ngôn ngữ kịch bản mẫu
Chấp nhận an toàn có thể hỗ trợ bất kỳ ngôn ngữ kịch bản động nào hỗ trợ thuật toán băm HMAC256.
Chọn ngôn ngữ tập lệnh bạn sử dụng để tải xuống tập lệnh mẫu:
JSP ASP.NET (C#) hồng ngọc
PHP perl VB
Quy trình giao dịch mẫu sử dụng JSP
1. tệp payment_form.jsp —thể hiện lựa chọn sản phẩm của khách hàng trên một trang web. Nhập khóa truy
cập và ID hồ sơ của bạn vào các trường tương ứng. ĐĂNG các trường lên máy chủ của bạn để ký và
tạo chữ ký. Tất cả các trường phải được bao gồm trong trường sign_field_names dưới dạng danh
sách CSV.
2. tệp security.jsp —thuật toán bảo mật ký các trường và tạo chữ ký bằng cách sử dụng
trường đã ký_field_names . Nhập khóa bảo mật của bạn vào trường SECRET_KEY . Sửa đổi tập
lệnh bảo mật để bao gồm Khóa bí mật mà bạn đã tạo trong Khóa bảo mật (ở trang 28).
Thuật toán bảo mật trong mỗi mẫu tập lệnh bảo mật chịu trách nhiệm:
• Xác thực yêu cầu—chữ ký được tạo trên máy chủ của người bán bằng mã xác thực thông điệp băm
có khóa (HMAC) ký các tham số yêu cầu bằng khóa bí mật dùng chung. Quá trình này cũng
được thực hiện trên máy chủ Chấp nhận an toàn và hai chữ ký được so sánh về tính xác thực.
• Xác thực phản hồi—chữ ký được tạo trên máy chủ Chấp nhận an toàn bằng cách HMAC ký các tham
số phản hồi, sử dụng khóa bí mật dùng chung. Quá trình này cũng được thực hiện trên máy chủ
của người bán và hai chữ ký được so sánh về tính xác thực.
3. Tệp payment_confirmation.jsp —đại diện cho trang đánh giá đơn đặt hàng của khách hàng trên một
trang web, trước khi khách hàng thanh toán. ĐĂNG giao dịch tới điểm cuối Chấp nhận an toàn và
hiển thị Tích hợp thanh toán được lưu trữ. Xem Giao dịch Thanh toán (ở trang 69).
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Ngôn ngữ kịch bản mẫu| 68
Giao dịch thanh toán
Phần này cung cấp các điểm cuối và các trường hợp sử dụng giao dịch.
Điểm cuối và loại giao dịch
Điểm cuối
Tạo điểm cuối mã thông báo thanh toán Xem Tạo mã thông báo thẻ thanh toán(ở trang 72).
Bài kiểm tra

https://testsecureacceptance.cybersource.com/token/create
Sản xuất https://secureacceptance.cybersource.com/token/create
Sản xuất tại Ấn Độ https://secureacceptance.in.cybersource.com/token/create
Loại giao tạo_thanh toán_token

dịch được hỗ trợ
Iframe Tạo điểm cuối mã thông báo thanh toán Xem Triển khai Iframe (ở trang 240).
Bài kiểm tra

https://testsecureacceptance.cybersource.com/embedded/token/create
Sản xuất https://secureacceptance.cybersource.com/embedded/token/create
Sản xuất tại Ấn Độ https://secureacceptance.in.cybersource.com/embedded/token/create
Loại giao tạo_thanh toán_token

Điểm cuối giao dịch khung nội tuyến Xem Triển khai khung nội tuyến (ở trang 240).
Bài kiểm tra

https://testsecureacceptance.cybersource.com/embedded/pay
Sản xuất https://secureacceptance.cybersource.com/embedded/pay
Sản xuất tại Ấn Độ https://secureacceptance.in.cybersource.com/embedded/pay
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Giao dịch Thanh toán| 69
Điểm cuối (tiếp theo)
Loại giao • ủy quyền

• ủy quyền,tạo_thanh toán_token
• ủy quyền,cập nhật_thanh toán_token
• doanh thu
• bán,tạo_thanh toán_token
• bán,cập nhật_thanh toán_token
• tạo_thanh toán_token
Cập nhật iframe Điểm cuối mã thông báo thanh toán Xem Triển khai Iframe (ở trang 240).
Bài kiểm tra

https://testsecureacceptance.cybersource.com/embedded/token/updat
e
Sản xuất https://secureacceptance.cybersource.com/embedded/token/update
Sản xuất tại Ấn Độ https://secureacceptance.in.cybersource.com/embedded/token/update
Loại giao cập nhật_thanh toán_token

One-Click Endpoint Xem One-Click Checkout(ở trang 17).
Bài kiểm tra

https://testsecureacceptance.cybersource.com/oneclick/pay
Sản xuất https://secureacceptance.cybersource.com/oneclick/pay
Sản xuất tại Ấn Độ https://secureacceptance.in.cybersource.com/oneclick/pay
Các loại • ủy quyền
giao dịch được hỗ trợ

• doanh thu
Xử lý điểm cuối giao dịch
Bài kiểm tra

https://testsecureacceptance.cybersource.com/pay
Sản xuất https://secureacceptance.cybersource.com/pay
Sản xuất tại Ấn Độ https://secureacceptance.in.cybersource.com/pay

• ủy quyền,tạo_thanh toán_token
Điểm cuối (tiếp theo)

• doanh thu
Cập nhật Điểm cuối Mã thông báo Thanh toán Xem Cập nhật Mã thông báo Thanh toán (ở trang 83).
Bài kiểm tra

https://testsecureacceptance.cybersource.com/token/update
Sản xuất https://secureacceptance.cybersource.com/token/update
Sản xuất tại Ấn Độ https://secureacceptance.in.cybersource.com/token/update
Loại giao cập nhật_thanh toán_token

Visa Click to PayEndpoints
Bài kiểm tra

https://testsecureacceptance.cybersource.com/pay
Sản xuất https://secureacceptance.cybersource.com/pay
Sản xuất tại Ấn Độ https://secureacceptance.in.cybersource.com/pay

• doanh thu
Các trường đã ký bắt buộc
Các trường ký bảo vệ chúng khỏi các tác nhân độc hại khi thêm hoặc thay đổi dữ liệu giao dịch trong quá trình
truyền. Để ký tên các trường, hãy đưa chúng vào một chuỗi được phân tách bằng dấu phẩy trong trường tên_trường_ký
trong yêu cầu của bạn.
Quan trọng: Để ngăn giả mạo dữ liệu, hãy ký vào tất cả các trường yêu cầu ngoại trừ các trường chứa dữ liệu
mà khách hàng đang nhập.
Các trường đã ký này là bắt buộc trong tất cả các yêu cầu Chấp nhận an toàn:
• khóa truy cập
• số tiền
• tiền tệ
• địa phương
• profile_id
• số_tham chiếu
• ngày_giờ đã ký
• tên_trường đã ký
• giao dịch_type
• giao dịch_uuid
Để biết mô tả về các trường này, hãy xem Trường yêu cầu (ở trang 92).
Mã thông báo thanh toán
Tạo mã thông báo thẻ thanh toán
Quan trọng: Bao gồm điểm cuối thích hợp hỗ trợ loại giao dịch create_payment_token . Xem Điểm
cuối và Loại giao dịch (ở trang 69). Đối với mô tả của tất cả các trường yêu cầu và phản hồi. Xem
Các trường API tích hợp thanh toán được lưu trữ trên máy chủ (ở trang 91).
Bao gồm tất cả các trường yêu cầu trong trường tên_trường đã ký ngoại trừ trường số_thẻ, thẻ_cvn và chữ
ký . Trường Sign_field_names được sử dụng để tạo chữ ký được sử dụng để xác minh nội dung của giao dịch
nhằm ngăn chặn giả mạo dữ liệu.
Ví dụ: Tạo mã thông báo thẻ thanh toán độc lập
Lời yêu cầu
số tham chiếu = 123456789 giao dịch_type =
tạo_thanh toán_token tiền tệ = usd
số tiền = 100,00
ngôn ngữ = vi
access_key=e2b0c0d0e0f0g0h0i0j0k0l0m0n0o0p3 profile_id=0FFEAFFB-8171-4F34-
A22D-1CD38A28A384 giao dịch_uuid=02815b4f08e56882751a043839b7b481signed_date_time=2020-07
-11T15:16:54Zsigned_field_names=reference_number,transaction_type,currency,amount,locale,access_key,profile_id,transaction_uuid,signed_date_time,signed_field_names ,
vân...
chữ ký=WrXOhTzhBjYMZROwiCug2My3jiZHOqATimcz5EBA07M=
payment_method=thẻ
card_type=001
card_number=4111111111111111
card_expiry_date=12-2022
card_cvn=005
bill_to_forename=Joe
bill_to_surname=Smith
bill_to_email=joesmith@example.com
bill_to_address_line1=1 Căn hộ của tôi
bill_to_address_city=Mountain View
bill_to_address _postal_code=94043
bill_to_address_state=CA
bill_to_address_country=US
Phản ứng
req_reference_number=123456789
req_transaction_type=create_payment_token req_locale=en
req_amount=100.00
req_payment_method=card
req_card_type=001
req_card_number=xxxxxxxxxxxx1111
req_card_expiry_date=12-2022
req_bill_to_smith=001
req_bill_tojo@surqname=mail
example.com req_bill_to_address_line1=1 Căn hộ của
tôi req_bill_to_address_city=Cảnh núi
req_bill_to_address_postal_code= 94043
req_bill_to_address_state=CA
req_bill_to_address_country=US
req_access_key=e2b0c0d0e0f0g0h0i0j0k0l0m0n0o0p3
req_profile_id=0FFEAFFB-8171-4F34-A22D-1CD38A28A384
req_transaction_uuba60f281543 839b7b481 Sign_date_time=2020-07-11T15:16:54Z
Sign_field_names=số_tham_chiếu,loại_giao_dịch,tiền_tệ,số_lượng,ngôn_địa,_khóa_truy_cập,
profile_id,transaction_uuid,signed_date_time,signed_field_names,v.v...
signature=WrXOhTzhBjYMZROwiCug2My3jiZHOqATimcz5EBA07M=
quyết định=CHẤP NHẬN
reason_code=100
transaction_id=3735553783662130706689
req_payment_token=CF2194C8A0F545CDE053AF598E0A20DA
Tạo mã thông báo Echeck
Quan trọng: Bao gồm điểm cuối thích hợp hỗ trợ loại giao dịch create_payment_token . Xem
Điểm cuối và Loại giao dịch (ở trang 69). Để biết mô tả về tất cả các trường yêu cầu và phản
hồi, hãy xem Các trường API tích hợp thanh toán được lưu trữ trên máy chủ (ở trang 91).
Bao gồm tất cả các trường yêu cầu trong trường tên_trường_ký . Trường Sign_field_names được sử
dụng để tạo chữ ký được sử dụng để xác minh nội dung của giao dịch nhằm ngăn chặn giả mạo dữ liệu.
Ví dụ: Tạo Mã thông báo thanh toán Echeck độc lập
Lời yêu cầu
A22D-1CD38A28A384 transaction_type=create_payment_token currency=USD
số tiền = 100,00
ngôn ngữ = vi
Reference_number=1730560013735542024294683
transaction_uuid=02815b4f08e56882751a043839b7b481 sign_date_time=2022-07-11T15:16:54Z
signature=WrXOhTzhBjYMZROwiCug2My3jiZHOqATimcz5EBA 07M=
tên_trường_đã ký=số_tham_chiếu,loại_giao_dịch,tiền_tệ,số_lượng,ngôn_địa,_khóa_truy_cập,hồ
sơ_id,giao_dịch_uuid,ngày_giờ_đãký,tên_trường_đãký,v.v... bill_to_forename= Joe bill_to_surname=Smith bill_to_email=joesmith@example.com
bill_to_address_line1=1 Căn hộ của tôi bill_to_address_state=CA bill_to_postal_code=94043 bill_to_address_country=US
payment_method=echeck
driver_license_state=NY
driver_license_number=34-78239-396 date_of_birth=19901001
echeck _account_type=c company_tax_id=123456789 echeck_sec_code=WEB
echeck_account_number=452894100
echeck_routing_number=672302882
Phản ứng
req_bill_to_address_country=Hoa Kỳ
req_driver_license_state=NY
req_driver_license_number=xx-xxxxx-xxx
req_date_of_birth=19901001 quyết
định=CHẤP NHẬN
req_amount=100,00
req_bill_to_address_state=CAsigned_field_names=reference_number,transaction_type,currency,amount,locale,access
_key,profile_id,transaction_uuid,signed_date_time,signed_field_names,v.v... req_payment_method=echeck
req_transaction_type=create_payment_token
req_echeck_account_type=cUXsigned=NuxlbkJ4lx50 OozqJnyVF390s=
req_locale= vi reason_code=100
req_bill_to_address_postal_code=94043 req_echeck_account_number=xxxxx4100
req_bill_to_address_line1=1
Căn hộ của tôi req_echeck_sec_code=WEB
req_bill_to_address_city=San Francisco đã
ký_date_time=2022-07-11T15:11:41Z req_reference_3currency
re07_305USD 42024294683
req_echeck_routing_number=xxxxx2882
transaction_id=3735553783662130706689 req_amount=100,00
req_profile_id=
0FFEAFFB-8171-4F34-A22D-1CD38A28A384 req_company_tax_id=123456789
req_transaction_uuid=38f2efe650ea699597d325ecd7432b1c
req_payment_token=CF2194C8A0F545CDE053AF598E0A20Sollapto
resur_biA20
bill_to_forename=Joe req_bill_to_email=joesoap@yahoo.com
Giao dịch mã thông báo thanh toán
Một cú nhấp chuột
Khách hàng được chuyển đến trang Đánh giá đơn hàng. Tùy thuộc vào cài đặt bạn đã định cấu hình cho Tích hợp
thanh toán được lưu trữ trên máy chủ chấp nhận an toàn, khách hàng có thể xem hoặc cập nhật chi tiết lập hóa
đơn, vận chuyển và thanh toán trước khi xác nhận thanh toán. Xem Cấu hình thanh toán (ở trang 29).
Quan trọng: Bao gồm điểm cuối phù hợp hỗ trợ các loại giao dịch ủy quyền hoặc bán hàng .
Xem Điểm cuối và Loại giao dịch (ở trang 69). Để biết mô tả về tất cả các trường yêu cầu và
phản hồi, hãy xem Các trường API tích hợp thanh toán được lưu trữ trên máy chủ (ở trang 91).
Trường payment_token xác định thẻ và truy xuất thông tin thanh toán, vận chuyển và thanh toán
liên quan.
Ví dụ: Giao dịch một cú nhấp chuột
Lời yêu cầu
access_key=a2b0c0d0e0f0g0h0i0j0k0l0m0n0o0p2
profile_id=0FFEAFFB-8171-4F34-A22D-1CD38A28A384 reference_number=1350029885978
payment_token=CF2194C8A0F545CDE053AF598E0A20
DA Consumer_id=1239874561 transaction_type=số tiền ủy quyền=100,00
tiền tệ = USD
ngôn ngữ = vi
giao dịch_uuid=fcfc212e92d23be881d1299ef3c3b314
sign_date_time=2020-01-17T10:46:39Z
sign_field_names=số_tham_chiếu, loại_giao_dịch, tiền tệ, số tiền, ngôn ngữ, truy cập
_key,profile_id,transaction_uuid,signed_date_time,signed_field_names,v.v... signature=WrX3OhTwizhimBjYMZ5 BA07M=
Phản ứng
giao dịch_id=3500311655560181552946
message=Yêu cầu đã được xử lý thành công.
req_access_key=a2b0c0d0e0f0g0h0i0j0k0l0m0n0o0p2
req_transaction_uuid=55d895790bc4c8a0f4464f9426ba3b79 req_transaction_type=ủy
quyền req_reference_number=1350029885978
req_amount=100,00 req_transaction_type=ủy quyền
req_reference_number=1350029885978 req_amount=100,00
req_profile_profile_Fid=81FF7EAFF4-
F 22D-1CD38A28A384
req_tax_amount=15,00
req_currency=USD req_locale=vi
req_payment_method=thẻ
req_consumer_id=1239874561
req_bill_to_forename=Joe req_bill_to_surname=Smith
req_bill_to_email=jsmith@example.com
req_bill_to_address_line1=1 Căn hộ của tôi
req_bill_to_address_state=CA
req_card_type=001
reason_code=100
auth_avs_code=U
auth_avs_code_raw=00
auth_response=0
auth_amount=100,00
auth_time==2012-08 -14T134608Z
req_payment_token=CF2194C8A0F545CDE053AF598E0A20DA đã
ký_field_names=số_tham_chiếu,loại_giao_dịch,tiền_tệ,số_lượng,địa_điểm,truy_cập
_key,profile_id,giao_dịch_uuid,ngày_thời_gian_đã_ký,tên_trường_đãký,v.v...signed_date_time=2012-10-12T08
:39:25Z signature=jMeHnWRKwU3xtT02j2ufRibfFpbdjUSiuWGT9hnNm00=
req_amount=100,00 req_tax_amount=15,00 req_currency=USD req_locale=en
req_payment_method=card
req_bill_to_forename=Joe
req_bill_to_surname=Smith
req_bill_to_address_line1=1 Căn hộ
của tôi req_bill_ to_address_state=CA
req_card_number=xxxxxxxxxxxx4242 req_card_type=001
reason_code=100 auth_avs_code=U
auth_avs_code_raw=00 auth_response=0
auth_amount=100.00
auth_time==2012-08-14T134608Z
payment_token=CF2194C8A0F545CDE053AF598E0A20DA
payment_token_latest_card_s uffix=3283
payment_token_latest_card_expiry_date=07-2024
payment_solution=015
signed_field_names=reference_number,transaction_type,currency,amount,locale,access
_key,profile_id,transaction_uuid,signed_date_time,signed_field_names,v.v...signed_date_time=2012-10-12T08:39:25Z
signature=jMeHnWRKwU3xtT02j2ufRibfFpbdjUSiuWGT9hnNm00=
Kiểm tra thanh toán bằng mã thông báo
Khách hàng được chuyển đến trang Đánh giá đơn hàng. Tùy thuộc vào cài đặt bạn đã định cấu hình cho Tích hợp thanh
toán được lưu trữ trên máy chủ chấp nhận an toàn, khách hàng có thể xem hoặc cập nhật chi tiết lập hóa đơn, vận chuyển
và thanh toán trước khi xác nhận thanh toán. Xem Cấu hình thanh toán (ở trang 29).
Quan trọng: Bao gồm điểm cuối phù hợp hỗ trợ các loại giao dịch ủy quyền hoặc bán hàng . Xem Điểm cuối và
Loại giao dịch (ở trang 69). Để biết mô tả về tất cả các trường yêu cầu và phản hồi, hãy xem Các trường API
tích hợp thanh toán được lưu trữ trên máy chủ (ở trang 91).
Trường payment_token xác định tài khoản ngân hàng và truy xuất thông tin thanh toán, vận chuyển và thanh toán được liên
kết.
Ví dụ: Xử lý Thanh toán bằng Echeck Token
Lời yêu cầu
A22D-1CD38A28A384 reference_number=1845864013783060468573616 giao dịch_loại=đồng
tiền bán hàng=USD
số tiền = 100,00
ngôn ngữ = vi
transaction_uuid=fcfc212e92d23be881d1299ef3c3b314sign_date_time=2022-01-17T10:46:39Zsigned_field_names=reference_number,transaction_type,currency,amount,locale,acces
_key, profile_id,transaction_uuid,signed_date_time,signed_field_names,v.v... signature=jMeHnWRKwU3xtT02j2ufRibfFpbdjUSiuWGT9hnNm00=
Phản ứng
req_driver_license_number=xx-xxxxx-xxx req_date_of_birth=19901001
req_bill_to_address_state=CA đã
ký_field_names=số_tham chiếu,loại_giao dịch,tiền tệ,số tiền,ngôn ngữ,truy cập _key,profile_id,transaction_uuid,sign_date_time,sign_field_names,v.v...
req_payment_method=echeck req_transaction_type=sale req_echeck_account_type=c
chữ ký=ZUk7d99c/yb+kidvVUbz10JtykmjOt8LMPgkllRaZR8=
req_locale=en
reason_code=100
req_echeck_account_number=xxxxx4100
req_echeck_sec_code=WEB đã
ký_date_time=2022-06-12T09:59:50Z req_currency=USD
req_reference_number=77353001371031080772693
reuting_xxid=880_checkid=xxx3 710311877042130706689
req_amount=100.00 message=Yêu cầu đã được xử lý
thành công.
echeck_debit_ref_no=1 echeck_debit_submit_time=2022-03-25T104341Z
req_profile_id=0FFEAFFB-8171-4F34-
A22D-1CD38A28A384 req_company_tax_id=123456789
req_transaction_uuid=bdc596506c267c7705q97ccf_ebill_ebill_e705b791
_to_surname=Smith req_bill_to_forename=Joe
Thanh toán định kỳ
ID người bán của bạn phải được kích hoạt để xử lý các khoản thanh toán định kỳ. Bạn phải chỉ định số tiền và tần
suất của từng khoản thanh toán cũng như ngày bắt đầu xử lý các khoản thanh toán định kỳ. Cybersource tạo lịch trình dựa
trên thông tin này và tự động lập hóa đơn cho khách hàng theo lịch trình.
Quan trọng: Bao gồm điểm cuối thích hợp hỗ trợ các loại giao dịch ủy
quyền,tạo_thanh toán_token hoặc bán,tạo_thanh toán_token . Xem Điểm cuối và Loại giao dịch (ở trang 69). Để
biết mô tả về tất cả các trường yêu cầu và phản hồi, hãy xem Các trường API tích hợp thanh toán được lưu trữ
trên máy chủ (ở trang 91).
Ví dụ: Tạo thanh toán hóa đơn định kỳ và mã thông báo
Lời yêu cầu
profile_id=0FFEAFFB-8171-4F34-A22D-1CD38A28A384 giao dịch_type=ủy
quyền,tạo_thanh toán_token
ngôn ngữ = vi
số tiền = 5,00
giao
dịch_uuid=fcfc212e92d23be881d1299ef3c3b314signed_date_time=2020-01-17T10:46:39Zsigned_field_names=reference_number,transaction_type,currency,amount,locale,access
_key,profile_id,transaction_uuid,signed_date_time,signed_field_names,v.v... signature=WrXOhT zhBjYMZROwiCug2My3jiZHOqATimcz5EBA07M=
Consumer_id=1239874561
bill_to_email=joesmith@example.com bill_to_address_line1=1
Căn hộ của tôi bill_to_address_state=CA bill_to_address_country=US
card_type=001 card_number=41111111111111111
card_expiry_date=12-202 2 card_cvn=005
recur_frequency=số_lượng_định_kỳ hàng tháng=25.00
recur_start_date=20200125 payment_method=thẻ
Phản ứng
giao dịch_id=3500311655560181552946
req_access_key=a2b0c0d0e0f0g0h0i0j0k0l0m0n0o0p2 req_profile_id=0FFEAFFB-8171-4F34-
A22D-1CD38A28A384 req_transaction_uuid=55d895790bc4c8a0f4464f9426ba3b79 req_transaction
_type=ủy quyền,tạo_thanh toán_token req_reference_number=1350029885978 req_amount=5,00
req_tax_amount=2,50 req_currency=USD req_locale=en req_payment_method=thẻ req_consumer_id=1239874561
req_recurring_frequency=hàng tháng req_recurring_amount=25,00
yêu cầu _recurring_start_date
=20200125 req_bill_to_forename=Joe
req_bill_to_email=joesmith@example.com
req_bill_to_address_state=CA req_bill_to_address_country=US
req_card_type=001
reason_code=100
auth_avs_code=U
auth_response=0
auth_amount=100.00
auth_time=2022-08-14T134608Z
req_payment_token=CF2194C8C80F53A5signedDE545
_names=reference_number,transaction_type,currency,amount,locale,access_key,profile_id,
transaction_uuid,signed_date_time,signed_field_names,v.v...signed_date_time=2022-10-12T08:39:25Z
signature=jMeHnWRKwU3xtT02j2ufRibfFpbdjUSiuWGT9hnNm00=
Thanh toán từng lần
ID người bán của bạn phải được kích hoạt để xử lý các khoản thanh toán trả góp. Bạn phải chỉ định số lần thanh toán,
số tiền và tần suất của từng khoản thanh toán cũng như ngày bắt đầu xử lý các khoản thanh toán. Cybersource tạo
lịch trình dựa trên thông tin này và tự động lập hóa đơn cho khách hàng theo lịch trình.
Quan trọng: Bao gồm điểm cuối thích hợp hỗ trợ các loại giao dịch ủy
quyền,tạo_thanh toán_token hoặc bán,tạo_thanh toán_token . Xem Điểm cuối và Loại giao dịch (ở trang 69)). Để
biết mô tả về tất cả các trường yêu cầu và phản hồi, hãy xem Các trường API tích hợp thanh toán được lưu trữ
trên máy chủ (ở trang 91).
Ví dụ: Tạo Khoản thanh toán trả góp và Token
Lời yêu cầu
profile_id=0FFEAFFB-8171-4F34-A22D-1CD38A28A384 giao dịch_type=ủy
quyền,tạo_thanh toán_số lượng mã thông báo=5,00
ngôn ngữ = vi
giao
dịch_uuid=fcfc212e92d23be881d1299ef3c3b314signed_date_time=2020-01-17T10:46:39Zsigned_field_names=reference_number,transaction_t
card_type=001
card_number=4111111111111111
card_cvn=005
recur_frequency=số_lần_cài_đặt_hàng_tháng=6
recur_amount=25,0 0 recur_start_date=20200125
Phản ứng
giao dịch_id=3500311655560181552946
req_transaction_uuid=55d895790bc4c8a0f4464f9426ba3b79 req_transaction
_type=ủy quyền,tạo_thanh toán_token req_reference_number=1350029885978
req_amount=5,00 req_currency=USD req_locale=en
req_recurring_frequency=hàng
tháng
req_recurring_number_of_installments=6
req_recurring_amount=25,0 0 req_recurring_start_date
=20200125 req_bill_to_forename=Joe
req_bill_to_email=joesmith@example.com
của tôi req_bill_to_address_state=CA
req_card_type= 001 req_card_expiry_date=12-2022
reason_code=100 auth_avs_code=U
auth_response=0 auth_amount =100,00
auth_time==2022-08-14T134608Z
req_payment_token=CF2194C8A0F545CDE053AF598E0A20DA đã
ký_field_names=số_tham chiếu, loại_giao dịch, tiền tệ, số tiền, ngôn ngữ, khóa truy cập, hồ sơ_id, giao
dịch_uuid, ngày_thời gian đã ký, tên_trường_đã ký, v.v...signed_date_time=2022-10-12T08:39:25Z
signature=jMe HnWRKwU3xtT02j2ufRibfFpbdjUSiuWGT9hnNm00=
Cập nhật mã thông báo thanh toán
Cập nhật mã thông báo thẻ thanh toán
Trường payment_token xác định thẻ và truy xuất thông tin thanh toán, vận chuyển và thanh toán liên quan. Khách hàng
được chuyển đến trang Đánh giá đơn hàng và nhấp vào Chỉnh sửa địa chỉ hoặc Chỉnh sửa chi tiết để quay lại trang thanh
toán có liên quan. Khách hàng nhấn Thanh toán để xác nhận giao dịch.
Bạn phải định cấu hình chi tiết lập hóa đơn, giao hàng và thanh toán để khách hàng có thể chỉnh sửa chi tiết của họ trên
trang Đánh giá đơn hàng. Xem Định cấu hình Chi tiết Đánh giá Đơn hàng (ở trang 33).
Quan trọng: Bao gồm điểm cuối hỗ trợ update_payment_token hoặc điểm cuối hỗ trợ ủy quyền,update_payment_token
(cập nhật mã thông báo và ủy quyền giao dịch) hoặc bán,update_payment_token (cập nhật mã thông báo và xử lý giao dịch).
Xem Quy trình Giao dịch Mẫu Sử dụng JSP (ở trang 68). Bạn phải bao gồm trường allow_payment_token_update và đặt
trường này thành true.
Ví dụ: Cập nhật Token thẻ thanh toán
Lời yêu cầu
transaction_type=update_payment_token
profile_id=0FFEAFFB-8171-4F34-A22D-1CD38A28A384
reference_number=1350029885978
payment_token=CF2194C8A0F545CDE0 53AF598E0A20DA lượng=100,00
tệ=USD
card_type=001
card_number=4111111111111111
card_cvn=005
bill_to_address_country=US locale=vi
transaction_uuid=fcfc212e92d23be881d1299ef3c3b314
signed_date_time=2020-01-17T10:46:39Z Consumer_id=1239874561
Signed_field_names=reference_number,transaction_type,currency,amount,locale,access
_key,profile_id,transaction_uuid,signed_date_time,signed_type,Ohwifield_names,OhwiTMZCMZ=BjROTMZ_names
ug2My3jiZHOqATimcz5EBA07M=
Phản ứng
giao dịch_id=3500311655560181552946 quyết định=CHẤP NHẬN
req_transaction_uuid=55d895790bc4c8a0f4464f9426ba3b79 req_transaction _type=ủy
quyền,update_payment_token req_reference_number=1350029885978 req_amount=100.00
req_tax_amount=15.00 req_currency=USD req_locale=en
req_bill_to_forename=Joe
req_bill_to_surname
=Smith req_bill_to_email
=jsmith@example.com
của tôi req_bill_to_address_state=CA
req_card_number=xxxxxxxxxxxx1111 req_card_type=001
req_card_expiry_date=12-2022 reason_code=100
auth_avs_code=U auth_avs_code_raw =00
auth_response=0 auth_amount=100.00
auth_time=2022-08-14T134608Z
đã ký_field_names=danh
sách các trường đã ký
được phân tách bằng dấu phẩy
đã
ký_date_time=2022-10-12T08:39:25Z
chữ ký=jMeHnWRKwU3xtT02j2ufRibfFpbdjUSiuWGT9hnNm00=
Cập nhật mã thông báo Echeck
Trường payment_token xác định tài khoản séc điện tử và truy xuất thông tin thanh toán, giao hàng và thanh toán liên quan.
Khách hàng được chuyển đến trang Đánh giá đơn hàng và nhấp vào Chỉnh sửa địa chỉ hoặc Chỉnh sửa chi tiết để quay lại trang
thanh toán có liên quan. Khách hàng nhấn Thanh toán để xác nhận giao dịch.
Bạn phải định cấu hình chi tiết lập hóa đơn, giao hàng và thanh toán để khách hàng có thể chỉnh sửa chi tiết của họ trên
trang Đánh giá đơn hàng. Xem Định cấu hình Chi tiết Đánh giá Đơn hàng (ở trang 33).
Quan trọng: Bao gồm điểm cuối hỗ trợ update_payment_token hoặc điểm cuối hỗ trợ sale,update_payment_token (cập
nhật mã thông báo và xử lý giao dịch). Bạn phải bao gồm trường allow_payment_token_update và đặt thành true.
Ví dụ: Cập nhật Mã thông báo thanh toán Echeck
Lời yêu cầu
access_key=e2b0c0d0e0f0g0h0i0j0k0l0m0n0o0p3
profile_id=0FFEAFFB-8171-4F34-A22D-1CD38A28A384
reference_number=1845864013783060468573616 tệ=USD
số tiền = 100,00
ngôn ngữ = vi
transaction_uuid=fcfc212e92d23be881d1299ef3c3b314
sign_date_time=2022-01-17T10:46:39Zsigned_field_names=reference_number,transaction_type,currency,amount,locale,access_key
payment_method=echeck
driver_license_state=NY
driver_license_number=34-78239-396
date_of_birth=19901001
echeck_account_type= c
company_tax_id=123456789
echeck_sec_code=WEB
echeck_account_number=452894100
echeck_routing_number=672302882
Phản ứng
req_driver_license_number=xx-xxxxx-xxx
req_date_of_birth=19901001 quyết
định=CHẤP NHẬN
req_bill_to_address_state=CA đã
ký_field_names=danh sách các trường đã ký được phân tách bằng dấu phẩy
req_payment_method=echeck
req_transaction_type=sale,update_payment_token req_echeck_account_type=c
signature=NuxlJilx5YbvKoXlt0baB5hUj5gk4+OozqJnyVF390s= req_locale=vi reason_code=100
req_
bill_to_address_postal_code=94043
req_echeck_account_number=xxxxx4100
req_bill_to_address_line1=1 Căn hộ của tôi req_echeck_sec_code=WEB
req_bill_to_address_city= San
Francisco đã ký_date_time=2022-07-11T15:11:41Z
req_currency=USD req_reference_number=1730560013735542024294683
req_echeck_routing_number=xxxxx2882 transaction_id=3735553783662130706689
req_amount=100,00 lại q_profile_id=0FFEAFFB-8171-4F34-
A22D-1CD38A28A384 req_company_tax_id=123456789
req_transaction_uuid=38f2efe650ea699597d325ecd7432b1c
payment_token=CF2194C8A0F545CDE053AF59
8E0A20DA req_bill_to_surname= Soap req_bill_to_forename=Joe
req_bill_to_email=joesoap@yahoo.com
quản lý quyết định
Quan trọng: Liên hệ với bộ phận Hỗ trợ khách hàng để bật chế độ dữ liệu chi tiết của Trình quản lý quyết định
cho tài khoản người bán của bạn và để nhận thông tin chi tiết về dấu vân tay của thiết bị.
Trình quản lý quyết định là một công cụ quản lý gian lận được lưu trữ cho phép bạn xác định các đơn đặt hàng hợp
pháp một cách nhanh chóng và điều đó làm giảm nhu cầu can thiệp thủ công vào quy trình xem xét đơn đặt hàng của
bạn. Bạn có thể xác định và xem xét chính xác các giao dịch tiềm ẩn rủi ro đồng thời giảm thiểu việc từ chối các lệnh
hợp lệ. Với Chấp nhận an toàn, bạn có thể sử dụng Trình quản lý quyết định để sàng lọc các đơn đặt hàng có chứa dữ
liệu du lịch. Bao gồm toàn bộ lộ trình hoặc các chặng riêng lẻ của chuyến đi hoặc cả hai. Nếu bạn bao gồm cả hai,
giá trị cho tuyến đường hoàn chỉnh sẽ được sử dụng.
Trình quản lý Quyết định lấy dữ liệu về vị trí địa lý của khách hàng bằng cách liên kết địa chỉ IP được trích
xuất từ trình duyệt của khách hàng với quốc gia và thẻ thanh toán. Thêm địa chỉ IP của khách hàng vào trường
customer_ip_address và đưa địa chỉ đó vào yêu cầu.
Chế độ dài dòng trả về thông tin chi tiết về một đơn đặt hàng và nó trả về quyết định của từng quy tắc mà đơn đặt
hàng đã kích hoạt. Các quy tắc được đánh giá là đúng sẽ được trả về với các kết quả và tên trường thích hợp, nhưng
các quy tắc được đánh giá là sai sẽ không được trả về.
Đây là các trường Trình quản lý quyết định tùy chọn:
• người tiêu dùng_id
• hoàn thành_tuyến đường
• khách hàng_cookies_accepted
• gói_quà_tặng_khách_hàng
• địa_chỉ_ip_khách_hàng
• thời gian khởi hành
• ngày_sinh
• device_fingerprint_id— ID vân tay thiết bị do nền tảng tạo sẽ ghi đè ID vân tay thiết bị do người bán tạo.
• hành_trình#_orig
• hành_trình#_dest
• hành trình_type
• Merchant_define_data#
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Người quản lý quyết định| 87
• item_#_passenger_forename
• mục_#_passenger_email
• item_#_passenger_id
• mục_#_họ_hành khách
• item_#_passenger_status
• item_#_passenger_type
• return_accepted
Để biết mô tả chi tiết về tất cả các trường yêu cầu, xem Trường yêu cầu (ở trang 92). Để biết mô tả chi tiết
về tất cả các trường phản hồi Trình quản lý quyết định, hãy xem Trình quản lý quyết định bằng cách sử dụng Hướng dẫn
dành cho nhà phát triển API SCMP trong Business Center.
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Người quản lý quyết định| 88
Kiểm tra và xem giao dịch
Quan trọng: Bạn phải tạo hồ sơ trong cả phiên bản thử nghiệm và trực tiếp của Chấp nhận an toàn.
Bạn không thể sao chép một hồ sơ từ phiên bản thử nghiệm sang phiên bản trực tiếp mà phải tạo lại hồ sơ.
Kiểm tra giao dịch
1. Đăng nhập vào môi trường thử nghiệm Business Center: https://businesscentertest.cybersource.com
2. Tạo hồ sơ Chấp nhận an toàn. Xem Tạo Hồ sơ Chấp nhận An toàn (ở trang 20), dành cho người bán hoặc Người bán
lại: Tạo Hồ sơ Chấp nhận An toàn (ở trang 45), dành cho người bán lại.
3. Tích hợp với Chấp nhận an toàn. Xem Mẫu ngôn ngữ viết kịch bản (ở trang 68).
Quan trọng: Bao gồm điểm cuối giao dịch thử nghiệm trong biểu mẫu HTML của bạn. Xem Quy trình Giao
dịch Mẫu Sử dụng JSP (ở trang 68).
4. Bạn có thể sử dụng các số thẻ thanh toán thử nghiệm này để giao dịch. Xóa khoảng trắng khi gửi yêu cầu tới
Cybersource.
Kiểm tra số thẻ tín dụng
Loại thẻ thanh toán Số tài khoản kiểm tra
Hộ chiếu 4111 1111 1111 1111
thẻ mastercard 5555 5555 5555 4444
American Express 3782 8224 6310 005
Phát hiện 6011 1111 1111 1117
JCB 3566 1111 1111 1113
câu lạc bộ thực khách 3800 0000 0000 0006
Maestro International (16 chữ số) 6000 3400 0000 9859
Nhạc trưởng trong nước (16 chữ số) 6759 1800 0000 5546
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Kiểm tra và Xem giao dịch| 89
Xem giao dịch trong Business Center
Sử dụng ID yêu cầu giao dịch để tìm kiếm các giao dịch nhận được từ trình duyệt của khách hàng của bạn và xem chi tiết
giao dịch đầy đủ, bao gồm cả phản hồi giao dịch đã được cung cấp cho trình duyệt của khách hàng của bạn. Điều này hữu ích
cho các vấn đề khắc phục sự cố.
2. Trong bảng điều hướng bên trái, hãy chọn Quản lý giao dịch > Chấp nhận an toàn. Trang Tìm kiếm chấp nhận an
toàn xuất hiện.
3. Tìm kiếm tìm kiếm giao dịch bằng các phương pháp ưa thích của bạn.
4. Nhấp vào liên kết ID yêu cầu của giao dịch mà bạn muốn xem. Trang Chi tiết sẽ mở ra.
Quan trọng: Nếu một giao dịch có dữ liệu bị thiếu hoặc không hợp lệ, nó sẽ được hiển thị trong Bảo mật
Trang Kết quả tìm kiếm giao dịch chấp nhận không có liên kết ID yêu cầu.
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Kiểm tra và Xem giao dịch| 90
Các trường API tích hợp Checkout được lưu trữ
Định nghĩa kiểu dữ liệu
Quan trọng: Trừ khi có lưu ý khác, tất cả các trường đều phân biệt chữ hoa chữ thường. Bạn không
nên đưa các ký tự được mã hóa URL vào bất kỳ trường yêu cầu nào trước khi tạo chữ ký.
Định nghĩa kiểu dữ liệu
Loại dữ liệu Các ký tự và định dạng được phép
anpha Bất kỳ bức thư nào từ bất kỳ ngôn ngữ nào
chữ và số Alpha với bất kỳ ký tự số nào trong bất kỳ tập lệnh nào
AlphaSốDấu chấm câu Chữ và số bao gồm ! "#$%&'()*+,-./:;=?@^_~
Số lượng 0123456789 bao gồm cả dấu thập phân (.)
ASCIIAlphaNumericPunctuation Bất kỳ ký tự chữ và số ASCII bao gồm !&'()

+,-./:@
Ngày (a) MM-yyyy
Ngày (b) yyyyMMDD
Ngày (c) yyyy-MM-dd HH:mm z
yyyy-MM-dd hh:mm az
yyyy-MM-dd hh:mma z
E-mail Địa chỉ email hợp lệ.
Chuỗi liệt kê Chuỗi chữ và số được phân tách bằng dấu phẩy
địa chỉ IP Địa chỉ IP hợp lệ
ISO 8601 Ngày yyyy-MM-DDThh:mm:ssZ
địa phương
[az] bao gồm dấu gạch nối (-)
số 0123456789
Điện thoại ( ),+-.*#xX1234567890
URL URL hợp lệ (http hoặc https)
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Các trường API tích hợp thanh toán được lưu trữ trên máy chủ| 91
Trường yêu cầu
Quan trọng: Để ngăn giả mạo dữ liệu, hãy ký vào tất cả các trường yêu cầu ngoại trừ các trường chứa
dữ liệu mà khách hàng đang nhập.
Quan trọng:
Khi ký các trường trong yêu cầu, hãy tạo một danh sách các trường được phân tách bằng dấu phẩy. Trình
tự của các trường trong chuỗi rất quan trọng đối với quá trình tạo chữ ký. Ví dụ:
bill_to_forename=john
bill_to_surname=doe
bill_to_email=jdoe@example.com đã
ký_field_names=bill_to_forename,bill_to_email,bill_to_surname
Khi tạo chữ ký bảo mật, hãy tạo một chuỗi tên=giá trị được phân tách bằng dấu phẩy của các trường
POST được bao gồm trong trường tên_trường_ký . Trình tự của các trường trong chuỗi rất quan trọng đối
với quá trình tạo chữ ký. Ví dụ:
• bill_to_forename=john
• bill_to_surname=doe
• bill_to_email=jdoe@example.com
Chuỗi ký tên là
bill_to_forename=john,bill_to_email=jdoe@example.com,bill_to_surname=doe
Để biết thông tin về quy trình tạo chữ ký, hãy xem tập lệnh bảo mật của mã mẫu cho ngôn ngữ tập lệnh bạn
đang sử dụng. Xem Mẫu ngôn ngữ viết kịch bản (ở trang 68).
Tệp Chụp TC 33 chứa thông tin về các giao dịch mua và tiền hoàn lại mà người bán gửi tới Cybersource.
Visa Platform Connect tạo tệp Chụp TC 33 vào cuối ngày và gửi tệp đó cho người mua của người bán, người
này sẽ sử dụng thông tin này để tạo điều kiện xử lý thanh toán bù trừ cuối ngày với các công ty thẻ thanh
toán.
Trường yêu cầu

Cánh đồng Sự miêu tả Được sử dụng bởi: Bắt buộc Loại dữ liệu
(R) hoặc Tùy chọn (O) & Chiều dài
khóa truy cập Cần thiết để xác thực với Chấp nhận an Yêu cầu của ứng dụng Chấp Chuỗi ic chữ
toàn. Xem Khóa bảo mật (ở trang 28). nhận an toàn. và số (32)
Quan trọng: Để ngăn giả mạo
dữ liệu, hãy ký tên vào trường này.
Trường yêu cầu (tiếp theo)

aggregator_id Giá trị xác định bạn là người ủy quyền (Xem mô tả) Chuỗi (Xem
tổng hợp thanh toán. Nhận giá mô tả)
trị này từ bộ xử lý của bạn.
Kết nối nền tảng Visa
Giá trị cho trường này
tương ứng với dữ liệu này trong tệp

chụp TC 33:
• Bản ghi: CP01 TCR6
• Vị trí: 95-105
• Lĩnh vực: Thanh toán Mastercard

ID người hướng dẫn
La bàn FDC
Giá trị này phải bao gồm các
ký tự viết hoa.
Độ dài trường
American Express Direct: 20
Kết nối nền tảng Visa: 11
La bàn FDC: 20
FDC Nashville toàn cầu: 15
Bắt buộc/Tùy chọn
American Express Direct: R cho tất cả

các giao dịch tổng hợp.
Visa Platform Connect: R đối
với ủy quyền bộ tổng hợp

Mastercard; nếu không, không được
sử dụng.
La bàn FDC: R cho tất cả các giao dịch

tổng hợp.
FDC Nashville Global: R cho tất
cả các giao dịch tổng hợp.

allow_payment_ Cho biết liệu khách hàng có thể cập cập nhật_thanh toán_token liệt kê
token_update nhật thông tin lập hóa đơn, giao (R) Chuỗi (5)
hàng và thanh toán trên trang
đánh giá đơn hàng hay không. Những
giá trị khả thi:
• true: Khách hàng có thể cập nhật thông
tin chi tiết.
• false: Khách hàng không thể cập
nhật thông tin chi tiết.
số lượng Tổng số tiền cho đơn đặt hàng. Phải • tao_thanh_to_t oken Số lượng
lớn hơn hoặc bằng 0 và phải bằng (R)

tổng số tiền của từng mục hàng bao gồm Chuỗi (15)
• ủy quyền hoặc bán
cả thuế
số lượng. (R)
• ủy
dữ liệu, hãy ký tên vào trường này. quyền,create_payment_tok vi (R)
• sale,create_paym
ent_token (R)
• mã thông báo_thanh
toán_cập nhật (O)

auth_indicator Cờ xác định mục đích của ủy quyền. ủy quyền (Xem mô tả) Chuỗi (1)
Những giá trị khả thi:
• 0: Ủy quyền trước
• 1: Ủy quyền cuối cùng
Mastercard yêu cầu người bán ở

Châu Âu cho biết ủy
quyền là ủy quyền cuối cùng
hay ủy quyền trước.
Để đặt mặc định cho trường này, hãy
liên hệ với bộ phận hỗ trợ khách hàng.

auth_type Loại ủy quyền. Những giá trị • ủy quyền (Xem Cielo,

khả thi: mô tả.) thương mại
người Latinh và
• AUTOCAPTURE: Tự động • nắm bắt nguồn mạng

(Bắt buộc Latin
chiếm lấy.
đối với ủy Người Mỹ
• STANDARDCAPTURE: Tiêu chuẩn quyền bằng lời
Xử lý:
chiếm lấy. nói; nếu không,
Chuỗi (15)
không được sử dụng.)
• bằng lời nói: Bắt giữ cưỡng chế. Tất cả khác
bộ vi xử lý:
Châu Á, Trung Đông và Châu Phi Chuỗi (11)
Cổng; Cielo; Comercio Latino; và
Cybersource Mỹ Latinh
Xử lý
Đặt trường này thành AUTOCAPTURE
và đưa trường này vào yêu cầu được

nhóm để cho biết rằng bạn đang yêu
cầu chụp tự động. Nếu tài khoản
của bạn được định cấu hình để bật
tính năng chụp tự động, hãy đặt
trường này thành CHỤP CHỤP TIÊU
CHUẨN và đưa trường này vào ủy
quyền tiêu chuẩn hoặc yêu cầu theo

nhóm để cho biết rằng bạn đang ghi
đè tính năng chụp tự động.

hóa đơn_thanh toán Cờ cho biết khoản thanh toán cho hóa Không bắt buộc liệt kê
đơn hoặc cho khoản vay theo hợp đồng hiện Chuỗi (5)
có. Visa cung cấp chương trình Thanh
toán hóa đơn cho phép khách hàng sử
dụng thẻ Visa để thanh toán hóa đơn. Những

• true: Thanh toán hóa đơn hoặc thanh
toán khoản vay.
• sai (mặc định): Không phải thanh
toán hóa đơn hoặc thanh toán khoản vay.
bill_to_address_ Thành phố trong địa chỉ thanh toán. • tao_thanh_to_t oken AlphaNumer
thành phố (R) icPunctuatio
Khách hàng của bạn có thể nhập giá trị N

• ủy quyền hoặc bán (R)
này trong quá trình thanh toán hoặc
bạn có thể đưa trường này vào yêu cầu Atos: Chuỗi
Chấp nhận an toàn của mình. Xem Định (32)

• ủy
cấu hình trường thông tin thanh
quyền,create_payment_tok
toán (ở trang 30). Tất cả khác
vi (R)
bộ vi xử lý:
Chuỗi (50)
ent_token (R)

bill_to_address_ Mã quốc gia cho địa chỉ • tao_thanh_to_t oken anpha

quốc gia thanh toán. Sử dụng mã quốc (R)
gia ISO gồm hai ký tự . Chuỗi (2)
Khách hàng của bạn có thể nhập giá trị (R)
này trong quá trình thanh toán

• ủy
hoặc bạn có thể đưa trường này
vào yêu cầu Chấp nhận an toàn của
quyền,create_payment_tok vi (R)
mình. Xem Định cấu hình trường
thông tin thanh toán (ở trang 30).
ent_token (R)

bill_to_address_ Dòng đầu tiên của địa chỉ thanh toán. • tao_thanh_to_t oken AlphaNumer
line1 (R) icPunctuatio
Trên Cổng JCN, trường này là bắt N

• ủy quyền hoặc bán (R)
buộc khi yêu cầu ủy quyền hoặc bán bao
gồm create_payment_token hoặc Atos: Chuỗi
Trình quản lý quyết định. (29)

• ủy
Hộ chiếu
vi (R)
Trường này là tùy chọn Nền tảng
khi yêu cầu ủy quyền Kết nối:

hoặc bán hàng mà không có Chuỗi (40)
ent_token (R)
create_payment_token hoặc Trình
quản lý quyết định. tiền tệ:

toán_cập nhật (O) Chuỗi (50)
Khách hàng của bạn có thể nhập giá trị
này trong quá trình thanh toán hoặc Thanh toán thế giới
bạn có thể đưa trường này vào yêu cầu VAP: Chuỗi (35)
Chấp nhận an toàn của mình. Xem Định
toán (ở trang 30). Tất cả khác
bộ vi xử lý:
Chuỗi (60)

bill_to_address_ Dòng thứ hai của địa chỉ thanh toán. Không bắt buộc AlphaNumer
line2 icPunctuatio
bạn có thể đưa trường này vào yêu cầu Atos: Chuỗi
Chấp nhận an toàn của mình. Xem Định (29)
toán (ở trang 30). Hộ chiếu
Nền tảng
Kết nối:
Chuỗi (40)
tiền tệ:
Chuỗi (50)
Thanh toán thế giới
VAP: Chuỗi (35)
Tất cả khác
bộ vi xử lý:
Chuỗi (60)

hóa Mã bưu chính cho địa chỉ thanh toán. Xem mô tả. AlphaNumer
đơn_đến_địa_chỉ_mã_bưu điện icPunctuatio
Trường này là bắt buộc N
nếu bill_to_address_country là Hoa Kỳ

hoặc Canada. Xem
mô tả.
Khi quốc gia thanh toán là Hoa Kỳ,

mã bưu chính gồm 9 chữ số phải theo
định dạng sau: [5
chữ số][gạch ngang][4 chữ số]
Ví dụ: 12345-6789
Khi quốc gia thanh toán là

Canada, mã bưu chính gồm 6 chữ số
phải theo định dạng sau:
[alpha][numeric][alpha][space]
[numeric][alpha][numeric]
Ví dụ: A1B2C3
Đối với các quốc gia còn
lại trên thế giới, độ dài tối đa là

10.


hóa đơn tới địa chỉ_ Tiểu bang hoặc tỉnh trong địa chỉ Xem mô tả. AlphaNumer
tình trạng thanh toán. icPunctuatio
n String (2)
Đối với Hoa Kỳ và Canada, hãy sử
dụng mã tiêu chuẩn của tiểu bang,

tỉnh và lãnh thổ.
Trường này là bắt buộc

nếu bill_to_address_country là Hoa Kỳ
hoặc Canada.

hoặc bạn có thể đưa trường này vào
yêu cầu Chấp nhận an toàn của mình.
Xem Định cấu hình trường thông
tin thanh toán (ở trang 30).
hóa đơn_to_công ty_ Tên công ty của khách hàng. Không bắt buộc AlphaNumer
tên icPunctuatio
Khách hàng của bạn có thể nhập giá trị n String (40)

yêu cầu Chấp nhận an toàn của mình.
Xem Định cấu hình trường thông
tin thanh toán (ở trang 30).

bill_to_email Địa chỉ email của khách hàng, bao gồm • tao_thanh_to_t oken E-mail
tên miền đầy đủ. (R)
Chuỗi (255)
này trong quá trình thanh toán (R)

• ủy
ent_token (R)
bill_to_forename Tên khách hàng. Tên này • tao_thanh_to_t oken AlphaNumer

phải giống với tên trên thẻ. (R) icPunctuatio
N
Khách hàng của bạn có thể nhập giá trị (R) Chuỗi (60)
• ủy
ent_token (R)

bill_to_phone Số điện thoại của khách hàng. Xem mô tả. Điện thoại
Cybersource khuyên bạn nên bao gồm mã
quốc gia nếu đơn đặt hàng đến từ bên Chuỗi (6 đến
ngoài Hoa Kỳ 15)
Khách hàng của bạn có thể nhập giá trị Chuỗi (10)
này trong quá trình thanh toán hoặc nếu sử dụng
bạn có thể đưa trường này vào yêu TeleCheck để
cầu Chấp nhận an toàn của mình. Xem kiểm tra điện tử
Định cấu hình trường thông tin thanh toán.

thanh toán (ở trang 30).
Trường này là tùy chọn cho thanh toán
bằng thẻ. Đối với các khoản thanh toán
bằng séc điện tử, trường này là bắt
buộc nếu bộ xử lý của bạn là Dịch vụ

ACH của Cybersource hoặc TeleCheck.
bill_to_surname Họ của khách hàng. Tên này • tao_thanh_to_t oken AlphaNumer

phải giống với tên trên thẻ. (R) icPunctuatio
N
Khách hàng của bạn có thể nhập giá trị (R) Chuỗi (60)

• ủy
bạn có thể đưa trường này vào yêu
cầu Chấp nhận an toàn của mình. Xem
vi (R)
Định cấu hình trường thông tin
thanh toán (ở trang 30).

ent_token (R)

thẻ_cvn Số xác minh thẻ. Xem mô tả. số
Đối với các loại thẻ American Chuỗi (4)

Express, CVN phải là 4 chữ số.
Trường này có thể được cấu hình

theo yêu cầu hoặc tùy chọn. Xem Cấu
hình Phương thức Thanh toán (ở
trang 21).
card_expiry_date Ngày hết hạn của thẻ. • tao_thanh_to_t Ngày (a)

oken (R)
Định dạng: MM-yyyy Chuỗi (7)
• ủy quyền hoặc
bán (R)
• ủy
ent_token (R)

số thẻ Số thẻ. • tao_thanh_to_t số
oken (R)
Chỉ sử dụng các giá trị số. Đảm bảo Chuỗi (20)
bao gồm dữ liệu hợp lệ và được định • ủy quyền hoặc
dạng tốt cho trường này. bán (R)
• ủy
ent_token (R)

Loại thẻ Loại thẻ để ủy quyền. Những giá trị khả • tao_thanh_to_t oken liệt kê
thi: (R) Chuỗi (3)

• 001: Thị thực
(R)
• 002: Thẻ Mastercard
• ủy
• 003: American Express quyền,create_payment_tok
vi (R)
• 004: Khám phá
• 005: Diners Club: đánh bài ent_token (R)
bắt đầu với 54 hoặc 55 bị từ
chối. • mã thông báo_thanh

• 006: Carte Blanche
• 007: JCB
• 014: Lên đường
• 021: JAL
• 024: Nhạc trưởng Nội địa Vương quốc Anh
• 031: Châu thổ
• 033: Visa điện tử
• 034: Dankort
• 036: Carte Bancaire
• 037: Carta Si
• 042: Nhạc trưởng quốc tế
• 043: Thẻ GE Money UK
• 050: Hipercard (chỉ sale)
• 054: Êlô
• 062: China UnionPay

thẻ_loại_ Xác định xem loại thẻ là kết ủy quyền (O) Chuỗi (1)
lựa chọn_ quả của cài đặt thông số người mua
chỉ báo mặc định hay lựa chọn của chủ thẻ.
• 0: Loại thẻ được chọn theo

cài đặt bộ thu thẻ mặc định.
• 1: Loại thẻ do chủ thẻ lựa

chọn.
Trường này chỉ được hỗ trợ trên

Credit Mutuel-CIC. Giá trị mặc định
là 1.
company_tax_id Định danh thuế của công ty. • bán (Xem AlphaNumer
mô tả) icPunctuatio
Liên hệ với đại diện N
TeleCheck của bạn để tìm hiểu xem • tạo_thanh toán_t
trường này là bắt buộc hay tùy chọn. oken (Xem Chuỗi (9)
mô tả)

ent_token (Xem
mô tả)
yêu cầu Chấp nhận an toàn của
• cập nhật_thanh
thông tin Echeck(ở trang 32).
toán_ mã
thông báo (Xem mô tả)

hoàn thành_route Nối các chặng du lịch riêng lẻ theo định Không bắt buộc AlphaNumer
dạng chẳng hạn: icPunctuatio
Xem Trình quản lý quyết N
SFO-JFK:JFK-LHR:LHR-CDG. định (ở trang 87).
Chuỗi (255)
Để biết danh sách đầy đủ các mã sân
bay, hãy xem Danh mục mã thành
phố của IATA .
Trong yêu cầu của bạn, hãy gửi toàn bộ
lộ trình hoặc các chặng riêng lẻ (hành
trình_leg#_orig và hành
trình_leg#_dest). Nếu bạn gửi tất

cả các trường, thì giá trị của
Complete_route sẽ được ưu tiên hơn giá
trị của các trường Journey_leg# .
điều kiện_ Cho biết liệu khách hàng có chấp nhận Bắt buộc khi phí dịch vụ liệt kê
chấp nhận số tiền phí dịch vụ hay không. được bật cho hồ sơ. Chuỗi (5)
Xem Phí dịch vụ (ở trang

• false: Khách hàng không chấp 52).
nhận.
• đúng: Khách hàng đã chấp nhận.

người tiêu dùng_id Định danh cho tài khoản của • tạo_thanh toán_t AlphaNumer
khách hàng. Trường này được xác định oken (O) icPunctuatio
khi bạn tạo đăng ký. N

• ủy
Chuỗi (100)
quyền,create_payment_tok en (O)
ent_token (O)
credential_stored Cho biết liệu có liên kết ID giao Không bắt buộc Chuỗi (5)
_on_file dịch mạng mới với mã thông báo thanh
toán cho các giao dịch do người bán

thực hiện (MIT) trong tương lai
hay không.
Đặt trường này thành true khi bạn

sử dụng mã thông báo thanh
toán cho giao dịch do chủ thẻ thực
hiện (TNDN) và bạn dự định thiết lập

lịch trình mới của MIT bằng cách sử
dụng mã thông báo thanh toán hiện
có. Điều này sẽ đảm bảo rằng ID giao
dịch mạng mới được liên kết với mã thông báo.
• đúng
• sai
Quan trọng: Trong

Châu Âu, kích hoạt Người trả tiền
Xác thực trên Bảo mật
Chấp nhận và đặt trường

payer_authentication_challe
nge_code thành 04 trên giao
dịch do chủ thẻ thực hiện ban
đầu (CIT) để đảm bảo

tuân thủ các quy tắc Xác

thực khách hàng mạnh mẽ (SCA).
tiền điện tử_ mua Cờ chỉ định liệu khoản thanh toán Không bắt buộc Chuỗi (5)
hàng có dành cho việc mua tiền điện tử
hay không.
Trường này chỉ được hỗ trợ cho

Giao dịch Visa trên Visa Platform
Kết nối.
• đúng: Thanh toán cho việc

mua tiền điện tử.
• false (mặc định): Thanh toán

không dành cho việc mua tiền
điện tử.
tiền tệ Đơn vị tiền tệ được sử dụng cho đơn • tao_thanh_to_t oken anpha
đặt hàng. Để biết các giá trị có thể, (R)
hãy xem mã tiền tệ ISO . Chuỗi (3)
(R)
dữ liệu, hãy ký tên vào trường này. • ủy
ent_token (R)

khách hàng_ Cho biết độ sâu bit của bảng màu để Không bắt buộc Chuỗi (2)
trình duyệt_màu sắc_ hiển thị hình ảnh, tính bằng bit
chiều sâu trên pixel. Chấp nhận an toàn tự động
điền vào trường này nhưng bạn có thể
ghi đè lên trường này.
Để biết thêm thông tin, hãy
xem https://en.wikipedia.org/wiki/Col
or_depth.
khách hàng_ Cho biết khả năng thực thi Không bắt buộc Chuỗi (5)
trình duyệt_ Java của trình duyệt chủ thẻ. Giá
java_ đã bật trị được trả về từ thuộc tính
navigator.javaEnabled . Chấp
nhận an toàn tự động điền vào
trường này nhưng bạn có thể ghi đè
lên trường này. Những giá trị khả
thi:
• đúng
• sai
khách hàng_ Cho biết khả năng thực thi Không bắt buộc Chuỗi (5)
trình JavaScript của trình duyệt chủ
duyệt_ thẻ. Giá trị này có sẵn từ các chi

javascript_ đã bật tiết dấu vân tay của trình
duyệt của chủ thẻ.
Chấp nhận an toàn tự động điền vào

trường này, nhưng bạn có thể ghi
đè nó.
• đúng
• sai

khách hàng_ Cho biết ngôn ngữ trình duyệt như được Không bắt buộc Chuỗi (8)
trình duyệt_ định nghĩa trong IETF BCP47.
ngôn ngữ Chấp nhận an toàn tự động điền vào trường
này, nhưng bạn có thể ghi đè nó.
Để biết thêm thông tin, xem https://
en.wikipedia.org/wiki/IE TF_language_tag.
khách hàng_ Tổng chiều cao màn hình của khách hàng Không bắt buộc Chuỗi (6)
trình duyệt_ màn hình_ tính bằng pixel. Chấp nhận an
chiều cao toàn tự động điền vào trường này,
nhưng bạn có thể ghi đè nó.
Ví dụ: 864
khách hàng_ Tổng chiều rộng màn hình của khách hàng Không bắt buộc Chuỗi (6)
trình duyệt_ màn hình_ tính bằng pixel. Chấp nhận an

chiều rộng toàn tự động điền vào trường này,
nhưng bạn có thể ghi đè nó.
khách hàng_ Chênh lệch giữa giờ UTC và giờ địa phương Không bắt buộc Chuỗi (5)
trình duyệt_thời của trình duyệt chủ thẻ, tính bằng phút. Chấp
gian_ khác biệt nhận an toàn tự động điền vào trường
này nhưng bạn có thể ghi đè lên trường này.
khách hàng_ Cho biết trình duyệt của khách hàng có chấp Không bắt buộc liệt kê
cookie_accepted nhận cookie hay không. Những giá trị khả thi: Chuỗi (5)
Xem Trình quản lý quyết định
(ở trang 87).
• true: Trình duyệt của khách hàng
chấp nhận cookie.
• false: Trình duyệt của khách hàng
không chấp nhận cookie.

khách_hàng_gói_quà Cho biết liệu khách hàng có yêu cầu gói Không bắt buộc liệt kê
quà cho giao dịch mua này hay không. Chuỗi (5)
Những giá trị khả thi: Xem Trình quản lý quyết
định (ở trang 87).
• đúng: Khách hàng yêu cầu gói quà.
• sai: Khách hàng không yêu cầu
gói quà.
địa chỉ_ip_ khách Địa chỉ IP của khách hàng được báo cáo Không bắt buộc địa chỉ IP
hàng bởi máy chủ web của bạn bằng cách sử dụng
thông tin ổ cắm. Xem Trình quản lý quyết IPv4: Chuỗi (15)
IPv6: Chuỗi (39)
ngày sinh Ngày tháng năm sinh của khách hàng. Sử Đây là một trường tùy Ngày (b)
dụng định dạng: yyyyMMDD. chọn.
Chuỗi (8)
Khách hàng của bạn có thể nhập giá trị này
trong quá trình thanh toán hoặc bạn
có thể đưa trường này vào yêu cầu Chấp
nhận an toàn của mình. Xem Định cấu
hình trường thông tin Echeck(ở
trang 32).

nợ_indicator Cờ cho biết khoản thanh toán cho Không bắt buộc liệt kê
khoản vay theo hợp đồng hiện có theo Chuỗi (5)
chương trình Trả nợ VISA. Liên hệ với
bộ xử lý của bạn để biết chi tiết và
yêu cầu.
Các định dạng có thể:
• false (mặc định): Không phải khoản thanh
toán khoản vay.
• true: Thanh toán tiền vay.
giờ khởi hành Ngày và giờ khởi hành của chặng đầu Không bắt buộc Ngày (c)
tiên của chuyến đi. Sử dụng một

trong các định dạng sau: Xem Trình quản lý quyết Ngày Giờ
định (ở trang 87). (29)
• yyyy-MM-dd HH:mm z
• yyyy-MM-dd hh:mm az
• yyyy-MM-dd hh:mma z
• HH = định dạng 24 giờ
• hh = định dạng 12 giờ
• a = sáng hoặc chiều (không phân
biệt chữ hoa chữ thường)
• z = múi giờ của chuyến
bay khởi hành.
ví dụ
• 2023-01-20 23:30 GMT
• 2023-01-20 23:30 GMT
• 2023-01-20 23:30 GMT

thiết Trường chứa ID phiên cho dấu vân Không bắt buộc AlphaNumer
bị_ dấu vân tay_id tay. Chuỗi có thể chứa chữ hoa và chữ icPunctuatio
thường, chữ số và các ký tự Xem Trình quản lý quyết N
đặc biệt sau: dấu gạch nối (-) và dấu định (ở trang 87).
gạch dưới (_) Chuỗi (88)
Tuy nhiên, không sử dụng cùng một
chữ hoa và chữ thường để biểu thị các

ID phiên khác nhau.
ID phiên phải là duy nhất cho mỗi ID

người bán. Bạn có thể sử dụng bất kỳ
chuỗi nào bạn đang tạo, chẳng hạn
như số đơn đặt hàng hoặc ID

phiên web.
Quan trọng: ID vân
tay của thiết bị do Cybersource tạo
sẽ ghi đè ID vân tay của thiết
bị do người bán tạo.

số_bằng_lái xe Số giấy phép lái xe của • bán (Xem Chữ và số ic

khách hàng. mô tả)
Liên hệ với đại diện • tạo_thanh toán_t Chuỗi (30)

TeleCheck của bạn để tìm hiểu xem oken (Xem
trường này là bắt buộc hay tùy chọn. mô tả)
Nếu bạn bao gồm trường này trong

yêu cầu của mình thì bạn cũng
ent_token (Xem
phải bao gồm trường
driver_license_state . mô tả)
toán_ mã

bằng lái xe_ Tiểu bang hoặc tỉnh nơi cấp • bán (Xem anpha
tình trạng bằng lái xe của khách hàng. mô tả)
Chuỗi (2)
• tạo_thanh toán_t
Đối với Hoa Kỳ và Canada, hãy sử oken (Xem
dụng mã tiêu chuẩn của tiểu bang, mô tả)
tỉnh và lãnh thổ.

ent_token (Xem
Liên hệ với đại diện
mô tả)
TeleCheck của bạn để tìm hiểu xem
trường này là bắt buộc hay tùy chọn.
toán_ mã
chỉ báo_thương Chỉ báo thương mại cho loại giao ủy quyền (Xem mô tả) Chuỗi (20)
mại điện tử dịch.
Giá trị: cài đặt
Trường này chỉ bắt buộc đối

với các khoản thanh toán trả
góp trên Cybersource Latin
American Processing.

echeck_account_ Số tài khoản. • bán (R) số

số
Khách hàng của bạn có thể nhập giá • tao_thanh_to_t Số nguyên e

trị này trong quá trình thanh oken (R) không âm (8
toán hoặc bạn có thể đưa trường đến 17)
này vào yêu cầu Chấp nhận an
ent_token (R)
toàn của mình. Xem Định cấu
trang 32).
echeck_account_ Kiểu tài khoản. Những giá trị khả thi: • bán (R) liệt kê
loại Chuỗi (1)

• C: Đang kiểm tra
• tao_thanh_to_t
oken (R)
• S: Tiết kiệm (chỉ USD)
• X: Kiểm tra doanh nghiệp ent_token (R)
(chỉ USD)
• G: Sổ Cái toán_cập nhật (O)
Khách hàng của bạn có thể nhập giá

trị này trong quá trình thanh
toán hoặc bạn có thể đưa trường
trang 32).

echeck_check_ Kiểm tra số. • bán (Xem số

số mô tả)
Nếu bộ xử lý thanh toán của Số nguyên (8)
bạn là TeleCheck, bạn nên bao gồm • tạo_thanh toán_t

trường này. oken (Xem
mô tả)

ent_token (Xem
mô tả)
toán_ mã
trang 32).

kiểm tra_hiệu lực_ Ngày có hiệu lực của giao dịch. • bán (O) Ngày (b)
ngày Ngày này phải trong vòng 45 ngày kể
từ ngày hiện tại. • sale,create_paym Chuỗi (8)
ent_token (O)
Định dạng: MMDDyyyy
echeck_routing_ Số định tuyến ngân hàng. • bán (R) số

số
Nếu loại tiền đang được sử • tao_thanh_to_t số nguyên

dụng là CAD, độ dài tối đa của số oken (R) không âm
định tuyến là 8 chữ số. (Xem
mô tả)
ent_token (R)
Nếu đơn vị tiền tệ đang được
sử dụng là USD, độ dài tối đa của
số định tuyến là 9 chữ số.

trang 32).
echeck_sec_code Phương thức ủy quyền được sử dụng • bán (O) liệt kê
cho giao dịch. Xem Mã SEC (ở trang Chuỗi (3)

226). • tạo_thanh toán_t
oken (O)
Bank of America ACH các giá trị

có thể: • sale,create_paym
ent_token (O)
• CCĐ

• PPD
• ĐT
• TRANG WEB

Chase Paymentech Solutions ở Canada,
sử dụng WEB cho tất cả các giao dịch
ACH.
Các giá trị có thể có của Chase Paymentech
Solutions ở Hoa Kỳ:
• CCĐ
• PPD
• ĐT
• TRANG WEB
TeleCheck các giá trị có thể:
• PPD
• ĐT
• TRANG WEB
Wells Fargo ACHgiá trị có thể:
• CCĐ
• PPD
• ĐT
• TRANG WEB
chăm sóc sức khỏe_#_ Số tiền thanh toán chăm sóc sức ủy quyền (O) Chuỗi (13)
số lượng khỏe. # có thể nằm trong
khoảng từ 0 đến 4. Gửi trường này
cùng với trường
health_care_#_amount_type tương ứng .
Loại thanh toán chăm sóc sức khỏe. # có thể nằm ủy quyền (O) Chuỗi (35)
chăm_sóc_#_số_lượng_loại trong khoảng từ 0 đến 4.
Các giá trị có thể có của Mastercard:
• đủ điều kiện-tổng: tổng

số tiền chăm sóc sức khỏe.
• đơn thuốc
Visa giá trị có thể:
• phòng khám
• nha khoa
• chăm sóc sức khỏe: tổng số tiền
chăm sóc sức khỏe.
• chăm sóc sức khỏe-vận chuyển
• đơn thuốc
• tầm nhìn
Gửi trường này cùng với
trường
health_care_#_amount tương ứng .
bỏ qua_avs Bỏ qua kết quả xác minh AVS. Không bắt buộc liệt kê
Những giá trị khả thi: Chuỗi (5)
• đúng
• sai

bỏ qua_cvn Bỏ qua kết quả xác minh CVN. Không bắt buộc liệt kê
Những giá trị khả thi: Chuỗi (5)
• đúng
• sai
Industry_datatype Cho biết liệu giao dịch có bao gồm dữ liệu ủy quyền (O) Chuỗi (20)
ngành hay không. Đối với một số ngành
nhất định, bạn phải đặt trường này
thành giá trị dữ liệu ngành để gửi
đến bộ xử lý. Khi trường này không
được đặt thành giá trị ngành hoặc không

được bao gồm trong yêu cầu, dữ liệu
ngành sẽ không được chuyển đến bộ xử

lý.
• chăm sóc_y tế
• chăm sóc sức khỏe_transit
trả góp_ Số tiền trả góp hiện tại. ủy quyền (Xem mô tả) Số tiền
số lượng (12)
Trường này chỉ bắt buộc đối

với các khoản thanh toán trả góp
trên Cybersource Latin American
Processing hoặc Visa Platform

Connect.

trả góp_ tần Tần suất trả góp. Những giá trị khả ủy quyền (Xem mô tả) IC AlphaNumer
suất thi: (2)
• B: Hai tuần một lần
• M: Hàng tháng
• W: Hàng tuần
Trường này chỉ được hỗ trợ trên

Visa Platform Connect.

trả góp_ Cờ cho biết loại tài trợ cho gói ủy quyền (Xem mô tả) nguồn mạng
gói_loại trả góp liên quan đến khoản thanh Latin
toán. Người Mỹ
Những giá trị khả thi: Xử lý:
Chuỗi (1)
• 1: Gói trả góp do
Hộ chiếu
người bán tài trợ
Nền tảng
• 2: Trả góp do tổ chức phát hành tài trợ Kết nối:
kế hoạch Chuỗi (2)
Nếu bạn không bao gồm trường này trong
yêu cầu, thì giá trị trong tài khoản của
bạn sẽ được sử dụng. Để thay đổi giá trị
này, hãy liên hệ với bộ phận hỗ trợ khách hàng.
Mã do American Express xác

định cho biết loại gói trả góp
cho giao dịch này. Liên hệ
với American Express để:
• Thông tin về các loại chương

trình trả góp mà American
Express cung cấp.
• Các giá trị cho trường này.

trả góp_ Số trả góp khi thanh toán ủy quyền (Xem mô tả) Số nguyên (2)
sự liên tiếp theo đợt. Được sử dụng
cùng với install_total_count để
theo dõi khoản thanh toán nào đang
được xử lý. Ví dụ: lần thanh toán
thứ hai trong số năm lần thanh
toán sẽ được chuyển thành
phần_số_phần_trả_số = 2 và
phần_tổng_số_ước = 5.
Trường này chỉ bắt buộc đối với

các khoản thanh toán trả góp trên
Visa Platform Connect.
trả góp_ Tổng số tiền của khoản vay đang ủy quyền (xem mô tả) Số tiền
tổng_số tiền được trả dần. (12)
Trường này chỉ bắt buộc

đối với các khoản thanh toán
trả góp trên Cybersource Latin
American Processing và Visa
Platform Connect.
trả góp_ Tổng số lần thanh toán trả góp ủy quyền (Xem mô tả) số
tổng_số như một phần của ủy quyền. Chuỗi (2)
Các giá trị có thể: 1 đến 99
Trường này chỉ bắt buộc

đối với các khoản thanh toán
trả góp trên Cybersource Latin
American Processing và Visa
Platform Connect.

tổ chức phát hành_dữ liệu Dữ liệu được xác định bởi tổ chức phát hành. ủy quyền (O) Chuỗi ic chữ và
bổ sung số (256)
Xem phần “Dữ liệu tùy ý” trong

Dịch vụ thẻ tín dụng Tính năng tùy
chọn Bổ sung API SCMP hoặc Dịch
vụ thẻ tín dụng Các tính năng tùy chọn Bổ
sung API đặt hàng đơn giản.
mã hàng Loại sản phẩm. # có thể dao động từ Không bắt buộc AlphaNumer
0 đến 199. icPunctuatio
Nếu bạn bao gồm trường này, n Chuỗi
bạn cũng phải bao gồm (255)
trường line_item_count .
Tên mục Tên mặt hàng. # có thể nằm trong Xem mô tả. AlphaNumer
khoảng từ 0 đến 199. icPunctuatio n
Nếu bạn bao gồm trường này, String
Trường này là bắt buộc khi giá trị bạn cũng phải bao gồm (255)
item_#_code không phải là giá trị mặc trường line_item_count .
định cũng như không liên quan đến vận
chuyển hoặc xử lý.
mục_#_hành khách _email Địa chỉ email của hành khách. Không bắt buộc Chuỗi (255)
Xem Trình quản lý quyết
mục_#_hành khách _tên Tên hành khách. Không bắt buộc Chuỗi (60)
mục_#_id hành khách ID của hành khách mà vé đã được phát Không bắt buộc Chuỗi (32)
hành. Ví dụ: bạn có thể sử dụng
trường này cho số hành khách Xem Trình quản lý quyết

thường xuyên. định (ở trang 87).

item_#_passenger _phone Số điện thoại của hành khách. Nếu đơn đặt Không bắt buộc Chuỗi (15)
hàng từ bên ngoài Hoa Kỳ, hãy bao
gồm mã quốc gia. Xem Trình quản lý quyết
mục_#_hành khách _status Phân loại hành khách của công ty Không bắt buộc Chuỗi (32)
bạn, chẳng hạn như số hành khách
thường xuyên. Trong trường hợp này, Xem Trình quản lý quyết
bạn có thể sử dụng các giá trị như tiêu định (ở trang 87).
chuẩn, vàng hoặc bạch kim.
mục_#_hành khách Họ của hành khách. Không bắt buộc Chuỗi (60)
_họ
mặt hàng_#_loại_hành Phân loại hành khách gắn với giá vé. Không bắt buộc Chuỗi (32)
khách

• ADT: Người lớn
• CNN: Con
• INF: Trẻ sơ sinh
• YTH: Tuổi trẻ
• STU: Sinh viên
• SCR: Người cao tuổi
• SỮA: Quân đội

item_#_quantity Số lượng chi tiết đơn hàng. Giá trị mặc Xem mô tả. số
định là 1.
Nếu bạn bao gồm trường Chuỗi (10)

Trường bắt buộc khi một trong các mã này, bạn cũng phải bao
sản phẩm này được sử dụng: gồm trường
line_item_count .
• Nội dung người lớn
• phiếu mua hàng
• điện tử_tốt
• phần mềm điện tử
• phiếu quà tặng
• dịch vụ
• đăng ký
# có thể nằm trong khoảng từ 1 đến 199.
Trường này là bắt buộc khi giá trị
item_#_code không phải là giá trị mặc
định cũng như không liên quan đến vận
chuyển hoặc xử lý.

mục_#_sku Mã nhận dạng cho sản phẩm. Xem mô tả. AlphaNumer

icPunctuatio
Nếu bạn bao gồm trường N
Trường bắt buộc khi một trong các mã này, bạn cũng phải bao
sản phẩm này được sử dụng: gồm trường Chuỗi (255)

line_item_count .
• Nội dung người lớn
• phiếu mua hàng
• điện tử_tốt
• phần mềm điện tử
• phiếu quà tặng
• dịch vụ
• đăng ký
# có thể nằm trong khoảng từ 0 đến 199.
mặt hàng_#_thuế_ Số tiền thuế áp dụng cho mục hàng. # Không bắt buộc Số lượng
số lượng có thể nằm trong khoảng từ 0 đến 199.
Giá trị này không được âm. Số tiền thuế Nếu bạn bao gồm trường Chuỗi (15)
và số tiền ưu đãi phải bằng cùng một này, bạn cũng phải bao
loại tiền tệ. gồm trường
line_item_count .
item__#_unit_price Giá của mục hàng. # có thể nằm trong khoảng Xem mô tả. Số lượng
từ 0 đến 199. Giá trị này không được âm.
Nếu bạn bao gồm trường Chuỗi (15)
này, bạn cũng phải bao

gồm trường
Quan trọng: Bạn phải bao line_item_count .
gồm trường này hoặc trường số
tiền trong yêu cầu.

Journey_leg#_dest Mã sân bay cho điểm đến của chuyến đi, được Không bắt buộc anpha
biểu thị bằng ký hiệu thăng (#) trong
tên trường. Có thể bao gồm tối đa 30 Xem Trình quản lý quyết Chuỗi (3)
chân trong yêu cầu. Mã này thường dài ba định (ở trang 87).
chữ số, ví dụ: SFO = San Francisco.
Không sử dụng dấu hai chấm (:) hoặc
dấu gạch ngang (-). Để biết danh sách đầy
đủ các mã sân bay, hãy xem Danh mục mã thành
phố của IATA .
Trong yêu cầu của bạn, hãy
gửi trường complete_route hoặc
các chặng riêng lẻ (hành
trình_chân#_orig và hành
trình_chân#_điểm). Nếu bạn gửi tất
cả các trường, tuyến đường hoàn chỉnh
sẽ được ưu tiên hơn các chặng riêng lẻ.
Journey_leg#_orig Mã sân bay cho chặng xuất phát của chuyến đi, Không bắt buộc anpha
được biểu thị bằng ký hiệu thăng (#)
trong tên trường. Xem Trình quản lý quyết Chuỗi (3)
Có thể bao gồm tối đa 30 chân trong định (ở trang 87).
yêu cầu. Mã này thường dài ba chữ số, ví
dụ: SFO = San Francisco.
Không sử dụng dấu hai chấm (:) hoặc
dấu gạch ngang (-). Để biết danh sách đầy
đủ các mã sân bay, hãy xem Danh mục mã thành
phố của IATA .
Trong yêu cầu của bạn, hãy
gửi trường complete_route hoặc
các chặng riêng lẻ (hành
trình_chân#_orig và hành
trình_chân#_điểm). Nếu bạn gửi tất
cả các trường, tuyến đường hoàn chỉnh
sẽ được ưu tiên hơn các chặng riêng lẻ.

hành trình_type Loại hành trình, chẳng hạn như một chiều Không bắt buộc AlphaNumer
hoặc khứ hồi. icPunctuatio
Xem Trình quản lý quyết N
Chuỗi (32)
line_item_count Tổng số mục hàng. Trường này là bắt buộc số

Số lượng tối đa là 200. khi bạn bao gồm bất
kỳ trường mục nào trong Chuỗi (2)
yêu cầu.
miền địa phương

Cho biết ngôn ngữ sẽ sử dụng cho nội Yêu cầu của ứng dụng Chấp địa phương
dung hướng tới khách hàng. Giá trị có nhận an toàn.

thể: en-us. Xem phần "Kích hoạt Hồ Chuỗi (5)
sơ" (ở trang 44).
người bán_xác định Các trường tùy chọn mà bạn có thể sử Không bắt buộc AlphaNumer
_dữ liệu# dụng để lưu trữ thông tin (xem Định cấu icPunctuatio
hình Thông báo Khách hàng (ở trang Xem Trình quản lý quyết N
35)). # có thể nằm trong khoảng từ 1 đến 100.

Chuỗi (100)
Các trường dữ liệu do người bán xác
định từ 1 đến 4 được liên kết với
mã thông báo thanh toán và được sử
dụng cho các giao dịch dựa trên mã

thông báo tiếp theo. Các trường dữ liệu
do người bán xác định từ 5 đến 100
được chuyển qua máng tới Trình quản
lý quyết định như một phần của yêu cầu

thanh toán ban đầu và không được liên
kết với mã thông báo thanh toán.
Quan trọng:
Các trường dữ liệu do
người bán xác định không
nhằm mục đích và KHÔNG ĐƯỢC
sử dụng để thu thập thông tin nhận

dạng cá nhân. Theo đó, người
bán bị cấm chụp, lấy và/hoặc
truyền bất kỳ thông tin nhận
dạng cá nhân nào

thông tin trong hoặc thông

qua các trường dữ liệu do người
bán xác định và bất kỳ trường

Chấp nhận an toàn nào không
được thiết kế riêng để thu thập
thông tin nhận dạng cá nhân.
Thông tin nhận dạng cá
nhân bao gồm, nhưng không giới
hạn, số thẻ, số tài khoản ngân
hàng, số an sinh xã hội,
số giấy phép lái xe, số

nhận dạng do nhà nước cấp,
số hộ chiếu, số xác minh thẻ
(CVV, CVC2, CVV2, CID, CVN).
Nếu phát hiện ra rằng một
người bán đang thu thập và/hoặc

truyền thông tin nhận dạng
cá nhân qua các trường dữ liệu do
người bán xác định, dù cố ý hay
không, tài khoản của người bán

SẼ bị đình chỉ ngay lập tức, điều
này sẽ dẫn đến việc từ chối

bất kỳ và tất cả các yêu cầu giao
dịch đã gửi bởi người bán
sau thời điểm đình chỉ.

người bán_ Để biết mô tả, thông tin được sử ủy quyền (Xem mô tả)
mô tả dụng, loại dữ liệu và độ dài
cho các trường này, hãy xem
thương Mô tả người bán bằng cách sử
gia_ mô tả_ dụng API SCMP hoặc Mô tả người
thay thế bán bằng cách sử dụng API đặt

hàng đơn giản .
thương
gia_ mô tả_thành phố
người bán_
mô tả_ liên
hệ
người bán_
mô tả_ quốc
gia
người bán_
mô tả_ mã bưu chính

_
Merchant_
descriptor_state
thương
gia_ mô tả_đường phố
Merchant_secure_ data4 Trường tùy chọn mà bạn có thể sử Không bắt buộc AlphaNumer
dụng để lưu trữ thông tin. Dữ liệu icPunctuatio
được mã hóa trước khi được lưu trữ N
trong kho lưu trữ thanh toán.
Chuỗi
(2000)
Merchant_secure_ data1 Các trường tùy chọn mà bạn có thể sử Không bắt buộc AlphaNumer
dụng để lưu trữ thông tin. Dữ liệu icPunctuatio
được mã hóa trước khi được lưu trữ N
Merchant_secure_ data2 trong kho lưu trữ thanh toán.
Chuỗi (100)
Merchant_secure_ data3
override_ Ghi đè cài đặt cấu hình URL bài đăng của Không bắt buộc URL
backoffice_post_ url văn phòng hỗ trợ bằng URL của bạn. URL
phải là HTTPS và hỗ trợ TLS 1.2 trở Chuỗi (255)

lên.
override_custom_ Ghi đè cài đặt cấu hình trang hủy tùy Không bắt buộc URL
cancel_page chỉnh bằng URL của bạn. URL phải là HTTPS
và hỗ trợ TLS 1.2 trở lên. Chuỗi (255)
ghi đè_custom_ biên Ghi đè cài đặt cấu hình biên nhận Không bắt buộc URL
nhận_trang tùy chỉnh bằng URL của bạn. URL phải là
HTTPS và hỗ trợ TLS 1.2 trở lên. Chuỗi (255)

ghi đè_ Ghi đè ngày và giờ giao dịch bằng số phút mà Không bắt buộc Số nguyên (5)
khách hàng_ khách hàng đến trước hoặc sau UTC. Sử dụng
utc_offset trường này để ghi đè thời gian trình duyệt
cục bộ do Chấp nhận an toàn phát hiện.
Thời gian này xác định ngày trên các trang
biên nhận và email.
Ví dụ: nếu khách hàng đến trước 2 giờ, giá
trị là 120; nếu trễ 2 giờ thì -120; nếu
UTC, giá trị là 0.
override_paypal_ Ghi đè cài đặt hồ sơ thiết lập đơn đặt hàng Không bắt buộc Chuỗi (21)
order_setup PayPal. Những giá trị khả thi:
Xem Bật PayPal Express
• include_authorization: Đơn đặt hàng Checkout(ở trang 27).
PayPal được tạo và ủy quyền.
• loại trừ_ủy quyền: Đơn đặt hàng
PayPal được tạo nhưng không được

ủy quyền.
người Gửi thư này để thông báo cho tổ chức Không bắt buộc Chuỗi (2)
thanh toán_ xác thực_ phát hành rằng quốc gia của bên mua
người mua_quốc gia khác với quốc gia của người bán và bên
mua đang ở Khu vực kinh tế châu Âu (EEA)
cũng như Vương quốc Anh và Gibraltar.

người Đặt kích thước cửa sổ thử thách hiển thị Không bắt buộc Số nguyên (2)
trả tiền_ xác thực_ cho chủ thẻ.
acs_window_size Máy chủ Kiểm soát Truy cập (ACS) trả lời
với nội dung được định dạng phù hợp
với kích thước cửa sổ này. Các kích

thước là chiều rộng x chiều cao tính
bằng pixel. Chấp nhận an toàn tính toán
giá trị này dựa trên kích thước của cửa sổ

trong đó Chấp nhận an toàn được hiển thị,
nhưng bạn có thể ghi đè giá trị này.
• 01: 250 x 400
• 02: 390 x 400
• 03: 500 x 600
• 04: 600 x 400
• 05: Toàn trang

người Những giá trị khả thi: Không bắt buộc Số nguyên (2)
trả tiền_ xác thực_
thách thức_mã • 01: Không ưu tiên
• 02: Không yêu cầu thử thách
• 03: Thử thách yêu cầu
(Tùy chọn người yêu cầu 3D
Secure)
• 04: Thử thách yêu cầu (nhiệm vụ)
• 05: Không yêu cầu thử thách (đã
thực hiện phân tích rủi ro giao dịch)
• 06: Không yêu cầu thử thách (chỉ
chia sẻ dữ liệu)
• 07: Không yêu cầu xác thực (xác
thực người tiêu dùng
mạnh đã được thực hiện)
• 08: Không yêu cầu thử thách (sử
dụng miễn trừ danh sách trắng nếu
không yêu cầu thử thách)
• 09: Đã yêu cầu thử thách (yêu
cầu nhắc danh sách trắng nếu yêu cầu
thử thách)
Trường này sẽ mặc định là 01 trên cấu
hình người bán và có thể bị người bán ghi
đè.
EMV 3D Secure 2.1.0 hỗ trợ các giá trị

01-04. Phiên bản 2.2.0 hỗ trợ các
giá trị 01-09.

người Số giao dịch (thành công và Không bắt buộc Số nguyên (3)
trả tiền_ xác bị hủy) cho tài khoản chủ thẻ này
thực_ khách hàng_ trong năm qua.
giao dịch_
hàng năm_ số lượng
người Số giao dịch (thành công hoặc bị hủy) Không bắt buộc Số nguyên (3)
trả tiền_ xác cho tài khoản chủ thẻ này trong vòng 24
thực_ khách hàng_ giờ qua.

giao dịch hàng ngày_
đếm
người Cho biết loại yêu cầu Không bắt buộc Số nguyên (2)
trả tiền_ xác xác thực. Chấp nhận an toàn tự động
thực_ chỉ báo điền vào trường này, nhưng
bạn có thể ghi đè nó.
• 01: Giao dịch thanh toán
• 02: Giao dịch định kỳ
• 03: Giao dịch trả góp
• 04: Thêm thẻ
• 05: Bảo trì thẻ
• 06: Xác minh chủ thẻ như một
phần của xác minh và
nhận dạng mã thông báo EMV
(ID&V)
người Cho biết nguồn gốc của ưu đãi tiếp thị. Không bắt buộc Chuỗi (40)
trả tiền_ xác
thực_ tiếp thị_nguồn

người Được người bán tính toán theo Không bắt buộc Số nguyên (2)
trả tiền_ xác thực_ Chỉ thị dịch vụ thanh toán 2 (PSD2) và
người bán_gian lận_ Tiêu chuẩn kỹ thuật theo quy định (RTS).
tỷ lệ
Gian lận thẻ ở Khu vực Kinh tế Châu Âu (EEA)

và Vương quốc Anh và Gibraltar chia cho
tất cả khối lượng thẻ ở EEA và Vương

quốc Anh và Gibraltar.
• 1: Thể hiện tỷ lệ gian lận ≤1
• 2: Thể hiện tỷ lệ gian lận >1 và ≤6
• 5: Thể hiện tỷ lệ gian lận >25
người Tên công ty của bạn như bạn muốn nó xuất hiện Không bắt buộc Chuỗi (25)
thanh toán_ xác thực_ với khách hàng trong biểu mẫu xác thực
tên người bán của ngân hàng phát hành. Giá trị này sẽ ghi
đè giá trị do ngân hàng thương gia của
bạn chỉ định.
người Điểm rủi ro do người bán cung cấp. Không bắt buộc Chuỗi (20)
trả tiền_ xác thực_ Được sử dụng cho các giao dịch
thương gia_điểm số Cartes Bancaires.
người Xác định danh mục của thông báo cho một Không bắt buộc Chuỗi (2)
trả tiền_ xác thực_ trường hợp sử dụng cụ thể Máy chủ bảo mật 3-D.
tin nhắn_ danh mục
• 01: PA (xác thực thanh
toán).

• 02: NPA (xác thực không thanh
toán).
• 03-71: Dành riêng cho EMVCo sử dụng
trong tương lai (giá trị không hợp
lệ cho đến khi được EMVCo xác định).
• 80-99: Dành cho
sử dụng máy chủ thư mục.
người Số điện thoại di động của chủ thẻ. Không bắt buộc Số nguyên (25)
trả tiền_ xác thực_
mobile_phone
Quan trọng: Bắt buộc đối với

Visa Giao dịch an toàn tại Brazil.
Không sử dụng trường yêu cầu này cho
bất kỳ loại giao dịch nào khác.
người Cho biết khách hàng là khách hàng mới hay Không bắt buộc Chuỗi (5)
thanh toán_ xác thực_ khách hàng hiện tại của người bán.
khách hàng mới
• đúng
• sai
người Cho biết liệu chủ thẻ có đang đặt hàng với Không bắt buộc Số nguyên (2)
thanh toán_ xác thực_ tình trạng sẵn có hoặc ngày phát hành
đặt hàng trước trong tương lai hay không.
• 01: Hàng có sẵn
• 02: Khả dụng trong tương lai

người Ngày dự kiến sẽ có mặt hàng đặt trước. Không bắt buộc Số nguyên (8)
thanh toán_ xác
thực_ trước_ngày_đặt_hàng
Định dạng: yyyyMMDD
người Dữ liệu mà ACS có thể sử dụng để xác minh Không bắt buộc Chuỗi
trả tiền_ xác thực_ quy trình xác thực. (2048)
trước_
xác thực_ dữ liệu
người Phương thức mà chủ thẻ đã sử dụng trước Không bắt buộc Số nguyên (2)
trả tiền_ xác thực_ đó để xác thực với người yêu cầu 3D Secure.
trước_
phương thức xác

thực_ Những giá trị khả thi:
• 01: Xác thực trơn
tru thông qua

ACS
• 02: Thách thức chủ thẻ qua ACS
• 03: AVS đã xác minh
• 04: Phương thức phát hành khác
• 05-79: Dành riêng cho EMVCo sử dụng
trong tương lai (giá trị không hợp
lệ cho đến khi được EMVCo xác định)
• 80-99: Dành cho
sử dụng máy chủ thư mục
người Trường này chứa ID giao Không bắt buộc Chuỗi (36)
trả tiền_ xác thực_ dịch ACS cho một giao dịch được
trước_ xác thực.
xác thực_ tham Ví dụ: giao dịch định kỳ
chiếu_id đầu tiên được xác thực với chủ thẻ.

người Ngày và giờ tính theo UTC của Không bắt buộc Số nguyên (12)
trả tiền_ xác thực_ lần xác thực chủ thẻ trước đó.
trước_
xác thực_ thời gian
Định dạng: yyyyMMDDHHMM
người Chỉ định mã sản phẩm, chỉ định loại giao dịch. Không bắt buộc Chuỗi (3)
thanh toán_ xác thực_
sản phẩm_mã Những giá trị khả thi:
• AIR: Mua vé máy bay
Quan trọng: Bắt
buộc đối với American Express
SafeKey (Hoa Kỳ).
• ACC: Cho thuê nhà ở
• ACF: Tài khoản cấp vốn
• CHA: Kiểm tra nghiệm thu
• DIG: Hàng kỹ thuật số
• DSP: Phân phối tiền mặt
• KHÍ: Nhiên liệu
• GEN: Bán lẻ tổng hợp
• LUX: Bán lẻ Cao cấp
• PAL: Kích hoạt trả trước và

trọng tải
• PHY: Mua hàng hóa hoặc dịch
vụ
• QCT: Giao dịch gần như tiền mặt
• REN: Cho thuê ô tô
• RES: Nhà hàng
• SVC: Dịch vụ

• TBD: Khác
• TRA: Du lịch
Quan trọng: Bắt buộc đối với

Visa Giao dịch an toàn tại Brazil.
Không sử dụng trường yêu cầu này cho
bất kỳ loại giao dịch nào khác.
người Ngày mà sau đó không được thực hiện các Không bắt buộc Số nguyên (8)
thanh toán_ xác thực_ ủy quyền định kỳ nữa. Định dạng:
định kỳ_ kết thúc_ yyyyMMDD.

ngày
Trường này là bắt buộc đối với
các giao dịch định kỳ. Nếu tần
suất lặp lại và số lần cài đặt lặp
lại được bao gồm trong yêu cầu, Chấp nhận an
toàn sẽ tự động điền vào trường này.
Chỉ định một giá trị để ghi đè logic này.

người Giá trị số nguyên cho biết số Không bắt buộc Số nguyên (3)
trả tiền_ xác ngày tối thiểu giữa các lần ủy
thực_ định quyền định kỳ.
kỳ_ tần suất Tần suất hàng tháng được biểu
thị bằng giá trị 28. Bội số của 28 ngày
sẽ được sử dụng để biểu thị tháng.
Ví dụ:
6 tháng= 168
Trường này là bắt buộc đối
với các giao dịch định kỳ.
Nếu tần_suất lặp lại được bao gồm trong

yêu cầu, Chấp nhận an toàn sẽ tự động
điền vào trường này. Chỉ định một
giá trị để ghi đè logic này.
người Cho biết liệu chủ thẻ có sắp xếp lại Không bắt buộc Số nguyên (2)
thanh toán_ xác hàng hóa đã mua trước đó
thực_ sắp xếp lại hay không.
• 01: Đặt hàng lần đầu
• 02: Sắp xếp lại

người Cho biết rằng các quy trình và thủ tục thanh Không bắt buộc Chuỗi (1)
trả tiền_ xác thực_ toán chuyên dụng đã được sử dụng. Có thể
bảo mật_ doanh nghiệp_ áp dụng miễn trừ thanh toán an toàn cho công
thanh toán ty.
• 0
• 1
người Ngày mà địa chỉ giao hàng này được sử Không bắt buộc Số nguyên (8)
thanh toán_ xác thực_ dụng lần đầu tiên.
vận chuyển_đến_địa chỉ_
lần đầu tiên được sử dụng Những giá trị khả thi:
• -1: Tài khoản khách
• 0: Được sử dụng lần đầu trong

giao dịch này
Nếu không có giá trị nào được áp dụng, hãy
nhập ngày ở định dạng yyyyMMDD.

người Mã định danh chế độ giao dịch. Yêu cầu của ứng dụng Chấp nhận Chuỗi (1)
trả tiền_ xác thực_ Xác định kênh mà giao dịch bắt nguồn từ đó. an toàn.
giao dịch_ chế độ
• M: MOTO (Đặt hàng qua thư
Điện thoại đặt hàng)
• R: Bán lẻ
• S: Thương mại điện tử
• P: Thiết Bị Di Động
• T: Máy tính bảng
người trả Cho phép liên lạc về người thụ hưởng Không bắt buộc Chuỗi (5)
tiền_ xác thực_ được đưa đáng tin cậy và trạng thái danh sách trắng
vào danh sách trắng giữa ACS, máy chủ thư mục và người
yêu cầu Bảo mật 3D.
• true: Người yêu cầu 3D Secure được
chủ thẻ đưa vào danh sách cho phép
• sai: chủ thẻ không đưa người yêu
cầu 3D Secure vào danh sách

cho phép

payment_method Phương thức thanh toán. Những giá trị Không bắt buộc liệt kê
khả thi: Chuỗi (30)
• thẻ
• kiểm tra
• người trả tiền
• thanh toán thị thực
payment_token Mã định danh cho chi tiết thanh toán. • ủy quyền hoặc bán số
Mã thông báo thanh toán truy xuất dữ (R)

liệu thẻ, thông tin thanh toán và Chuỗi (32)
thông tin vận chuyển từ kho lưu • ủy quyền,cập
trữ thanh toán. Khi trường này nhật_thanh toán_đến
được bao gồm trong yêu cầu, dữ liệu ken (R)
thẻ cũng như thông tin thanh toán và

• sale,update_pay
vận chuyển là tùy chọn.
ment_token (R)
Bạn phải đang sử dụng Dịch

vụ quản lý mã thông báo. Điền mã
toán_cập nhật (R)
khách hàng vào trường này.
Trường này là bắt buộc đối với

các giao dịch dựa trên mã thông báo.
thanh toán_token_ Nhận xét tùy chọn mà bạn có thể thêm Không bắt buộc AlphaNumer
bình luận cho mã thông báo của khách hàng. icPunctuatio
N
Chuỗi (255)
thanh toán_token_ Tên hoặc tiêu đề cho mã thông báo của Không bắt buộc AlphaNumer
tiêu đề khách hàng. icPunctuatio
N
Chuỗi (60)
profile_id Xác định hồ sơ để sử dụng với mỗi Được chỉ định bởi ứng ASCIIAlpha
giao dịch. dụng Chấp nhận an toàn. Chữ số
Chuỗi (36)
promotion_code Mã khuyến mãi cho một giao dịch. Không bắt buộc Chuỗi (100)

người nhận_ Định danh cho tài khoản của ủy quyền (R cho các giao số
tài khoản_id người nhận. Sử dụng sáu chữ số đầu dịch của người nhận, nếu
tiên và bốn chữ số cuối cùng của số không thì không được sử dụng) Chuỗi (10)
tài khoản của người nhận.
người Ngày sinh của người nhận. ủy quyền (R cho các giao Ngày (b)
nhận_ ngày_sinh_ dịch của người nhận, nếu
Định dạng: yyyyMMDD. không thì không được sử dụng) Chuỗi (8)
người nhận_ Một phần mã bưu chính cho ủy quyền (R cho các giao chữ số ic
mã bưu chính địa chỉ của người nhận. dịch của người nhận, nếu
không thì không được sử dụng)
Ví dụ: nếu mã bưu chính là NN5 Chuỗi (6)

7SG, giá trị cho trường này phải
là phần đầu tiên của mã bưu
chính: NN5.
người nhận_ Họ của người nhận. ủy quyền (R cho các giao anpha
họ dịch của người nhận, nếu
không thì không được sử dụng) Chuỗi (6)
recur_amount Số tiền thanh toán cho mỗi lần trả • tao_thanh_to_t Số lượng
góp hoặc thanh toán đăng oken (R)

ký định kỳ. Chuỗi (15)
• ủy
ent_token (R)

định kỳ_ tự Cho biết có tự động gia • tạo_thanh toán_t liệt kê
động_renew hạn lịch thanh toán cho đăng ký trả góp oken (O) Chuỗi (5)
hay không. Những giá trị khả thi:
• ủy
quyền,create_payment_tok en (O)
• true (mặc định): Tự động
thay mới.
ent_token (O)
• false: Không tự động
thay mới.
định kỳ_ Tần suất thanh toán cho đăng ký • tao_thanh_to_t oken liệt kê
tần số trả góp hoặc định kỳ. Những giá (R) Chuỗi (20)
trị khả thi:
• ủy
• hàng tuần: 7 ngày một lần.

• hai tuần một lần: 2 tuần một lần.

• quad-weekly: Mỗi 4 tuần. ent_token (R)
• hàng tháng • mã thông báo_thanh
• nửa tháng: Hai lần mỗi tháng

(mùng 1 và 15).
• hàng quý
• nửa năm một lần: Hai lần một lần

năm.
• hàng năm

định kỳ_ Tổng số lần thanh toán được thiết • tao_thanh_to_t số
số_lần_ trả lập cho đăng ký trả góp. oken (R)

góp Chuỗi (3)
Giá trị tối đa: • ủy
• 261: Tuần
• 130: Hai tuần một lần
ent_token (R)
• 65: Bốn tuần một lần

• 60: Hàng tháng toán_cập nhật (O)
• 120: Nửa tháng
• 20: Theo quý
• 10: Bán niên
• 5: Hàng năm
ngày_bắt đầu_định Ngày thanh toán đầu tiên • tạo_thanh toán_t Ngày (b)
kỳ cho thanh toán trả góp oken (O)
hoặc đăng ký định kỳ. Ngày phải sử Chuỗi (8)
dụng định dạng yyyyMMDD. Nếu một • ủy
ngày trong quá khứ được cung

cấp, thì ngày bắt đầu sẽ mặc định là quyền,create_payment_tok en (O)
ngày sau ngày được nhập.
ent_token (O)

số tham Số theo dõi hoặc tham chiếu đơn đặt Yêu cầu của ứng dụng Chấp AlphaNumer
chiếu hàng do người bán tạo duy nhất cho nhận an toàn. icPunctuatio
mỗi giao dịch. N
Châu Á, Trung
Đông và
dữ liệu, hãy ký tên vào trường này. Châu phi
Cổng:
Chuỗi (40)
Atos: Chuỗi
(32)
Tất cả khác
bộ vi xử lý:
Chuỗi (50)
return_accepted Cho biết liệu việc trả lại sản phẩm có được chấp Không bắt buộc liệt kê
nhận hay không. Trường này có Chuỗi (5)

thể chứa một trong các giá trị sau: Xem Trình quản lý quyết

• đúng
• sai

bán ID công ty được chỉ định cho ủy quyền Số nguyên

hàng_ tổ chức_id một tổ chức bán hàng độc lập. (Yêu cầu không âm (11)
Lấy giá trị này từ Mastercard. Mastercard tổng hợp giao
dịch trên Visa
Kết nối nền tảng Visa Kết nối nền tảng)
Giá trị cho trường này
tương ứng với dữ liệu này trong tệp

chụp TC 33:
Kỷ lục: CP01 TCR6
Vị trí: 106-116
Lĩnh vực: Mastercard độc lập

ID tổ chức bán hàng
ship_to_address_ Thành phố của địa chỉ giao hàng. Không bắt buộc AlphaNumer
thành phố icPunctuatio
Khách hàng của bạn có thể nhập giá trị n String (50)

mình. Xem Định cấu hình các
trường thông tin vận chuyển (ở
trang 31).
ship_to_address_ Mã quốc gia cho địa chỉ giao Không bắt buộc anpha
country hàng. Sử dụng mã quốc gia ISO gồm
hai ký tự. Chuỗi (2)

trang 31).

ship_to_address_ Dòng đầu tiên của địa chỉ giao hàng. Không bắt buộc AlphaNumer
line1 icPunctuatio
bạn có thể đưa trường này vào yêu Chuỗi (60)
Định cấu hình các trường thông
tin vận chuyển (ở trang 31).
ship_to_address_ Dòng thứ hai của địa chỉ giao hàng. Không bắt buộc AlphaNumer
line2 icPunctuatio
bạn có thể đưa trường này vào yêu Chuỗi (60)

Mã bưu chính cho địa chỉ giao Không bắt buộc AlphaNumer
hàng.
ship_to_address_postal_code icPunctuatio
N
Trường này là bắt buộc

nếu bill_to_address_country là Hoa Kỳ Xem
hoặc Canada. mô tả.
Khi quốc gia thanh toán là Hoa Kỳ,

mã bưu chính gồm 9 chữ số phải theo
định dạng sau: [5
chữ số][gạch ngang][4 chữ số]
Ví dụ: 12345-6789
Khi quốc gia thanh toán là

Canada, mã bưu chính gồm 6 chữ số
phải theo định dạng sau:
[alpha][numeric][alpha][space]
[numeric][alpha][numeric]
Ví dụ: A1B 2C3
Đối với các quốc gia còn
lại trên thế giới, độ dài tối đa là

10.

trang 31).

ship_to_address_ Tiểu bang hoặc tỉnh của địa chỉ Không bắt buộc AlphaNumer
tình trạng giao hàng. Đối với Hoa Kỳ và Canada, icPunctuatio
hãy sử dụng mã tiêu chuẩn của tiểu N
bang, tỉnh và lãnh thổ.
Chuỗi (2)
Trường này là bắt buộc nếu địa chỉ
giao hàng là Hoa Kỳ hoặc Canada.


ship_to_company_ Tên công ty nhận sản phẩm. Không bắt buộc AlphaNumer
tên icPunctuatio
N
này trong quá trình thanh toán hoặc Chuỗi (40)



ship_to_forename Tên người nhận sản phẩm. Không bắt buộc AlphaNumer
icPunctuatio
N

này trong quá trình thanh toán Chuỗi (60)
trường thông tin vận chuyển (ở trang
31).
ship_to_phone Số điện thoại của địa chỉ giao Không bắt buộc Điện thoại
hàng.
Chuỗi (6 đến
Khách hàng của bạn có thể nhập giá trị 15)
trường thông tin vận chuyển (ở trang
31).
ship_to_surname Họ của người nhận sản phẩm. Không bắt buộc AlphaNumer
icPunctuatio
N
Khách hàng của bạn có thể nhập

thông tin này trong quá trình Chuỗi (60)
thanh toán hoặc bạn có thể đưa
thông tin này vào yêu cầu Chấp
nhận an toàn của mình. Xem Định
cấu hình các trường thông tin vận
chuyển (ở trang 31).
ship_to_type Điểm đến vận chuyển. Không bắt buộc Chuỗi (25)
Ví dụ: Thương mại, dân cư,

cửa hàng

shipping_method Phương thức vận chuyển cho sản phẩm. Không bắt buộc liệt kê
Những giá trị khả thi: Sợi dây
• sameday: Chuyển phát nhanh Chuỗi (10)
hoặc dịch vụ trong ngày
• oneday: Dịch vụ ngày
hôm sau hoặc qua đêm
• twoday: Dịch vụ hai ngày
• ba ngày: Dịch vụ ba ngày
• chi phí thấp: Dịch vụ chi phí thấp nhất
• lấy hàng: Nhận hàng tại cửa hàng
• khác: Phương thức vận

chuyển khác
• none: Không có phương thức vận chuyển
chữ ký Chữ ký Base64 do người bán tạo. Yêu cầu của ứng dụng Chấp AlphaNumer
Điều này được tạo bằng cách sử nhận an toàn. icPunctuatio
dụng phương thức ký cho trường N
access_key được cung cấp.

signed_date_time Ngày và thời gian tạo chữ ký. Phải ở Yêu cầu của ứng dụng Chấp ISO8601
định dạng Ngày & Giờ UTC. Trường này nhận an toàn. Ngày
được sử dụng để kiểm tra các lần thử
giao dịch trùng lặp. Chuỗi (20)
Định dạng: yyyy-MM-DDThh:mm:ssZ
Ví dụ: 2020-08-11T22:47:57Z tương
đương với ngày 11 tháng 8 năm

2020, lúc 22:47:57 (10:47:57 tối).
Chữ T ngăn cách ngày và giờ.
Z biểu thị UTC.
Thời gian hệ thống của bạn

phải chính xác để tránh lỗi xử
lý thanh toán liên quan đến trường
ngày_giờ_đã ký .

đã ký_field_ Một danh sách các trường yêu cầu được Yêu cầu của ứng dụng Chấp AlphaNumer
tên ký kết, được phân tách bằng dấu nhận an toàn. icPunctuatio
phẩy. Trường này được sử dụng để N
tạo chữ ký được sử dụng để xác minh nội

dung của giao dịch nhằm bảo vệ nó Biến đổi
khỏi bị giả mạo.
Quan trọng: Tất cả yêu cầu

các trường phải được ký để
tránh giả mạo dữ liệu,
ngoại trừ các trường
card_number, card_cvn và chữ ký .
bỏ qua_auto_auth Cho biết nên bỏ qua hay thực Không bắt buộc liệt kê
hiện kiểm tra ủy quyền trước khi Chuỗi (5)

tạo mã thông báo này.
• đúng (bỏ qua

bước kiểm tra cấp phép trước)
• sai (thực hiện kiểm

tra cấp phép trước)
bỏ qua_quyết định_ Cho biết có nên bỏ qua Trình quản lý quyết Không bắt buộc liệt kê
người quản lý định hay không. Trường này có thể chứa Chuỗi (5)
một trong các giá trị sau: Xem Trình quản lý quyết
• true: Trình quản lý quyết

định không được bật cho
giao dịch này và ID dấu vân
tay của thiết bị sẽ không

được hiển thị.
• sai
submerchant_city Thành phố của người bán phụ. ủy quyền Người Mỹ
Thể hiện
Trực tiếp:
La bàn FDC American Express
Direct: R cho Chuỗi (15)
Giá trị này phải bao gồm các tất cả các giao
ký tự viết hoa. dịch tổng hợp. FDC
La bàn:
Visa Platform Connect: không Chuỗi (21)
được sử dụng.
FDC
La bàn FDC: R cho Nashville
tất cả các giao Toàn cầu:
dịch tổng hợp. Chuỗi (11)
FDC Nashville Global: R
cho tất cả các giao

dịch tổng hợp.

công ty con_ Nước của tiểu thương. Sử dụng mã ủy quyền Chuỗi (3)
quốc gia quốc gia ISO gồm hai ký tự.
American Express
La bàn FDC Direct: R cho
tất cả các giao

Giá trị này phải bao gồm các dịch tổng hợp.
ký tự viết hoa.
Visa Platform Connect: không
La bàn FDC: O cho



submerchant_ Địa chỉ email của người bán phụ. ủy quyền Người Mỹ
email Thể hiện
Kết nối nền tảng Visa American Express Trực tiếp:
Direct: R cho Chuỗi (40)
Với American Express, giá trị cho tất cả các giao

trường này tương ứng với dữ liệu dịch tổng hợp. Hộ chiếu
này trong tệp chụp TC 33: Nền tảng
Visa Platform Connect: O Kết nối:
• Ghi: CP01 TCRB cho tất cả các giao Chuỗi (40)

dịch tổng hợp với
• Vị trí: 25-64 American Express; nếu FDC
không, không được sử dụng. La bàn:

• Lĩnh vực: American Express Chuỗi (40)
Địa chỉ email của người bán
La bàn FDC: O cho
tất cả các giao FDC
dịch tổng hợp. Nashville
Toàn cầu:
FDC Nashville Global: R Chuỗi (19)


submerchant_id ID bạn đã chỉ định cho người bán phụ ủy quyền Người Mỹ
của mình. Thể hiện
Trực tiếp:
American Express
La bàn FDC Direct: R cho Chuỗi (20)

Giá trị này phải bao gồm các dịch tổng hợp. Hộ chiếu
ký tự viết hoa. Nền tảng
Kết nối nền tảng Visa: Kết nối
Kết nối nền tảng Visa với
• O cho tất cả Người Mỹ
Với American Express, giá trị cho Người Mỹ Thể hiện:
trường này tương ứng với dữ liệu Giao Chuỗi (20)
này trong tệp chụp TC 33: dịch tổng

hợp nhanh; Hộ chiếu
• Ghi: CP01 TCRB Nền tảng

• R cho tất cả Kết nối
• Vị trí: 65-84 Ủy quyền với
tổng hợp thẻ tín dụng:

• Lĩnh vực: American Express Mastercard; Chuỗi (15)
ID người bán
• nếu không, không được FDC

sử dụng.
Với Mastercard, giá trị cho trường này La bàn:
tương ứng với dữ liệu này trong Chuỗi (20)
tệp chụp TC 33: La bàn FDC: R cho
tất cả các giao FDC
• Bản ghi: CP01 TCR6 dịch tổng hợp. Nashville
Toàn cầu:
• Vị trí: 117-131 FDC Nashville Global: R
Chuỗi (14)
• Trường: ID người bán phụ dịch tổng hợp.
thợ lặn_ Tên doanh nghiệp của người bán phụ. ủy quyền Người Mỹ
tên Thể hiện
Trực tiếp:
La bàn FDC American Express
Direct: R Chuỗi (37)
Giá trị này phải bao gồm các cho tất cả các
ký tự viết hoa. giao dịch tổng hợp. FDC
la bàn với
Visa Platform Connect: không
được sử dụng. Người Mỹ
Thể hiện:
La bàn FDC: R cho Chuỗi (19)
dịch tổng hợp. FDC
la bàn với
FDC Nashville Global:
R cho tất cả các thẻ tín dụng:

giao dịch tổng hợp. Chuỗi (37)
FDC
Nashville
Toàn cầu:
Chuỗi (12)
thợ sửa điện Số điện thoại của người bán ủy quyền Người Mỹ
thoại phụ. Thể hiện

Trực tiếp:
American Express
Kết nối nền tảng Visa Direct: R cho Chuỗi (20)

Với American Express, giá trị cho dịch tổng hợp. Hộ chiếu
trường này tương ứng với dữ liệu Nền tảng
này trong tệp chụp TC 33: Visa Platform Connect: O Kết nối:
cho tất cả các giao Chuỗi (20)

• Ghi: CP01 TCRB dịch tổng hợp với
American Express; nếu FDC

• Vị trí: 5-24 không, không được sử dụng. La bàn:
Chuỗi (13)
• Lĩnh vực: American Express
La bàn FDC: R cho
Số điện thoại người bán FDC
dịch tổng hợp. Nashville
La bàn FDC Toàn cầu:
FDC Nashville Global: R Chuỗi (10)

Giá trị này phải bao gồm các
ký tự viết hoa. Sử dụng một trong các dịch tổng hợp.
định dạng được đề xuất sau: NNN-
NNN-NNNN
NNN-AAAAAAA
người bán phụ_ Một phần mã bưu chính cho ủy quyền Người Mỹ
mã bưu chính địa chỉ của người bán phụ. Thể hiện
Trực tiếp:
American Express

Giá trị này phải bao gồm các dịch tổng hợp. FDC
ký tự viết hoa. La bàn:

FDC
La bàn FDC: O cho Nashville
tất cả các giao Toàn cầu:
dịch tổng hợp. Chuỗi (9)


thợ lặn_ Tiểu bang hoặc tỉnh của thương nhân phụ. ủy quyền Chuỗi (2)
tình trạng Đối với Hoa Kỳ và Canada, hãy sử dụng
mã tiêu chuẩn của tiểu bang, tỉnh American Express

và lãnh thổ. Direct: R cho
La bàn FDC dịch tổng hợp.
Giá trị này phải bao gồm các ký Visa Platform Connect: không
tự viết hoa. được sử dụng.
La bàn FDC: O cho
tất cả các giao dịch

tổng hợp.


thợ lặn_ Dòng đầu tiên của địa chỉ đường phố ủy quyền Người Mỹ
đường phố của người bán phụ. Thể hiện
Trực tiếp:
American Express

Giá trị này phải bao gồm các dịch tổng hợp. FDC
ký tự viết hoa. La bàn:

FDC
La bàn FDC: O cho Nashville
tất cả các giao dịch Toàn cầu:
tổng hợp. Chuỗi (25)

tax_amount Tổng số tiền thuế áp dụng cho Không bắt buộc Số lượng
đơn hàng. Giá trị này không được
âm. Chuỗi (15)

transaction_type Loại giao dịch. Những giá trị khả thi: Yêu cầu của ứng dụng Chấp liệt kê
nhận an toàn. Chuỗi (60)
• ủy quyền
• ủy quyền,tạo_thanh toán cho tôi

nt_token
• ủy quyền,update_payme nt_token
• giảm giá
• tạo_thanh toán_token
• cập nhật_thanh toán_token
Chỉ hỗ trợ ủy quyền và bán hàng cho

các giao dịch Visa Click to Pay.

giao dịch_uuid Người bán duy nhất tạo Yêu cầu của ứng dụng Chấp ASCIIAlpha
định danh. Bao gồm trường nhận an toàn. SốPun
access_key cho mỗi giao dịch. sự dạy dỗ
Số nhận dạng này phải là duy nhất cho
mỗi giao dịch. Chuỗi (50)

Trường này được sử dụng để kiểm
tra các lần thử giao dịch trùng lặp.
Trường phản hồi
Các trường phản hồi được gửi bằng các phương thức thông báo sau:
• Người bán POST URL. Xem "Thông báo của người bán" (ở trang 33).
• Người bán ĐĂNG Email. Xem "Thông báo của người bán" (ở trang 33).
• POST tới URL được chỉ định trong trang Giao dịch hoặc Phản hồi hủy tùy chỉnh. Xem "Trang phản hồi của khách
hàng" (ở trang 36).
Các phương thức thông báo được bật trên các trang Thông báo và Phản hồi của khách hàng trong hồ sơ Chấp nhận an
toàn của bạn.
Để đảm bảo tính toàn vẹn của các trường phản hồi, một chữ ký được bao gồm trong phản hồi. Chữ ký này được tạo bằng
cách sử dụng cùng một giá trị secret_key đã được sử dụng để tạo chữ ký yêu cầu.
Để xác minh rằng các trường phản hồi không bị giả mạo, hãy tạo chữ ký bằng cách sử dụng các trường được liệt kê
trong trường phản hồi Sign_field_names . Chữ ký này phải có cùng giá trị được bao gồm trong trường phản hồi
chữ ký. Tham khảo trang biên nhận có trong tập lệnh mẫu. Xem "Mẫu trong Ngôn ngữ Tập lệnh" (ở trang 68).
Quan trọng: Vì các trường phản hồi và mã lý do có thể được thêm vào bất kỳ lúc nào, hãy tiến hành như sau:
• Phân tích dữ liệu phản hồi theo tên của các trường thay vì thứ tự của chúng trong phản hồi.
Để biết thêm thông tin về phân tích cú pháp các trường phản hồi, hãy xem tài liệu dành cho ngôn
ngữ kịch bản của bạn.
• Chữ ký mà bạn tạo phải có cùng giá trị được bao gồm trong trường phản hồi chữ ký.
• Trình xử lý lỗi của bạn nên sử dụng trường quyết định để xác định kết quả giao dịch nếu nó
nhận được một mã lý do mà nó không nhận ra.
Nếu được định cấu hình, các trường phản hồi này sẽ được gửi trở lại email hoặc URL POST của
Merchant của bạn. Xem "Thông báo của người bán" (ở trang 33). Trình xử lý lỗi của bạn nên sử dụng trường
quyết định để lấy kết quả giao dịch nếu nó nhận được mã lý do mà nó không nhận ra.
Tệp Chụp TC 33 chứa thông tin về các giao dịch mua và tiền hoàn lại mà người bán gửi tới Cybersource.
Visa Platform Connect tạo tệp Chụp TC 33 vào cuối ngày và gửi tệp đó cho người mua của người bán, người
này sẽ sử dụng thông tin này để tạo điều kiện xử lý thanh toán bù trừ cuối ngày với các công ty thẻ thanh
toán.
Trường phản hồi

Cánh đồng Sự miêu tả Loại dữ liệu
& Chiều dài
auth_affluence_indicator Giải pháp Chase Paymentech Đuổi
Thanh toán
Cho biết liệu một khách hàng có hạn mức tín Giải pháp:
dụng cao hay không. Thông tin này cho phép Chuỗi (1)
bạn tiếp thị các mặt hàng giá cao cho những
khách hàng này và hiểu các loại thẻ mà khách Thanh toán thế giới VAP:
hàng có thu nhập cao đang sử dụng. Chuỗi (13)
Trường này được hỗ trợ cho Visa, Mastercard,

Discover và Diners Club.
• Y: Có
• N: Không
• X: Không áp dụng/không xác định
Thanh toán thế giới VAP
Cờ cho biết chủ thẻ Visa hoặc Mastercard thuộc

một trong các nhóm giàu có. Những giá trị khả
thi:
• AFFLUENT: Khách hàng có thu nhập cao với

mức chi tiêu cao (thu nhập hàng năm
>100 nghìn USD và mức sử dụng thẻ hàng
năm >40 nghìn USD).
• THU NHẬP LỚN: Khách hàng có thu nhập cao

(thu nhập hàng năm >100 nghìn USD).
auth_amount Số tiền đã được ủy quyền. Chuỗi (15)
auth_avs_code Mã kết quả AVS. Xem "Mã AVS" (ở trang 234). Chuỗi (1)
auth_avs_code_raw Mã kết quả AVS được gửi trực tiếp từ bộ xử Chuỗi (10)
lý. Chỉ được trả về nếu một giá trị được
trả về bởi bộ xử lý.
Trường phản hồi (tiếp theo)

& Chiều dài
auth_card_commercial Cho biết liệu thẻ có phải là thẻ thương mại hay Chuỗi (1)
không, cho phép bạn đưa dữ liệu Cấp II vào các
yêu cầu giao dịch của mình.
• Y: Có
• N: Không
Trường này được hỗ trợ cho Visa và

Mastercard trên Chase Paymentech
Solutions.
auth_card_healthcare Cho biết thẻ có phải là thẻ chăm sóc sức khỏe hay Chuỗi (1)
không.
• Y: Có
• N: Không

Solutions.
auth_card_issuer_country Quốc gia nơi thẻ được phát hành. Thông tin này Chuỗi (3)
cho phép bạn xác định xem thẻ được phát
hành trong nước hay quốc tế.

Discover, Diners Club, JCB và Maestro (Quốc
tế) trên Chase Paymentech Solutions.

& Chiều dài
auth_card_level_3_đủ điều kiện Cho biết thẻ có đủ điều kiện nhận phí trao đổi Chuỗi (1)
Cấp III hay không, cho phép bạn đưa dữ liệu
Cấp III vào các yêu cầu giao dịch của
mình.
• Y: Có
• N: Không

Solutions.
auth_card_payroll Cho biết thẻ có phải là thẻ trả lương hay không. Chuỗi (1)
• Y: Có
• N: Không
Trường này được hỗ trợ cho Visa, Discover,

Diners Club và JCB trên Chase Paymentech Solutions.

& Chiều dài
auth_card_prepaid Cho biết thẻ có phải là thẻ trả trước hay Chuỗi (1)
không. Thông tin này cho phép bạn xác định
thời điểm xuất trình thẻ quà tặng hoặc thẻ trả
trước để sử dụng khi thiết lập mối quan hệ
thanh toán định kỳ hoặc thanh toán trả góp mới.
• Y: Có
• N: Không

Discover, Diners Club và JCB trên Chase
Paymentech Solutions.
auth_card_regulated Cho biết liệu thẻ có được quy định theo Bản Chuỗi (1)
sửa đổi Durbin hay không. Nếu thẻ được quy định,
tổ chức phát hành thẻ phải tuân theo giới hạn
giá và quy tắc trao đổi.
• Y: Có (tài sản lớn hơn $10 tỷ)
• N: Không (tài sản dưới $10 tỷ)

Discover, Diners Club và JCB trên Chase
Paymentech Solutions.

& Chiều dài
auth_card_signature_debit Cho biết thẻ có phải là thẻ ghi nợ có chữ ký Chuỗi (1)
hay không. Thông tin này cho phép bạn thay đổi
cách xử lý đơn đặt hàng.
• Y: Có
• N: Không
Trường này được hỗ trợ cho Visa, Mastercard và

Maestro (Quốc tế) trên Chase Paymentech
Solutions.
auth_cavv_result Mã phản hồi được ánh xạ cho Visa Secure và Chuỗi (3)
American Express SafeKey:
• Xem Phụ lục C, "Mã phản hồi an

toàn của Visa," ở trang 243(ở trang
242).
• Xem Phụ lục 1, "Mã phản hồi SafeKey của

American Express," ở trang 1 (trang 239).
auth_cavv_result_raw Mã phản hồi thô được gửi trực tiếp từ bộ xử Chuỗi (3)
lý cho Visa Secure và American Express SafeKey.
auth_code Mã ủy quyền. Chỉ được trả về nếu một giá Chuỗi (7)
trị được trả về bởi bộ xử lý.
auth_cv_result Mã kết quả CVN. Xem "Mã CVN" (ở trang 238). Chuỗi (1)
auth_cv_result_raw Mã kết quả CVN được gửi trực tiếp từ bộ xử Chuỗi (10)
lý. Chỉ được trả về nếu một giá trị được
trả về bởi bộ xử lý.
auth_reconciliation_ Số duy nhất mà Cybersource tạo ra để xác định Chuỗi (20)

số_tham_chiếu giao dịch.

& Chiều dài
Thanh toán điện tử Ingenico
Bạn có thể sử dụng giá trị này để xác
định các giao dịch trong Báo cáo thu tiền thanh
toán điện tử của Ingenico, cung cấp thông

tin thanh toán. Liên hệ với bộ phận hỗ trợ khách
hàng để biết thông tin về báo cáo.
auth_response Đối với hầu hết các bộ xử lý, đây là thông Chuỗi (10)
báo lỗi được gửi trực tiếp từ ngân hàng.
Chỉ được trả về nếu một giá trị được trả về bởi bộ
xử lý.
auth_time Thời gian ủy quyền tính theo UTC. Chuỗi (20)

& Chiều dài
auth_trans_ref_no Số tham chiếu mà bạn sử dụng để đối chiếu báo cáo Chữ và Số (60)
giao dịch với báo cáo bộ xử lý của mình.
Đối với các yêu cầu ủy quyền, số tham chiếu giao

dịch chỉ được trả lại cho những bộ xử lý
này:
• American Express Direct
• Cửa ngõ Châu Á, Trung Đông và Châu Phi
• Atos
• BML trực tiếp
• Đuổi theo các giải pháp của Paymentech
• Cielo
• La bàn FDC
• FDC Nashville toàn cầu
• Đồng tiền
• Kết nối Nền tảng Visa
• Thanh toán thế giới VAP
bill_trans_ref_no Số tham chiếu mà bạn sử dụng để đối chiếu báo cáo Chữ và Số (60)
giao dịch với báo cáo bộ xử lý của mình.
Trường này không được hỗ trợ trên Visa Platform

Connect.

& Chiều dài
thẻ_type_name Tên loại thẻ. Chuỗi (50)
Vì lý do bảo mật, trường này chỉ được trả

lại trong URL POST của người bán và thông
báo qua email (không phải trong POST
biên nhận thông qua trình duyệt).
phán quyết Kết quả của yêu cầu của bạn. Những giá trị khả thi: Chuỗi (7)
• CHẤP NHẬN
• TỪ CHỐI
• ĐÁNH GIÁ
• LỖI
• HỦY
Xem "Các loại thông báo" (ở trang 232).
echeck_debit_ref_no Số tham chiếu cho giao dịch. Chữ và Số (60)
echeck_debit_submit_time Thời điểm ghi nợ được yêu cầu tính theo UTC. Ngày và giờ
(20)
tỷ giá Tỷ giá hối đoái nếu xảy ra chuyển đổi tiền Số thập phân (17)
tệ.
17 ký tự bao gồm số thập phân
điểm.
trường_không_hợp_lệ Cho biết trường yêu cầu nào không hợp lệ. Biến đổi
tin nhắn Tin nhắn phản hồi từ cổng thanh toán. Chuỗi (255)
payer_authentication_acs_ Số nhận dạng giao dịch duy nhất được chỉ Chuỗi (36)
giao dịch_id định bởi ACS để xác định một giao dịch.
payer_authentication_cavv Xác minh xác thực chủ thẻ Chuỗi (50)

giá trị (CAVV). Số nhận dạng giao dịch
được tạo bởi ngân hàng phát hành Visa
Click to Pay. Trường này được sử dụng bởi
dịch vụ xác thực xác thực người trả tiền.

& Chiều dài
payer_authentication_ Loại luồng giao dịch 3D Secure đã xảy ra. Những giá Chuỗi (2)
challenge_type trị khả thi:
• CH: Thử thách
• FR: Không ma sát
• FD: Không ma sát với ủy quyền (thử
thách không phải do tổ chức phát hành
tạo ra mà do chương trình thay mặt tổ chức
phát hành tạo ra).
Được sử dụng cho các giao dịch Cartes Bancaires.
payer_authentication_eci Chỉ số thương mại điện tử (ECI). Chuỗi (3)
Trường này được sử dụng bởi các dịch vụ đăng ký

và xác thực xác thực người trả tiền.
Các giá trị có thể có đối với Visa, American Express
và JCB:
• 05: Xác thực thành công.
• 06: Đã thử xác thực.
• 07: Xác thực thất bại.
Các giá trị có thể có cho Mastercard:
• 01: Thương nhân chịu trách nhiệm.
• 02: Tổ chức phát hành thẻ chịu trách nhiệm.
& Chiều dài
payer_authentication_enroll_ Chỉ số thương mại cho thẻ không đăng ký. Chuỗi (255)
e_commerce_indicator Những giá trị khả thi:
• internet: Thẻ chưa đăng ký hoặc
loại thẻ không được xác thực người trả tiền
hỗ trợ. Không có thay đổi trách nhiệm pháp lý.
• js_attempted: Thẻ JCB chưa được đăng ký,
nhưng nỗ lực xác thực được ghi lại.
Thay đổi trách nhiệm pháp lý.
• js_failure: Dịch vụ thư mục J/Secure
không khả dụng. Không có thay đổi trách nhiệm

pháp lý.
•
spa: Thẻ Mastercard chưa được đăng ký trong
chương trình Kiểm tra danh tính. Không có thay
đổi trách nhiệm pháp lý.
• vbv_attempted: Thẻ Visa chưa được đăng ký,
nhưng nỗ lực xác thực được ghi lại.
• vbv_failure: Đối với bộ xử lý thanh toán
Barclays, Streamline, AIBMS hoặc FDC Germany,
bạn nhận được kết quả này nếu dịch vụ
thư mục của Visa không khả dụng. Không
có thay đổi trách nhiệm pháp lý.

& Chiều dài
payer_authentication_enroll_ Kết quả kiểm tra tuyển sinh. Những giá trị khả thi: Chuỗi (255)
veres_enrolled
• Y: Thẻ đã đăng ký hoặc có thể đăng ký; bạn
phải xác thực. Thay đổi trách nhiệm pháp lý.
• N: Thẻ chưa đăng ký; tiến hành ủy quyền.
• U: Không thể xác thực bất kể lý do gì. Không
có thay đổi trách nhiệm pháp lý.
Trường này chỉ áp dụng cho Cổng Châu Á,
Trung Đông và Châu Phi. Nếu bạn được định cấu
hình cho bộ xử lý này, thì bạn phải gửi giá trị
của trường này trong yêu cầu ủy quyền của mình.
Giá trị này có thể được trả lại nếu bạn đang sử dụng
xác thực người thanh toán dựa trên quy tắc:
• B: Cho biết xác thực đã bị bỏ qua.
Để biết thông tin xác thực người thanh toán
dựa trên quy tắc, hãy xem Xác thực người thanh toán
bằng API SCMP (PDF| HTML) hoặc Xác thực người thanh
toán bằng API đặt hàng đơn giản (PDF| HTML).
payer_authentication_ Điểm số toàn cầu được tính toán bởi nền tảng tính Số nguyên (2)
network_score điểm Cartes Bancaires và được trả lại cho người bán.

& Chiều dài
payer_authentication_pares_ Kết quả thô của kiểm tra xác thực. Chuỗi (255)
trạng thái Những giá trị khả thi:
• A: Bằng chứng về nỗ lực xác thực đã
được tạo.
• N: Khách hàng thất bại hoặc hủy bỏ
xác thực. Giao dịch đã bị từ chối.
• U: Xác thực không hoàn thành bất kể
lý do gì.
• Y: Khách hàng được xác thực thành

công.
payer_authentication_pares_ Cung cấp thông tin bổ sung về giá trị trạng thái PARes. Số nguyên (2)
status_reason
payer_authentication_pares_ dấu Dấu thời gian được giải mã cho kết quả Sợi dây
thời gian xác thực người trả tiền. Visa Click to Pay
tạo ra giá trị này. Định dạng: Thời gian Unix,

còn được gọi là thời gian kỷ nguyên.

& Chiều dài
payer_authentication_proof_ xml Phần tử XML chứa bằng chứng xác minh Chuỗi (1024)
đăng ký.
Đối với các thẻ không được phát hành ở Hoa Kỳ
hoặc Canada, ngân hàng của bạn có thể yêu cầu
dữ liệu này làm bằng chứng xác minh đăng ký
cho bất kỳ giao dịch xác thực người thanh
toán nào mà bạn gửi lại do khoản bồi hoàn.
Đối với thẻ được phát hành ở Hoa Kỳ hoặc Canada,
Visa có thể yêu cầu dữ liệu này cho các mã danh
mục người bán cụ thể.
Trường này được mã hóa HTML.
Trường này không được trả lại cho 3D Secure 2.0
giao dịch.
payer_authentication_ Giá trị số tương ứng với kết quả của yêu cầu xác Chuỗi (5)
reason_code thực người trả tiền.
Xem "Mã lý do" (ở trang 227).
payer_authentication_ Trường này chứa phiên bản 3D Secure đã được sử Chuỗi (20)
Specification_version dụng để xử lý giao dịch.
Ví dụ: 1.0.2 hoặc 2.0.0.
payer_authentication_ giao Số nhận dạng giao dịch xác thực người Chuỗi (20)
dịch_id thanh toán được sử dụng bởi Chấp nhận an toàn
để liên kết kiểm tra đăng ký và xác thực
thông báo xác thực.

& Chiều dài
payer_authentication_type Cho biết loại xác thực được sử dụng để thách thức Số nguyên (2)
chủ thẻ.
• 01: Tĩnh
• 02: Năng động
• 03: OOB (Hết băng tần)
payer_authentication_uad Mastercard Identity Kiểm tra dữ liệu Chuỗi (32)
xác thực UCAF. Chỉ được trả lại cho các giao
dịch Kiểm tra danh tính Mastercard.
payer_authentication_uci Mastercard Identity Check chỉ báo bộ sưu tập UCAF. Chuỗi (1)
Trường này cho biết liệu dữ liệu xác thực
có được thu thập tại trang web của bạn hay

không. Những giá trị khả thi:
• 0: Dữ liệu xác thực không được
thu thập và xác thực khách hàng
chưa hoàn thành.
• 1: Dữ liệu xác thực không được thu
thập vì xác thực khách hàng chưa
hoàn thành.
• 2: Dữ liệu xác thực đã được thu thập.
Khách hàng hoàn thành xác thực.

& Chiều dài
payer_authentication_ Chỉ số phân biệt các giao dịch Internet Chuỗi (255)
validate_e_commerce_ chỉ với các loại khác. Xác thực không thành
báo công nếu trường này không được trả lại.
Đối với Visa, nếu bộ xử lý thanh toán

của bạn là Streamline, Barclays, AIBMS hoặc
FDC Đức, thì bạn sẽ nhận được giá trị
vbv_failure thay vì internet khi không có
payer_authentication_eci .
Giá trị của trường này được tự

động chuyển đến dịch vụ ủy quyền nếu bạn yêu cầu
các dịch vụ cùng nhau. Những giá trị khả thi:
• aesk: Xác thực American Express

SafeKey đã xác minh thành công.
• aesk_attempted: Thẻ chưa được đăng
ký trong American Express SafeKey

nhưng nỗ lực xác thực đã được ghi
lại.
• internet: Xác thực không được xác
minh thành công.
• js: xác thực J/Secure thành công.
• js_attempted: Thẻ JCB chưa được đăng

ký trong J/Secure, nhưng nỗ lực
xác thực đã được ghi lại.
•
spa: xác thực Mastercard Identity
Check đã xác minh thành công.
• spa_failure: Kiểm tra danh tính

Mastercard xác thực không thành công.
• vbv: xác thực Visa Secure đã xác
minh thành công.
• vbv_attempted: Thẻ chưa đăng ký

Visa Secure, nhưng nỗ lực xác thực
đã được ghi lại.
• vbv_failure: Bảo mật Visa

xác thực không khả dụng.

& Chiều dài
payer_authentication_ Dữ liệu xác thực thô đến từ ngân hàng phát Chuỗi (255)
validate_result hành thẻ cho biết liệu xác thực có thành công
hay không và liệu có xảy ra thay đổi trách nhiệm
pháp lý hay không. Những giá trị khả thi:
• -1: PAR không hợp lệ.
• 0: Xác nhận thành công.
• 1: Chủ thẻ không tham gia nhưng nỗ lực

xác thực đã được ghi lại.
• 6: Tổ chức phát hành không thể thực hiện
xác thực.
• 9: Chủ thẻ chưa hoàn tất việc xác

thực.
payer_authentication_veres_ dấu Dấu thời gian được giải mã cho phản hồi xác Sợi dây
thời gian minh. Visa Click to Pay tạo ra giá trị này. Định
dạng: Thời gian Unix, còn được gọi là thời
gian kỷ nguyên.

& Chiều dài
payer_authentication_white_ list_status Cho phép liên lạc về người thụ hưởng đáng tin Chuỗi (1)
cậy và trạng thái danh sách trắng giữa ACS, máy
chủ thư mục và người yêu cầu Bảo mật 3D.
• Y: Người yêu cầu 3D Secure được chủ thẻ đưa
vào danh sách cho phép
• N: Người yêu cầu 3D Secure không
được chủ thẻ đưa vào danh sách trắng
payer_authentication_white_ Trường này được điền bởi trạng thái danh sách Số nguyên (2)
list_status_source cho phép cài đặt hệ thống.
• 01: Máy chủ bảo mật 3D
• 02: Máy chủ thư mục
• 03: ACS
payer_authentication_xid Mã định danh giao dịch được tạo bởi xác thực người Chuỗi (28)
trả tiền. Được sử dụng để đối sánh yêu cầu xác thực
người thanh toán gửi đi với phản hồi xác thực
người thanh toán gửi đến.
payment_account_reference Số tham chiếu đóng vai trò là liên kết tới tài khoản chủ Chuỗi (32)
thẻ và tới tất cả các giao dịch cho tài khoản
đó. Giá trị giống nhau được trả về cho dù tài
khoản được đại diện bởi PAN hay mã thông báo mạng.

& Chiều dài
thanh toán_solution Loại mã thông báo mạng thanh toán credential-on-file Chuỗi (3)
(COF). Được trả lại trong các ủy quyền sử dụng mã thông
báo mạng thanh toán được liên kết với mã thông

báo TMS.
• 014: Thẻ Mastercard
• 015: Thị thực
• 016: American Express

& Chiều dài
thanh toán_token Mã định danh cho các chi tiết thanh toán. Chuỗi (32)
Mã thông báo thanh toán truy xuất dữ liệu
thẻ, thông tin thanh toán và thông tin vận
chuyển từ kho lưu trữ thanh toán.
Mã thông báo thanh toán này thay thế mã
thông báo thanh toán trước đó và được trả lại nếu:
• Người bán được định cấu hình cho mã
thông báo thanh toán gồm 16 chữ số hiển thị
bốn chữ số cuối của số tài khoản chính
(PAN) và vượt qua kiểm tra Luhn mod-10.
Xem "Mã thông báo thanh toán" (ở trang 16).
• Khách hàng đã cập nhật số thẻ trên mã
thông báo thanh toán của họ.
Mã thông báo thanh toán này thay thế mã
thông báo thanh toán trước đó và sẽ được
sử dụng cho các giao dịch tiếp theo.
Bạn phải đang sử dụng Dịch vụ quản lý mã thông

báo.
thanh toán_token_mới nhất_thẻ_ Ngày hết hạn của thẻ gần nhất được cấp cho Ngày (a) (7)
ngày hết hạn chủ thẻ.
Được trả lại khi Mã thông báo mạng được bật và
một payment_token có Mã thông báo mạng được

liên kết được sử dụng trong một giao dịch. Mã
thông báo mạng có thể tiếp tục được sử dụng ngay
cả khi thẻ ban đầu đã hết hạn.
Định dạng: MM-yyyy

& Chiều dài
thanh toán_token_latest_card_ hậu Bốn số cuối của thẻ gần nhất được cấp cho chủ Chuỗi (4)
tố thẻ.
Được trả lại khi Mã thông báo mạng được bật
và một payment_token có Mã thông báo mạng

được liên kết được sử dụng trong một giao
dịch. Mã thông báo mạng có thể tiếp tục
được sử dụng ngay cả khi số thẻ ban đầu đã
thay đổi do thẻ mới được phát hành. Sử dụng
bốn chữ số cuối trong tin nhắn xác nhận thanh
toán cho chủ thẻ, ví dụ: "Cảm ơn bạn đã
thanh toán bằng thẻ Visa có đuôi
[payment_token_latest_card_suffix]".
paypal_address_status Trạng thái của địa chỉ đường phố trong hồ sơ với Chuỗi (12)
PayPal. Những giá trị khả thi:
• Không có
• Đã xác nhận
• Chưa xác nhận
paypal_ủy quyền_ tương Số nhận dạng PayPal được sử dụng để điều tra bất Chuỗi (20)
quan_id kỳ vấn đề nào.
paypal_authorization_ giao Mã định danh duy nhất cho giao dịch. Chuỗi (17)
dịch_id
paypal_customer_email Địa chỉ email của khách hàng như đã nhập khi Chuỗi (127)
thanh toán. PayPal sử dụng giá trị này để điền
trước phần đăng ký thành viên PayPal trên trang
đăng nhập PayPal.
paypal_do_capture_ Số nhận dạng PayPal được sử dụng để điều tra bất Chuỗi (20)
tương quan_id kỳ vấn đề nào.
paypal_do_capture_ giao Mã định danh duy nhất cho giao dịch. Chuỗi (17)
dịch_id
paypal_ec_get_details_ Số nhận dạng PayPal được sử dụng để điều tra bất Chuỗi (20)
tương quan_id kỳ vấn đề nào.

& Chiều dài
paypal_ec_get_details_ Giá trị của ID yêu cầu được trả về từ yêu cầu Chuỗi (26)
request_id dịch vụ nhận thông tin chi tiết của PayPal.
paypal_ec_get_details_ giao Mã định danh duy nhất cho giao dịch. Chuỗi (17)
dịch_id
paypal_ec_order_setup_ Số nhận dạng PayPal được sử dụng để điều tra bất kỳ Chuỗi (20)
tương quan_id vấn đề nào.
paypal_ec_order_setup_ giao Mã định danh duy nhất cho giao dịch. Chuỗi (17)
dịch_id
paypal_ec_set_request_id Giá trị của ID yêu cầu được trả về từ yêu cầu Chuỗi (26)
dịch vụ do PayPal đặt.
paypal_fee_amount Phí PayPal được tính cho giao dịch. Giá trị này Chuỗi (9)
không vượt quá mức tương đương 10.000 USD
bằng bất kỳ loại tiền tệ nào và không bao gồm ký
hiệu tiền tệ. Dấu tách thập phân là dấu chấm (.)
và dấu phân cách hàng nghìn tùy chọn là dấu phẩy
(,).
paypal_order_request_id Giá trị của ID yêu cầu được trả về từ yêu cầu Chuỗi (26)
dịch vụ thiết lập đơn đặt hàng PayPal.
paypal_payer_id Số nhận dạng tài khoản PayPal của khách hàng. chữ và số
Chuỗi (13)
paypal_payer_status trạng thái của khách hàng. Những giá trị khả thi: Chuỗi (10)
• đã xác minh
• chưa được xác minh
paypal_pending_reason Cho biết lý do thanh toán đang chờ xử lý. Chuỗi (14)
• địa chỉ: Khách hàng của bạn không bao
gồm địa chỉ giao hàng đã được xác
nhận và tùy chọn Nhận thanh toán của bạn được
đặt để chấp nhận hoặc từ chối các
khoản thanh toán đó theo cách thủ công.
Để thay đổi tùy chọn của bạn, hãy chuyển
đến phần Tùy chọn trong hồ sơ PayPal của
bạn.

& Chiều dài
• ủy quyền: Khoản thanh toán đã được ủy quyền nhưng
chưa được giải quyết. Nắm bắt số tiền được ủy

quyền.
• séc điện tử: Thanh toán được thực hiện bằng
séc điện tử chưa được thanh toán.
• quốc tế: Bạn có tài khoản không phải của Hoa
Kỳ và không có cơ chế rút tiền.
Bạn phải chấp nhận hoặc từ chối khoản thanh toán
này theo cách thủ công trong Tổng quan về tài khoản
PayPal của mình.
• đa tiền tệ: Bạn không có số dư bằng loại tiền
được gửi và tùy chọn Nhận thanh toán của bạn
không được đặt để tự động chuyển đổi và chấp nhận
khoản thanh toán này. Bạn phải chấp nhận hoặc từ
chối khoản thanh toán này theo cách thủ
công trong Tổng quan về tài khoản PayPal của
mình.
• none: Không có lý do chờ xử lý.
• đặt hàng: Việc thanh toán là một phần của một

lệnh đã được ủy quyền nhưng chưa được
giải quyết.
• xét duyệt thanh toán: Khoản thanh toán đang được
PayPal xem xét về khả năng gian lận.
• đơn phương: Khoản thanh toán được thực hiện

tới một địa chỉ email chưa được đăng ký
hoặc xác nhận.
• xác minh: Tài khoản của bạn chưa được xác
minh. Bạn phải xác minh tài khoản của
mình trước khi có thể chấp nhận khoản thanh
toán này.
paypal_pending_status Tình trạng của giao dịch. Những giá trị khả thi: Chuỗi (20)
• Hủy-Đảo ngược: PayPal đã hủy đảo ngược, điều này
xảy ra khi bạn thắng một tranh chấp và số tiền
cho việc đảo ngược được trả lại cho bạn.

& Chiều dài
• Đã hoàn thành: PayPal đã hoàn tất thanh
toán và thêm tiền vào tài khoản của bạn

tài khoản.
• Bị từ chối: Bạn đã từ chối một khoản thanh toán,
điều này chỉ xảy ra nếu khoản thanh toán
đang chờ xử lý vì lý do được nêu trong
trường reason_code .
• Expired: Hết hạn ủy quyền.
• Không thành công: Thanh toán không thành
công. Sự kiện này chỉ có thể xảy ra
khi thanh toán được thực hiện từ tài

khoản ngân hàng của khách hàng của bạn.
• Đang tiến hành: Giao dịch chưa hoàn tất.
• Không có: Không có trạng thái.
• Đã hoàn trả một phần: Khoản thanh toán đã
được hoàn trả một phần.
• Đang chờ xử lý: Khoản thanh toán đang chờ

xử lý vì lý do được nêu trong trường
paypal_pending_reason .
• Đã xử lý: PayPal đã chấp nhận thanh toán.
• Mã lý do
• Refunded: Bạn đã hoàn trả khoản thanh toán.
• Đã đảo ngược: PayPal đã đảo ngược
khoản thanh toán vì lý do được chỉ định trong
trường reason_code . Tiền đã được chuyển
từ tài khoản của bạn sang tài khoản của khách

hàng.
• Vô hiệu: Ủy quyền bị vô hiệu

& Chiều dài
paypal_protection_eligibility Bảo vệ người bán có hiệu lực đối với giao Chuỗi (17)
dịch. Những giá trị khả thi:
• Đủ điều kiện: Bạn được bảo vệ bởi Chính
sách bảo vệ người bán của PayPal đối với
thanh toán trái phép và không nhận được

hàng.
• Đủ điều kiện một phần: Bạn được bảo vệ bởi
Chính sách bảo vệ người bán của PayPal đối

với mặt hàng không nhận được.
• Không đủ điều kiện: Bạn không được bảo
vệ theo Chính sách bảo vệ người bán của
PayPal.

& Chiều dài
paypal_protection_ đủ Bảo vệ người bán có hiệu lực đối với Chuỗi (32)
điều kiện_type giao dịch. Những giá trị khả thi:
• Đủ điều kiện: Bạn được bảo vệ bởi Chính
sách bảo vệ người bán của PayPal đối với
thanh toán trái phép và không nhận được hàng.
• Mặt hàng không nhận đủ điều kiện: Bạn
được bảo vệ bởi Chính sách bảo vệ
người bán của PayPal đối với mặt

hàng không nhận được.
• UnauthorizedPaymentEquality: Bạn được bảo
vệ bởi Chính sách bảo vệ người bán của
PayPal đối với thanh toán trái phép.
• Không đủ điều kiện: Bạn không được bảo
vệ theo Chính sách bảo vệ người bán của
PayPal.
Để bật trường
paypal_protection_eligibility_type , hãy liên hệ với
bộ phận hỗ trợ khách hàng để định cấu hình tài
khoản của bạn cho tính năng này.
paypal_request_id Mã định danh cho yêu cầu do khách hàng tạo ra. Chuỗi (26)

& Chiều dài
paypal_token Mã thông báo PayPal được đánh dấu thời gian Chuỗi (20)
xác định rằng PayPal Express Checkout đang xử lý
giao dịch. Lưu giá trị này để gửi các tin nhắn
yêu cầu trong tương lai.
paypal_transaction_type Cho biết loại giao dịch PayPal. Chuỗi (16)
Giá trị có thể có: expresscheckout
nguyên mã Giá trị số tương ứng với kết quả yêu cầu giao Chuỗi (5)
dịch thẻ thanh toán.
Xem "Mã lý do" (ở trang 227).
req_access_key Xác thực người bán với ứng dụng. Chuỗi (32)

& Chiều dài
req_aggregator_id Giá trị xác định bạn là người tổng hợp Chuỗi (Xem
thanh toán. Lấy giá trị này cho bộ xử lý. mô tả)
Giá trị cho trường này tương ứng với dữ liệu

này trong tệp chụp TC 33:
• Vị trí: 95-105
• Lĩnh vực: Hỗ trợ Thanh toán Mastercard

NHẬN DẠNG
Độ dài trường
American Express Direct: 20
La bàn FDC
Giá trị này phải bao gồm các ký tự viết

hoa.
Kết nối nền tảng Visa: 11
La bàn FDC: 20
FDC Nashville toàn cầu: 15
Bắt buộc/Tùy chọn
American Express Direct: R cho tất cả các
công cụ tổng hợp
giao dịch.
Visa Platform Connect: R đối với ủy quyền bộ
tổng hợp Mastercard; nếu không, không được sử

dụng.
La bàn FDC: R cho tất cả các giao dịch

tổng hợp.
FDC Nashville Toàn cầu: R cho tất cả các công cụ tổng hợp Chấp nhận an
toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Các trường API tích hợp thanh toán được lưu trữ trên máy chủ| 201 giao dịch.

& Chiều dài
req_allow_payment_token_ cập Cho biết liệu khách hàng có thể cập nhật Chuỗi (5)
nhật thông tin lập hóa đơn, giao hàng và thanh toán
trên trang đánh giá đơn hàng hay không.
• true: Khách hàng có thể cập nhật thông tin chi tiết.
• false: Khách hàng không thể cập nhật thông
tin chi tiết.
req_amount Tổng số tiền cho đơn đặt hàng. Phải lớn hơn hoặc Chuỗi (15)
bằng 0.
req_auth_indicator Cờ xác định mục đích của ủy quyền. Những Chuỗi (1)
• 0: Ủy quyền trước
• 1: Ủy quyền cuối cùng
Mastercard yêu cầu người bán ở Châu Âu cho

biết ủy quyền là ủy quyền cuối cùng hay ủy
quyền trước.
Để đặt mặc định cho trường này, hãy liên hệ với
bộ phận hỗ trợ khách hàng.

& Chiều dài
req_auth_type Loại ủy quyền. Những giá trị khả thi: Cielo,

thương mại
• AUTOCAPTURE: Chụp tự động. người Latinh và
nguồn mạng
• STANDARDCAPTURE: Chụp chuẩn. Người Mỹ La-tinh
Xử lý:
• bằng lời nói: Bắt giữ cưỡng chế.
Chuỗi (15)
Cửa ngõ Châu Á, Trung Đông và Châu Phi; Tất cả khác
Cielo; Comercio Latino; và nguồn điện tử bộ vi xử lý:

chế biến Mỹ Latinh Chuỗi (11)
Đặt trường này thành AUTOCAPTURE và đưa trường này
vào yêu cầu được nhóm để cho biết rằng bạn đang
yêu cầu chụp tự động. Nếu tài khoản của bạn
được định cấu hình để bật tính năng chụp tự động,
hãy đặt trường này thành CHỤP CHỤP TIÊU CHUẨN

và đưa trường này vào ủy quyền tiêu chuẩn hoặc
yêu cầu theo nhóm để cho biết rằng bạn đang ghi đè
tính năng chụp tự động.
cưỡng bức bắt giữ
Đặt trường này thành lời nói và đưa nó vào yêu
cầu ủy quyền để cho biết rằng bạn đang thực hiện
bắt buộc; do đó, bạn nhận được mã ủy quyền bên
ngoài hệ thống xử lý giao dịch.
Ủy quyền bằng lời nói
Đặt trường này thành bằng lời nói và đưa trường
này vào yêu cầu chụp để cho biết rằng yêu cầu này
dành cho ủy quyền bằng lời nói.

& Chiều dài
req_bill_payment Cờ cho biết khoản thanh toán cho hóa đơn Chuỗi (1)
hoặc cho khoản vay theo hợp đồng hiện có. Visa
cung cấp chương trình Thanh toán hóa đơn

cho phép khách hàng sử dụng thẻ Visa để thanh toán
hóa đơn. Những giá trị khả thi:
• true: Thanh toán hóa đơn hoặc thanh toán khoản vay.
• sai (mặc định): Không phải thanh toán hóa đơn hoặc
thanh toán khoản vay.
req_bill_to_address_city Thành phố trong địa chỉ thanh toán. Chuỗi (50)
Visa Nhấp để
Trả: Chuỗi
(100)
req_bill_to_address_country Mã quốc gia ISO cho địa chỉ thanh toán. Chuỗi (2)
req_bill_to_address_line1 Dòng đầu tiên của địa chỉ đường phố trong địa chỉ Chuỗi (60)
thanh toán.
Visa Nhấp để
Trả: Chuỗi
(100)
req_bill_to_address_line2 Dòng thứ hai của địa chỉ đường phố trong địa Chuỗi (60)
chỉ thanh toán.

Visa Nhấp để
Trả: Chuỗi
(100)
req_bill_to_address_postal_ code Mã bưu chính cho địa chỉ thanh toán. Chuỗi (10)
Trường này được trả lại Visa Nhấp để
nếu bill_to_address_country là Hoa Kỳ hoặc Canada. Trả: Chuỗi
(100)
req_bill_to_address_state Tiểu bang hoặc tỉnh trong địa chỉ thanh toán. Mã Chuỗi (2)
tỉnh và bang ISO gồm hai ký tự.
Trường này được trả về cho Hoa Kỳ và Canada.

& Chiều dài
req_bill_to_company_name Tên công ty của khách hàng. Chuỗi (40)
req_bill_to_email Địa chỉ email của khách hàng. Chuỗi (255)
Visa Nhấp để
Trả: Chuỗi
(256)
req_bill_to_forename Tên khách hàng. Chuỗi (60)
Visa Nhấp để
Trả: Chuỗi
(256)
req_bill_to_phone Số điện thoại của khách hàng. Chuỗi (15)
Visa Nhấp để
Trả: Chuỗi
(30)
req_bill_to_surname Họ của khách hàng. Chuỗi (60)
Visa Nhấp để
Trả: Chuỗi
(265)

& Chiều dài
req_card_account_type Cờ chỉ định loại tài khoản được liên kết Chuỗi (2)
với thẻ. Chủ thẻ cung cấp thông tin này trong
quá trình thanh toán.
Cielo và Comercio Latino
• CR: Thẻ tín dụng
• DB: Thẻ ghi nợ
• CH: Tài khoản séc
• CR: Tài khoản thẻ tín dụng
• SA: Tài khoản tiết kiệm
Trường này được trả về cho:
• Giao dịch ghi nợ trên Cielo và
Thương mại Latino.
• Giao dịch bằng thẻ do Brazil phát hành
trên Visa Platform Connect.
Thẻ kết hợp ở Brazil có chức năng tín dụng và
ghi nợ trong một thẻ. Hệ thống Visa sử dụng số
nhận dạng ngân hàng (BIN) cho loại thẻ này. Việc
sử dụng BIN để xác định xem thẻ là thẻ ghi nợ hay

thẻ tín dụng có thể khiến giao dịch với các thẻ này
bị xử lý không chính xác. Chúng tôi thực sự
khuyên bạn nên bao gồm trường này cho các giao
dịch thẻ kết hợp.
req_card_expiry_date Ngay hêt ha n the . Chuỗi (7)
req_card_number Số thẻ. Chuỗi (20)
& Chiều dài
req_card_type Loại thẻ. Chuỗi (3)
req_company_tax_id mã số thuế của công ty. Bốn chữ số cuối cùng không Chuỗi (9)
được che.
req_complete_route Nối các chặng du lịch riêng lẻ theo định dạng: Chuỗi (255)
SFO-JFK:JFK-LHR:LHR-CDG.
Để biết danh sách đầy đủ các mã sân bay, hãy
xem Danh mục mã thành phố của IATA.
Trong yêu cầu của bạn, hãy gửi trường tuyến
đường đầy đủ hoặc các chặng riêng lẻ
(hành trình_ chặng#_xuất phát và hành
trình_ chặng#_điểm). Nếu bạn gửi tất cả các

trường, thì giá trị của Complete_route sẽ được ưu
tiên hơn giá trị của các trường Journey_leg# .
req_consumer_id Định danh cho tài khoản khách hàng. Giá trị này Chuỗi (100)
được xác định khi tạo mã thông báo khách hàng.
req_currency Đơn vị tiền tệ được sử dụng cho đơn đặt hàng. Chuỗi (3)
Xem mã tiền tệ ISO .
req_customer_cookies_ đã Cho biết trình duyệt của khách hàng có chấp nhận Chuỗi (5)
được chấp nhận cookie hay không. Những giá trị khả thi:
• true: Trình duyệt của khách hàng chấp

nhận cookie.
• false: Trình duyệt của khách hàng không
chấp nhận cookie.

& Chiều dài
req_customer_gift_wrap Cho biết liệu khách hàng có yêu cầu gói quà cho giao Chuỗi (5)
dịch mua này hay không. Những giá trị khả thi:
• đúng: Khách hàng yêu cầu gói quà.
• sai: Khách hàng không yêu cầu gói quà.
req_customer_ip_address Địa chỉ IP của khách hàng được báo cáo bởi máy chủ web
của bạn bằng cách sử dụng thông tin ổ cắm.
req_date_of_birth Ngày tháng năm sinh của khách hàng. Chuỗi (8)
Định dạng: yyyyMMDD.
req_debt_indicator Cờ cho biết khoản thanh toán cho khoản vay Chuỗi (5)
theo hợp đồng hiện có theo chương trình Trả nợ
VISA. Liên hệ với bộ xử lý của bạn để biết chi
tiết và yêu cầu.

Các định dạng có thể:
• false (mặc định): Không phải khoản thanh toán khoản vay
• true: Thanh toán tiền vay

& Chiều dài
req_departure_time Ngày và giờ khởi hành của chặng đầu tiên của chuyến Chuỗi (29)
đi. Sử dụng một trong các định dạng sau:
• yyyy-MM-dd HH:mm z
• yyyy-MM-dd hh:mm az
• yyyy-MM-dd hh:mma z
• HH = định dạng 24 giờ
• hh = định dạng 12 giờ
• a = sáng hoặc chiều (không phân biệt chữ hoa chữ thường)
• z = múi giờ của chuyến bay khởi hành.
req_device_fingerprint_id Trường chứa ID phiên cho dấu vân tay. Chuỗi (88)
Chuỗi có thể chứa chữ hoa và chữ thường,
chữ số và các ký tự đặc biệt sau: dấu gạch nối
(-) và dấu gạch dưới (_).
Tuy nhiên, không sử dụng cùng một chữ hoa và

chữ thường để biểu thị các ID phiên khác nhau.
ID phiên phải là duy nhất cho mỗi ID người

bán. Bạn có thể sử dụng bất kỳ chuỗi nào bạn
đang tạo, chẳng hạn như số đơn đặt hàng
hoặc ID phiên web.
req_driver_license_number Số giấy phép lái xe của khách hàng. Chuỗi (30)

Bốn chữ số cuối không được che.
req_driver_license_state Bang hoặc tỉnh nơi cấp giấy phép lái Chuỗi (2)
xe của khách hàng.

& Chiều dài
req_e_commerce_indicator Chỉ báo thương mại cho giao dịch Chuỗi (13)
kiểu.
Giá trị: cài đặt
Trường này chỉ được trả lại cho các khoản thanh
toán trả góp trên Cybersource Mỹ Latinh.
req_echeck_account_number Số tài khoản. Con số này được che dấu. Số nguyên không âm (17)
req_echeck_account_type Kiểu tài khoản. Những giá trị khả thi: Chuỗi (1)
• C: Đang kiểm tra
• S: Tiết kiệm (chỉ USD)
• X: Kiểm tra doanh nghiệp (chỉ USD)
req_echeck_check_number Số kiểm tra. Số nguyên (8)
req_echeck_effect_date Ngày có hiệu lực của giao dịch. Ngày (b)
Chuỗi (8)
req_echeck_routing_number Số định tuyến ngân hàng. Nó cũng được gọi là Số nguyên không
Mã số chuyển tiếp. âm (9)
req_echeck_sec_code Phương thức ủy quyền cho giao dịch. Chuỗi (3)

• CCĐ
• PPD
• ĐT
• TRANG WEB

& Chiều dài
req_ignore_avs Bỏ qua kết quả xác minh AVS. Chuỗi (5)

• đúng
• sai
req_ignore_cvn Bỏ qua kết quả xác minh CVN. Chuỗi (5)

• đúng
• sai
req_installment_total_ Tổng số tiền của khoản vay đang được trả dần. Số tiền (12)
số lượng
Trường này chỉ được trả lại cho các khoản

thanh toán trả góp trên Cybersource Latin
American Processing hoặc Visa Platform Connect.
req_installment_total_count Tổng số lần thanh toán trả góp như một phần số
của ủy quyền.
Chuỗi (2)
Các giá trị có thể: 1 đến 99
Trường này chỉ được trả lại cho các khoản

thanh toán trả góp trên Cybersource Mỹ Latinh.
req_issuer_additional_data Dữ liệu do tổ chức phát hành xác định. chữ và số
Xem phần “Dữ liệu tùy ý” trong Dịch vụ Chuỗi (256)

thẻ tín dụng Tính năng tùy chọn Bổ sung
API SCMP hoặc Dịch vụ thẻ tín dụng Các
tính năng tùy chọn Bổ sung API đặt hàng đơn
giản.
req_item__#_code Loại sản phẩm. # có thể nằm trong khoảng từ 0 đến 199. Chuỗi (255)

& Chiều dài
req_item_#_description Mô tả của mặt hàng. # có thể nằm trong khoảng từ 0 Chuỗi (255)
đến 199.
req_item__#_name Tên mặt hàng. # có thể nằm trong khoảng từ 0 đến 199. Chuỗi (255)
req_item_#_passenger_email Địa chỉ email của hành khách. Chuỗi (255)
req_item_#_passenger_ tên Tên hành khách. Chuỗi (60)
req_item_#_passenger_id ID của hành khách mà vé đã được phát hành. Ví Chuỗi (32)

dụ: bạn có thể sử dụng trường này cho số hành
khách thường xuyên.
req_item_#_passenger_ phone Số điện thoại của hành khách. Nếu đơn đặt hàng Chuỗi (15)
từ bên ngoài Hoa Kỳ, bạn nên bao gồm mã quốc
gia.
req_item_#_passenger_ Phân loại hành khách của công ty bạn, chẳng Chuỗi (32)
trạng thái hạn như phân loại hành khách thường xuyên.
Trong trường hợp này, bạn có thể sử dụng các giá trị
như tiêu chuẩn, vàng hoặc bạch kim.
req_item_#_passenger_ Họ của hành khách. Chuỗi (60)

họ
req_item_#_passenger_type Phân loại hành khách liên quan đến giá vé. Những giá trị Chuỗi (32)
khả thi:
• ADT: Người lớn
• CNN: Con
• INF: Trẻ sơ sinh
• YTH: Tuổi trẻ
• STU: Sinh viên
• SCR: Người cao tuổi
• SỮA: Quân đội
req_item_#_quantity Số lượng mục hàng. # có thể nằm trong khoảng từ 0 đến Chuỗi (10)
199.

& Chiều dài
req_item_#_sku Mã nhận dạng cho sản phẩm. # có thể nằm trong Chuỗi (255)
khoảng từ 0 đến 199.
req_item_#_tax_amount Số tiền thuế áp dụng cho mục hàng. # có thể Chuỗi (15)
nằm trong khoảng từ 0 đến 199. Giá trị này không
được âm. Số tiền thuế và số tiền ưu đãi phải
bằng cùng một loại tiền tệ.
req_item__#_unit_price Giá của mục hàng. # có thể nằm trong khoảng từ 0 Chuỗi (15)
đến 199. Giá trị này không được âm.
req_journey_leg#_dest Mã sân bay cho điểm xuất phát của chặng hành Chuỗi (3)
trình, được biểu thị bằng ký hiệu bảng
Anh (#) trong tên trường. Để biết danh sách
đầy đủ các mã sân bay, hãy xem Danh mục mã
thành phố của IATA .
req_journey_leg#_orig Mã sân bay cho điểm xuất phát của chặng hành Chuỗi (3)
trình, được biểu thị bằng ký hiệu bảng Anh (#)
trong tên trường. Mã này thường dài ba
chữ số; ví dụ: SFO = San Francisco. Để biết
danh sách đầy đủ các mã sân bay, hãy xem Danh
mục mã thành phố của IATA.
req_journey_type Loại hành trình, chẳng hạn như một chiều hoặc Chuỗi (32)
khứ hồi.
req_line_item_count Tổng số mục hàng. Số tiền tối đa là 200. Chuỗi (2)
req_locale Cho biết ngôn ngữ sẽ sử dụng cho nội dung của Chuỗi (5)
khách hàng. Xem phần "Kích hoạt Hồ sơ" (ở trang
44).

& Chiều dài
req_merchant_defined_data# Các trường tùy chọn mà bạn có thể sử dụng để lưu trữ thông Chuỗi (100)
tin. # có thể nằm trong khoảng từ 1 đến 100.
Các trường dữ liệu do người bán xác định từ 1
đến 4 được liên kết với mã thông báo thanh toán
và được sử dụng cho các giao dịch dựa trên

mã thông báo tiếp theo. Các trường dữ liệu do người
bán xác định từ 5 đến 100 được chuyển đến Trình
quản lý quyết định như một phần của yêu cầu
thanh toán ban đầu và không được liên kết với
mã thông báo thanh toán.
Cảnh báo: Do người bán xác định

các trường dữ liệu không nhằm mục
đích và KHÔNG ĐƯỢC sử dụng để thu thập
Theo đó, người bán bị cấm thu thập, lấy và/hoặc
truyền bất kỳ thông tin nhận dạng cá nhân
nào trong hoặc thông qua các
trường dữ liệu do người bán xác định và

bất kỳ Trường chấp nhận an toàn nào
không được thiết kế đặc biệt để thu thập
Thông tin nhận dạng cá nhân bao gồm, nhưng

không giới hạn, số thẻ, số tài khoản ngân
hàng, số an sinh xã hội, số giấy phép lái xe,
số nhận dạng do nhà nước cấp, số hộ chiếu, số xác

minh thẻ (CVV, CVC2, CVV2, CID, CVN). Nếu
phát hiện ra rằng một người bán đang thu
thập và/hoặc truyền thông tin nhận dạng cá nhân qua
các trường dữ liệu do người bán xác định, dù cố ý
hay không, tài khoản của người bán SẼ bị đình chỉ

ngay lập tức, điều này sẽ dẫn đến việc từ chối bất
kỳ và tất cả các yêu cầu giao dịch đã gửi bởi
người bán sau thời điểm đình chỉ.

& Chiều dài
req_merchant_descriptor Để biết mô tả, thông tin được sử dụng, loại dữ
liệu và độ dài cho các trường này, hãy xem Bộ mô
req_merchant_descriptor_ thay tả người bán sử dụng API SCMP hoặc Bộ mô tả

thế người bán sử dụng API đặt hàng đơn giản .
req_merchant_descriptor_ thành
phố
req_merchant_descriptor_
liên hệ
req_merchant_descriptor_ quốc
gia
req_merchant_descriptor_post_code
req_merchant_descriptor_
tình trạng
req_merchant_descriptor_ đường
phố
req_merchant_secure_data1 Các trường tùy chọn mà bạn có thể sử dụng để Chuỗi (100)
lưu trữ thông tin. Dữ liệu được mã hóa trước khi
req_merchant_secure_data2 được lưu trữ trong kho lưu trữ thanh toán.
req_merchant_secure_data3
req_merchant_secure_data4 Trường tùy chọn mà bạn có thể sử dụng để lưu trữ thông Chuỗi (2000)
tin. Dữ liệu được mã hóa trước khi được lưu trữ
trong kho lưu trữ thanh toán.
req_override_backoffice_ Ghi đè cài đặt cấu hình URL bài đăng của URL (255)
post_url backoffice bằng URL của riêng bạn.

& Chiều dài
req_override_custom_ Ghi đè cài đặt cấu hình trang hủy tùy chỉnh URL (255)
cancel_page bằng URL của riêng bạn.
req_override_custom_ Ghi đè cài đặt cấu hình biên nhận tùy chỉnh bằng URL (255)
biên nhận_page URL của riêng bạn.
req_payment_method Phương thức thanh toán. Những giá trị khả thi: Chuỗi (30)
• thẻ
• kiểm tra
• người trả tiền
• thanh toán thị thực
req_payment_token Mã định danh cho các chi tiết thanh toán. Chuỗi (32)
Mã thông báo thanh toán truy xuất dữ liệu
thẻ, thông tin thanh toán và thông tin vận
chuyển từ kho lưu trữ thanh toán.
Khi trường này được bao gồm trong yêu cầu,
dữ liệu thẻ cũng như thông tin thanh toán
và vận chuyển là tùy chọn.
Bạn phải hiện đang sử dụng Dịch vụ quản

lý mã thông báo.
req_payment_token_ Nhận xét tùy chọn về mã thông báo của khách Chuỗi (255)
bình luận hàng.
req_payment_token_title Tên của mã thông báo khách hàng. Chuỗi (60)
req_profile_id Xác định hồ sơ để sử dụng với mỗi giao Chuỗi (36)

dịch.
req_promotion_code Mã khuyến mãi bao gồm trong giao dịch. Chuỗi (100)
req_recipient_account_id Định danh cho tài khoản của người nhận. Sử số
dụng sáu chữ số đầu tiên và bốn chữ số cuối cùng

của số tài khoản của người nhận. Chuỗi (10)
req_recipient_date_of_birth Ngày sinh của người nhận. Ngày (b)
Định dạng: yyyyMMDD. Chuỗi (8)
req_recipient_postal_code Một phần mã bưu chính cho địa chỉ của chữ và số
người nhận.
Chuỗi (6)

& Chiều dài
req_recipient_surname Họ của người nhận. anpha
Chuỗi (6)
req_recurring_amount Số tiền thanh toán cho mỗi lần trả góp hoặc Chuỗi (15)
thanh toán đăng ký định kỳ.
req_recurring_automatic_ Cho biết có tự động gia hạn lịch thanh toán cho liệt kê
thay mới đăng ký trả góp hay không. Những giá trị khả Sợi dây
thi:
Chuỗi (5)
• true (mặc định): Tự động gia hạn.
• false: Không tự động gia hạn.
req_recurring_frequency Tần suất thanh toán cho đăng ký trả góp hoặc Chuỗi (20)
định kỳ.
req_recurring_number_of_ lần Tổng số lần thanh toán được thiết lập cho Chuỗi (3)
cài đặt đăng ký trả góp.
req_recurring_start_date Ngày thanh toán đầu tiên cho thanh toán trả Chuỗi (8)
góp hoặc đăng ký định kỳ.
req_reference_number Số theo dõi hoặc tham chiếu đơn đặt Chuỗi (50)
hàng do người bán tạo duy nhất cho mỗi giao
dịch.
req_returns_accepted Cho biết liệu việc trả lại sản phẩm có được chấp Chuỗi (5)
nhận hay không. Những giá trị khả thi:
• đúng
• sai

& Chiều dài
req_sales_organization_id ID công ty được chỉ định cho một tổ chức bán hàng độc Số nguyên
lập. Lấy giá trị này từ Mastercard. không âm (11)
Giá trị cho trường này tương ứng với dữ liệu

này trong tệp chụp TC 33:
• Vị trí: 106-116
• Lĩnh vực: Bán hàng độc lập Mastercard

ID tổ chức
req_ship_to_address_city Thành phố của địa chỉ giao hàng. Chuỗi (50)
Visa Nhấp để
Trả: Chuỗi
(100)
req_ship_to_address_country Mã quốc gia ISO gồm hai ký tự. Chuỗi (2)
req_ship_to_address_line1 Dòng đầu tiên của địa chỉ giao hàng. Chuỗi (60)
Visa Nhấp để
Trả: Chuỗi
(100)
req_ship_to_address_line2 Dòng thứ hai của địa chỉ giao hàng. Chuỗi (60)
Visa Nhấp để
Trả: Chuỗi
(100)

& Chiều dài
req_ship_to_address_postal_ code Mã bưu chính cho địa chỉ giao hàng. Chuỗi (10)
Visa Nhấp để
Trả: Chuỗi
(100)
req_ship_to_address_state Mã tỉnh và bang ISO gồm hai ký tự . Chuỗi (2)
req_ship_to_company_name Tên công ty nhận sản phẩm. Chuỗi (40)
req_ship_to_forename Tên người nhận sản phẩm. Chuỗi (60)
Visa Nhấp để
Trả: Chuỗi
(256)
req_ship_to_phone Số điện thoại cho địa chỉ giao hàng. Chuỗi (15)
Visa Nhấp để
Trả: Chuỗi
(30)
req_ship_to_surname Họ tên người nhận sản phẩm. Chuỗi (60)
Visa Nhấp để
Trả: Chuỗi
(256)
& Chiều dài
req_shipping_method Phương thức vận chuyển cho sản phẩm. Những giá trị Chuỗi (10)
khả thi:
• sameday: Chuyển phát nhanh hoặc dịch vụ trong ngày
• oneday: Dịch vụ ngày hôm sau hoặc qua đêm
• twoday: Dịch vụ hai ngày
• ba ngày: Dịch vụ ba ngày
• chi phí thấp: Dịch vụ chi phí thấp nhất
• lấy hàng: Nhận hàng tại cửa hàng
• khác: Phương thức vận chuyển khác
• none: Không có phương thức vận chuyển
req_skip_decision_manager Cho biết có bỏ qua Quyết định hay không Chuỗi (5)
Giám đốc. Xem Trình quản lý Quyết định (trên trang
87). Các giá trị có thể:
• đúng
• sai
req_submerchant_city Thành phố của thương nhân phụ. Người Mỹ
Thể hiện trực tiếp:
Chuỗi (15)
La bàn FDC:
Chuỗi (21)
FDC Nashville
Toàn cầu: Chuỗi
(11)
req_submerchant_country Nước của tiểu thương. Chuỗi (3)

& Chiều dài
req_submerchant_email Địa chỉ email của người bán phụ. Người Mỹ

Kết nối nền tảng Visa Chuỗi (40)
Với American Express, giá trị cho trường này La bàn FDC:
tương ứng với dữ liệu này trong tệp chụp TC 33: Chuỗi (40)
FDC Nashville
• Ghi: CP01 TCRB Toàn cầu: Chuỗi
(19)
• Vị trí: 25-64
Nền tảng thị thực

• Lĩnh vực: Người bán American Express
Kết nối: Chuỗi (40)
Đi a chi email
req_submerchant_id ID bạn đã chỉ định cho người bán phụ của mình. Người Mỹ
tương ứng với dữ liệu này trong tệp chụp TC 33: Chuỗi (20)
FDC Nashville
(14)
• Vị trí: 65-84

• Trường: ID người bán American Express Kết nối với
Người Mỹ
Với Mastercard, giá trị cho trường này tương Thể hiện: Chuỗi
ứng với dữ liệu này trong tệp chụp TC 33: (20)

• Bản ghi: CP01 TCR6 Kết nối với
thẻ tín dụng:

• Vị trí: 117-131
Chuỗi (15)
• Trường: Mastercard Sub-Merchant ID

& Chiều dài
req_submerchant_name Tên doanh nghiệp của người bán phụ. Người Mỹ
Chuỗi (37)
La bàn FDC với

người Mỹ
Thể hiện: Chuỗi

(19)
La bàn FDC với
thẻ tín dụng:
Chuỗi (37)
FDC Nashville

(12)
req_submerchant_phone Số điện thoại của người bán phụ. Người Mỹ
tương ứng với dữ liệu này trong tệp chụp TC Chuỗi (13)
33:
FDC Nashville

(10)
• Vị trí: 5-24

• Lĩnh vực: Người bán American Express
Kết nối: Chuỗi
Số điện thoại
(20)

& Chiều dài
req_submerchant_postal_ mã Một phần mã bưu chính cho địa chỉ của người Người Mỹ
bán phụ. Thể hiện trực tiếp:
Chuỗi (9)
La bàn FDC:
Chuỗi (15)
FDC Nashville

(9)
req_submerchant_state Tiểu bang hoặc tỉnh của thương nhân phụ. Chuỗi (2)
req_submerchant_street Dòng đầu tiên của địa chỉ đường phố của người Người Mỹ
bán phụ. Thể hiện trực tiếp:
Chuỗi (30)
La bàn FDC:
Chuỗi (38)
FDC Nashville

(25)
req_tax_amount Tổng số thuế áp dụng cho sản phẩm. Chuỗi (15)
req_transaction_type Loại giao dịch được yêu cầu. Chuỗi (60)
req_transaction_uuid Số nhận dạng duy nhất do người bán tạo. Chuỗi (50)
Bao gồm trường access_key cho mỗi giao dịch.
Visa Nhấp để
Trả: Chuỗi
(100)

& Chiều dài
request_token Yêu cầu dữ liệu mã thông báo được tạo Chuỗi (256)
cho mỗi phản hồi. Trường này là một chuỗi
được mã hóa không chứa thông tin mật.
trái đất
Bạn phải lưu trữ giá trị mã thông báo yêu

cầu để bạn có thể truy xuất và gửi nó
trong các yêu cầu tiếp theo.
Phần bắt buộc Cho biết trường yêu cầu nào được yêu cầu Biến đổi
nhưng không được cung cấp.
service_fee_amount Số tiền phí dịch vụ cho đơn đặt hàng. Chuỗi (15)
chữ ký Chữ ký Base64 được trả về bởi Chuỗi (44)

máy chủ.
đã ký_ngày_giờ Ngày và giờ khi chữ ký được tạo bởi máy chủ. Chuỗi (20)
Định dạng: yyyy-MM-DDThh:mm:ssZ
Ví dụ 2020-08-11T22:47:57Z tương đương với

ngày 11 tháng 8 năm 2020, lúc 22:47:57
(10:47:57 chiều). Chữ T ngăn cách ngày và
giờ. Z biểu thị UTC.
đã ký_field_names Danh sách dữ liệu phản hồi được phân tách Biến đổi
bằng dấu phẩy đã được ký bởi máy chủ. Tất

cả các trường trong danh sách này sẽ được sử
dụng để tạo chữ ký mà sau đó có thể được so sánh
với chữ ký phản hồi để xác minh phản hồi.
ID giao dịch Mã định danh giao dịch được trả về từ cổng Chuỗi (26)
thanh toán.
utf8 Cho biết liệu các ký tự unicode có được mã hóa hay Chuỗi (3)
không.
Giá trị có thể: #
vc_avs_code_raw Mã AVS thô (chưa ánh xạ) được giải mã do Chuỗi (10)
Visa Click to Pay cung cấp.

& Chiều dài
vc_risk_score Điểm rủi ro đã giải mã được sử dụng với mô hình Tích cực
gian lận của bạn. Xem Định cấu hình Visa Click Số nguyên (2)
to Pay (ở trang 26).
vc_wallet_reference_id Số nhận dạng đơn đặt hàng được giải mã do Visa Chuỗi (100)
Click to Pay tạo ra.
Mã SEC
Trường echeck_sec_code chỉ định phương thức ủy quyền cho giao dịch. Những giá trị khả thi:
• CCD: giải ngân tiền mặt của công ty—một khoản phí hoặc tín dụng đối với tài khoản séc của doanh nghiệp. Bạn
có thể sử dụng các giao dịch CCD một lần hoặc định kỳ để chuyển tiền đến hoặc từ một thực thể công ty. Cần
có ủy quyền lâu dài cho các giao dịch định kỳ. Đối với Dịch vụ ACH của Cybersource, CCD là giá trị mặc định
khi không có giá trị nào được đặt.
• PPD: khoản thanh toán được sắp xếp trước và mục nhập tiền gửi—một khoản phí hoặc tín dụng đối với tài
khoản séc hoặc tài khoản tiết kiệm cá nhân. Bạn chỉ có thể tạo một mục nhập PPD khi các điều khoản
thanh toán và tiền gửi giữa bạn và khách hàng được sắp xếp trước. Cần có sự ủy quyền bằng văn bản của
khách hàng đối với các giao dịch một lần và cần có sự ủy quyền vĩnh viễn bằng văn bản đối với các
giao dịch định kỳ. Đối với Dịch vụ ACH của Cybersource, PPD là giá trị mặc định nếu không có giá trị nào được đặt.
• TEL: mục nhập bắt đầu bằng điện thoại—một khoản phí một lần đối với tài khoản séc hoặc tài khoản
tiết kiệm cá nhân. Bạn chỉ có thể tạo mục nhập TEL khi có mối quan hệ kinh doanh giữa bạn và khách
hàng hoặc khi khách hàng bắt đầu cuộc gọi điện thoại cho bạn. Đối với mục nhập TEL , bạn phải nhận được
ủy quyền thanh toán từ khách hàng qua điện thoại. Chỉ bộ xử lý ACH của Cybersource mới hỗ trợ ghi nợ
và ghi có định kỳ do điện thoại khởi tạo. Đối với Dịch vụ ACH của Cybersource, nếu chỉ báo thương
mại điện tử (ECI) cho Thiết bị đầu cuối ảo là MOTO, thì giá trị của echeck_sec_code sẽ mặc định là TEL.
• WEB: mục nhập bắt đầu qua internet—một khoản phí đối với tài khoản tiết kiệm hoặc séc cá nhân. Bạn có thể
tạo mục nhập WEB một lần hoặc định kỳ khi khách hàng bắt đầu giao dịch qua Internet. Đối với mục nhập
WEB , bạn phải nhận được ủy quyền thanh toán từ khách hàng qua Internet. Đối với Dịch vụ ACH của
Cybersource, nếu ECI cho Thiết bị đầu cuối ảo không được đặt thành MOTO, thì giá trị của echeck_sec_code
sẽ mặc định là WEB. Sử dụng WEB làm mã SEC cho tất cả các giao dịch bằng đô la Canada trên kết nối
Chase Paymentech Solutions.
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Mã SEC| 226
Mã lý do
Trường reason_code chứa dữ liệu bổ sung liên quan đến phản hồi quyết định của giao dịch.
Tùy thuộc vào quyết định của yêu cầu giao dịch, trang biên nhận mặc định hoặc trang biên nhận của bạn sẽ
được hiển thị cho khách hàng. Cả bạn và khách hàng của bạn cũng có thể nhận được biên nhận qua email.
Xem "Thông báo của người bán" (ở trang 33).
Mã lý do
Lý do Sự miêu tả
Mã số
100 Giao dịch thành công.
101 Yêu cầu thiếu một hoặc nhiều trường bắt buộc. Kiểm tra các
trường phản hồi từ missingField_0 đến missingField_N để xác
định trường nào bị thiếu. Gửi lại yêu cầu với tất cả các trường bắt
buộc.
102 Một hoặc nhiều trường trong yêu cầu chứa dữ liệu không hợp lệ.
Hành động có thể thực hiện: xem trường phản hồi

invalid_fields để xác định trường nào không hợp lệ. Gửi lại yêu
cầu với thông tin chính xác.
104 Các trường access_key và transaction_uuid cho yêu cầu

ủy quyền này khớp với các trường access_key và
transaction_uuid của một yêu cầu ủy quyền khác mà bạn đã gửi trong
vòng 15 phút qua.
Hành động có thể thực hiện: gửi lại yêu cầu với các trường access_key
và transaction_uuid duy nhất .
Một giao dịch trùng lặp đã được phát hiện. Giao dịch có thể đã
được xử lý.
Hành động có thể thực hiện: trước khi gửi lại giao dịch, hãy sử
dụng truy vấn giao dịch đơn lẻ hoặc tìm kiếm giao dịch bằng
Business Center để xác nhận rằng giao dịch chưa được xử lý. Xem
Xem các giao dịch trong Business Center(ở trang 90).
110 Chỉ một phần số tiền đã được phê duyệt.
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Mã lý do| 227
Mã lý do (tiếp theo)
Mã số
150 Lỗi hệ thống chung.
Hành động có thể thực hiện: Để tránh sao chép giao

dịch, không gửi lại yêu cầu cho đến khi bạn đã xem
xét trạng thái giao dịch trực tiếp trong Business Center
hoặc lập trình thông qua truy vấn giao dịch đơn lẻ.
151 Đã nhận được yêu cầu nhưng đã xảy ra thời gian chờ máy chủ. Lỗi
này không bao gồm thời gian chờ giữa máy khách và
máy chủ.
Hành động có thể thực hiện: Để tránh sao chép giao dịch,
không gửi lại yêu cầu cho đến khi bạn đã xem xét trạng
thái giao dịch trực tiếp trong Business Center hoặc lập trình
thông qua truy vấn giao dịch đơn lẻ.
152 Đã nhận được yêu cầu, nhưng đã xảy ra thời gian chờ dịch vụ.
Hành động có thể thực hiện: Để tránh sao chép giao dịch,
không gửi lại yêu cầu cho đến khi bạn đã xem xét trạng
thái giao dịch trực tiếp trong Business Center hoặc lập trình
thông qua truy vấn giao dịch đơn lẻ.
200 Yêu cầu ủy quyền đã được chấp thuận bởi ngân hàng phát hành nhưng
đã bị từ chối vì nó không vượt qua kiểm tra của Hệ thống xác minh
địa chỉ (AVS).
Hành động có thể thực hiện: bạn có thể nắm bắt được ủy quyền, nhưng hãy xem xét
việc xem xét đơn đặt hàng để tìm gian lận.
201 Ngân hàng phát hành có câu hỏi về yêu cầu. Bạn không nhận được
mã ủy quyền theo chương trình, nhưng bạn có thể nhận được mã ủy
quyền bằng lời nói bằng cách gọi bộ xử lý.
Hành động có thể thực hiện: gọi cho bộ xử lý của bạn để có thể nhận
được ủy quyền bằng lời nói. Để biết số điện thoại liên hệ, hãy tham khảo
thông tin ngân hàng thương gia của bạn.
Mã số
202 Thẻ hết hạn. Bạn cũng có thể nhận được giá trị này nếu ngày hết hạn mà
bạn cung cấp không khớp với ngày mà ngân hàng phát hành có trong hồ sơ.
Hành động có thể thực hiện: yêu cầu một thẻ khác hoặc hình thức
thanh toán khác.
203 Sự suy giảm chung của thẻ. Không có thông tin nào khác được cung cấp
bởi ngân hàng phát hành.
thanh toán khác.
204 Không đủ tiền trong tài khoản.
thanh toán khác.
205 Thẻ bị đánh cắp hoặc bị mất.
Hành động có thể thực hiện: xem lại giao dịch này theo cách thủ công để
đảm bảo rằng bạn đã gửi thông tin chính xác.
207 Ngân hàng phát hành không khả dụng.

208 Thẻ không hoạt động hoặc thẻ không được phép thực hiện các giao dịch không
cần xuất trình thẻ.
thanh toán khác.
210 Thẻ đã đạt đến giới hạn tín dụng.
thanh toán khác.
Mã số
211 CVN không hợp lệ.
thanh toán khác.
221 Khách hàng khớp với một mục trên tệp phủ định của bộ xử lý.
Hành động có thể thực hiện: xem lại đơn đặt hàng và liên hệ với bộ xử
lý thanh toán.
222 Tài khoản bị đóng băng.
230 Yêu cầu ủy quyền đã được chấp thuận bởi ngân hàng phát hành nhưng
bị từ chối vì nó không vượt qua kiểm tra CVN.
Hành động có thể thực hiện: bạn có thể nắm bắt được ủy quyền, nhưng hãy
cân nhắc xem lại đơn đặt hàng để biết khả năng gian lận.
231 Số tài khoản không hợp lệ.
thanh toán khác.
232 Loại thẻ không được bộ xử lý thanh toán chấp nhận.
Hành động có thể thực hiện: liên hệ với ngân hàng thương mại của bạn để xác
nhận rằng tài khoản của bạn được thiết lập để nhận thẻ được đề cập.
233 Suy giảm chung bởi bộ xử lý.
thanh toán khác.
234 Có vấn đề với thông tin trong tài khoản của bạn.
Hành động có thể: không gửi lại yêu cầu. Liên hệ với bộ phận hỗ
trợ khách hàng để sửa thông tin trong tài khoản của bạn.
236 Lỗi bộ xử lý.

Mã số
240 Loại thẻ được gửi không hợp lệ hoặc không tương quan với số
thẻ thanh toán.
Hành động có thể thực hiện: xác nhận rằng loại thẻ tương ứng với
số thẻ thanh toán được chỉ định trong yêu cầu; sau đó gửi lại yêu
cầu.
475 Chủ thẻ được đăng ký để xác thực người trả tiền.
Hành động có thể thực hiện: xác thực chủ thẻ trước khi tiếp tục.
476 Xác thực người trả tiền không thể được xác thực.
478 Xác thực khách hàng mạnh (SCA) là bắt buộc đối với giao dịch
này.
481 Giao dịch bị từ chối dựa trên cài đặt thanh toán của bạn cho hồ
sơ.
Hành động có thể thực hiện: xem lại cài đặt điểm rủi ro cho hồ sơ.
520 Yêu cầu ủy quyền đã được ngân hàng phát hành chấp thuận nhưng bị từ
chối dựa trên cài đặt Trình quản lý quyết định của bạn.
Hành động có thể thực hiện: xem lại yêu cầu ủy quyền.
Các loại thông báo
Các loại thông báo

Quyết định Mô tả Loại trang lưu trữ thông báo
CHẤP NHẬN Giao dịch thành công. • Trang biên nhận Chấp nhận
tùy chỉnh
Mã lý do 100 và 110.
• Email nhận
hàng của khách hàng
• Người bán POST

URL
• Email biên nhận của

người bán
ĐÁNH GIÁ Ủy quyền đã bị từ chối; tuy nhiên, • Biên nhận tùy chỉnh Chấp nhận
vẫn có thể chụp được. Xem lại chi trang

tiết thanh toán.
• Email nhận
Xem mã lý do 200, 201, 230 và 520. hàng của khách hàng

URL

người bán
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Các loại Thông báo| 232
Các loại Thông báo (tiếp theo)
Quyết định Mô tả Loại trang lưu trữ thông báo
DECLINE Giao dịch bị từ chối. • Trang biên nhận Sự suy sụp
tùy chỉnh
Xem mã lý do 102, 200, 202, 203, 204,

205, 207, 208, 210, 211, 221, 222,
URL
230, 231, 232, 233, 234, 236, 240,
475, 476, 478 và 481.
người bán
Nếu giới hạn thử lại được đặt thành
0, khách hàng sẽ nhận được thông báo
từ chối, Đơn đặt hàng của bạn đã bị từ chối.
Vui lòng xác minh thông tin của

bạn. trước khi người bán nhận được
nó. Thông báo từ chối liên quan đến

việc bộ xử lý từ chối giao dịch hoặc
lỗi xử lý thanh toán hoặc khách
hàng đã nhập sai thông tin xác thực
3D Secure của họ.
LỖI Truy cập bị từ chối, không tìm thấy trang • Trang biên nhận Lỗi
hoặc lỗi máy chủ nội bộ. tùy chỉnh

Xem mã lý do 102, 104, 150, 151 và 152.
URL
HỦY BỎ Khách hàng không chấp nhận • Trang biên nhận Hủy bỏ
điều kiện phí dịch vụ. tùy chỉnh
Khách hàng đã hủy bỏ • Người bán POST
giao dịch. URL
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Các loại Thông báo| 233
Mã AVS
Ngân hàng phát hành sử dụng mã AVS để xác nhận rằng khách hàng của bạn đang cung cấp địa chỉ thanh toán chính
xác. Nếu khách hàng cung cấp thông tin không chính xác, giao dịch có thể là gian lận. Mã Dịch vụ xác minh địa chỉ
nội địa và quốc tế của Hoa Kỳ (AVS) là mã AVS tiêu chuẩn của Visa, ngoại trừ mã 1 và 2 là mã AVS của Cybersource.
Mã trả lại AVS tiêu chuẩn cho các loại thẻ thanh toán khác (bao gồm cả thẻ American Express) được ánh xạ tới mã tiêu
chuẩn Visa. Bạn nhận được mã trong trường phản hồi auth_avs_code . Xem Trường phản hồi (ở trang 173).
Quan trọng: Khi bạn điền địa chỉ đường thanh toán 1 và địa chỉ đường thanh toán 2, Visa Platform
Connect sẽ nối hai giá trị này. Nếu giá trị được nối vượt quá 40 ký tự, Visa Platform Connect sẽ cắt bớt giá
trị còn 40 ký tự trước khi gửi cho Visa và ngân hàng phát hành. Việc cắt bớt giá trị này sẽ ảnh hưởng đến
kết quả AVS và do đó cũng có thể ảnh hưởng đến các quyết định rủi ro và khoản bồi hoàn.
Mã AVS quốc tế
Các mã này chỉ được trả lại cho thẻ Visa được phát hành bên ngoài Hoa Kỳ
Mã AVS quốc tế
Mã số Phản ứng Sự miêu tả
b Khớp một phần Địa chỉ đường phố khớp, nhưng mã bưu điện chưa được xác minh.
C Không có trận đấu

Địa chỉ đường phố và mã bưu chính không khớp.
Trận đấu D & M Địa chỉ đường phố và mã bưu chính phù hợp.
TÔI Không có trận đấu Địa chỉ chưa được xác minh.
P Khớp một phần Mã bưu chính khớp, nhưng địa chỉ đường phố chưa được xác minh.
Mã AVS nội địa Hoa Kỳ
Mã AVS nội địa Hoa Kỳ
MỘT Trận đấu một phần Địa chỉ đường phố khớp, nhưng mã bưu chính gồm
năm chữ số và chín chữ số không khớp.
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Mã AVS| 234
Mã AVS nội địa Hoa Kỳ (tiếp theo)

b Trận đấu một phần Địa chỉ đường phố khớp, nhưng mã bưu chính không
được xác minh.
C Không có trận đấu

Địa chỉ đường phố và mã bưu chính không khớp.
Trận đấu D & M Địa chỉ đường phố và mã bưu chính phù hợp.
e Không hợp lệ Dữ liệu AVS không hợp lệ hoặc AVS không được phép cho
loại thẻ này.
F Trận đấu một phần Tên của thành viên thẻ không khớp, nhưng mã bưu điện
thanh toán khớp. Chỉ trả lại cho loại thẻ American
Express.
g Không được hỗ trợ.
h Trận đấu một phần Tên của thành viên thẻ không khớp, nhưng địa chỉ đường
phố và mã bưu chính khớp. Chỉ trả lại cho loại thẻ American
Express.
TÔI Không có trận đấu Địa chỉ chưa được xác minh.
J Cuộc thi đấu

Tên, địa chỉ thanh toán và mã bưu điện của thành viên thẻ
khớp với nhau. Thông tin vận chuyển đã được xác minh và
bảo vệ bồi hoàn được đảm bảo thông qua Chương trình
chống gian lận. Chỉ được trả lại nếu bạn đã đăng ký sử
dụng AAV+ với bộ xử lý American Express Phoenix.
K Trận đấu một phần Tên của thành viên thẻ khớp, nhưng địa chỉ thanh toán và mã
bưu chính thanh toán không khớp. Chỉ trả lại cho loại
thẻ American Express.
L Trận đấu một phần Tên thành viên thẻ và mã bưu điện thanh toán khớp
nhau, nhưng địa chỉ thanh toán không khớp.
Chỉ trả lại cho loại thẻ American Express.
m Cuộc thi đấu

Địa chỉ đường phố và mã bưu chính phù hợp.
N Không có trận đấu

Một trong những mô tả này:
• Địa chỉ đường phố và mã bưu chính không

cuộc thi đấu.
• Tên thành viên thẻ, địa chỉ đường phố, và
mã bưu điện không khớp. Chỉ trả lại cho loại thẻ
American Express.
Ô Trận đấu một phần Tên và địa chỉ thanh toán của thành viên thẻ khớp, nhưng
mã bưu chính thanh toán không khớp. Chỉ trả lại cho loại

P Trận đấu một phần Mã bưu chính khớp, nhưng địa chỉ đường phố chưa
được xác minh.
Hỏi
Cuộc thi đấu
Tên, địa chỉ thanh toán và mã bưu điện của thành viên thẻ
khớp với nhau. Thông tin vận chuyển đã được xác minh
nhưng bảo vệ bồi hoàn không được đảm bảo (Chương trình
tiêu chuẩn). Chỉ được trả lại nếu bạn đã đăng ký sử dụng
AAV+ với bộ xử lý American Express Phoenix.
r Hệ thống không khả dụng Hệ thống không khả dụng.
S Không được hỗ trợ Ngân hàng phát hành của Hoa Kỳ không hỗ trợ AVS.
t Trận đấu một phần Tên của thành viên thẻ không khớp, nhưng địa chỉ đường
phố khớp. Chỉ trả lại cho loại thẻ American Express.
bạn
Hệ thống không khả dụng Thông tin địa chỉ không khả dụng cho một trong số này
lý do:
• Ngân hàng Hoa Kỳ không hỗ trợ ngoài Hoa Kỳ

AVS.
• AVS tại một ngân hàng Hoa Kỳ không hoạt động
bình thường.
V Cuộc thi đấu

Tên, địa chỉ thanh toán và mã bưu chính thanh toán
của thành viên thẻ khớp với nhau. Chỉ trả lại cho loại
W Trận đấu một phần Địa chỉ đường phố không khớp, nhưng mã bưu điện chín
chữ số khớp.
X Cuộc thi đấu

Địa chỉ đường phố và mã bưu chính chín chữ số khớp nhau.
Y Cuộc thi đấu

Địa chỉ đường phố và mã bưu chính năm chữ số khớp với nhau.
z Trận đấu một phần Địa chỉ đường phố không khớp, nhưng mã bưu chính gồm 5
chữ số khớp.
1 Không được hỗ trợ AVS không được hỗ trợ cho bộ xử lý hoặc loại thẻ này.
2 không được công nhận Bộ xử lý đã trả về một giá trị không được nhận dạng cho phản
hồi AVS.
3 Cuộc thi đấu

Địa chỉ được xác nhận. Chỉ được trả lại cho PayPal
Express Checkout.

4 Không có trận đấu

Địa chỉ không được xác nhận. Chỉ được trả lại
cho PayPal Express Checkout.
mã CVN
mã CVN
Mô tả mã
Đ. Giao dịch được coi là đáng ngờ bởi ngân hàng phát hành.
TÔI
CVN không xác thực được dữ liệu của bộ xử lý.
M CVN đã khớp.
N CVN không khớp.
P CVN đã không được xử lý bởi bộ xử lý cho một không xác định

lý do.
S CVN có trên thẻ nhưng không được đưa vào yêu cầu.
bạn
Ngân hàng phát hành không hỗ trợ xác minh thẻ.
X Hiệp hội thẻ không hỗ trợ xác minh thẻ.
1 Xác minh thẻ không được hỗ trợ cho bộ xử lý hoặc loại thẻ này.
2 Một mã kết quả không được nhận dạng đã được bộ xử lý trả về cho
phản hồi xác minh thẻ.
3 Không có mã kết quả nào được bộ xử lý trả về.
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Mã CVN| 238
Mã phản hồi SafeKey của American Express
Mã phản hồi American Express SafeKey được trả về trong trường auth_cavv_result trong thông báo phản
hồi cho một yêu cầu ủy quyền.
Mã phản hồi SafeKey của American Express
Phản ứng Sự miêu tả

Mã số
1 CAVV không xác thực và xác thực.
2 CAVV đã thông qua xác nhận và xác thực.
3 CAVV đã vượt qua lần thử xác thực.
4 CAVV không thành công trong nỗ lực xác thực.
7 CAVV không thành công trong nỗ lực xác thực và nhà phát hành có sẵn.
số 8
CAVV đã vượt qua lần thử xác thực và nhà phát hành có sẵn.
9 CAVV không thành công trong nỗ lực xác thực và tổ chức phát hành không khả dụng.
MỘT
CAVV đã vượt qua lần thử xác thực và tổ chức phát hành không khả dụng.
bạn
Tổ chức phát hành không tham gia hoặc dữ liệu 3D Secure không được sử dụng.
99 Một giá trị không xác định đã được trả về từ bộ xử lý.
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Mã phản hồi SafeKey của American Express| 239
Triển khai khung nội tuyến
Quan trọng: Nếu bạn định nhúng Chấp nhận an toàn vào iframe, hãy đảm bảo rằng bạn làm theo các bước
trong phụ lục này. PayPal Express Checkout không được hỗ trợ trên tích hợp iframe Chấp nhận an toàn.
Quan trọng: Đối với quy trình 3D Secure 2.x xác thực người trả tiền, hãy đảm bảo rằng khung nội
tuyến đủ lớn để hiển thị nội dung thách thức máy chủ kiểm soát truy cập (ACS) của nhà phát hành (ít nhất
390 x 400 pixel). Để biết thêm thông tin về ACS, hãy xem hướng dẫn Xác thực người trả tiền.
Bạn phải chọn tùy chọn thanh toán một trang để triển khai iframe thanh toán được lưu trữ. Xem Cấu hình thanh
toán (ở trang 29).
Tổng giá trị số tiền và nút hủy giao dịch không được hiển thị trong iframe.
Bất kỳ cài đặt nào bạn đã định cấu hình cho con số tổng số tiền đều bị bỏ qua. Xem Giao diện thanh toán
tùy chỉnh (trên trang 38).
Cybersource khuyên bạn nên quản lý tổng giá trị số lượng trên trang web của mình có chứa khung nội
tuyến. Bạn cũng phải cung cấp cho khách hàng chức năng hủy đơn đặt hàng trên trang web của bạn có chứa
khung nội tuyến.
Phòng chống Clickjacking
Clickjacking (còn được gọi là tấn công khắc phục giao diện người dùng và lớp phủ khung nội tuyến) được
những kẻ tấn công sử dụng để lừa người dùng nhấp vào một lớp trong suốt (có mã độc) phía trên các nút hợp
pháp hoặc nội dung có thể nhấp của một trang web. Để ngăn clickjacking, bạn phải ngăn các trang web của bên thứ
ba đưa trang web của bạn vào iframe.
Mặc dù không có biện pháp khắc phục bảo mật nào có thể ngăn chặn mọi hoạt động clickjacking, đây là những biện pháp tối thiểu
bạn phải sử dụng cho các trình duyệt web hiện đại:
• Đặt tiêu đề phản hồi HTTP X-FRAME_OPTIONS thành “DENY” hoặc “SAMEORIGIN”.
• Cung cấp các tập lệnh phá khung để đảm bảo rằng trang của bạn luôn là cửa sổ cấp cao nhất hoặc
vô hiệu hóa mã cho các trình duyệt cũ hơn không hỗ trợ X-FRAME_OPTIONS.
Không sử dụng khung kép trên cùng một trang nơi triển khai iframe thanh toán được lưu trữ được sử dụng.
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Triển khai khung nội tuyến| 240
Bạn được yêu cầu triển khai các kỹ thuật phòng ngừa được đề xuất trên trang web của mình. Xem OWASP
Clickjacking Defense trang và Cross Site Scripting trang để cập nhật thông tin.
Các biện pháp bảo vệ ứng dụng web đối với Cross-site Scripting (XSS), Cross-site Request Forgery (CSRF),
v.v. cũng phải được kết hợp.
• Để bảo vệ XSS, bạn phải triển khai xác thực đầu vào toàn diện và thư viện mã hóa bảo mật được
đề xuất của OWASP để thực hiện mã hóa đầu ra trên trang web của bạn.
• Để bảo vệ CSRF, bạn nên sử dụng mẫu mã thông báo được đồng bộ hóa. Biện pháp này yêu cầu tạo mã
thông báo ngẫu nhiên được liên kết với phiên người dùng. Mã thông báo sẽ được chèn bất cứ khi nào
yêu cầu HTTP được gửi đến máy chủ. Ứng dụng máy chủ của bạn sẽ xác minh rằng mã thông báo từ yêu
cầu giống với mã được liên kết với phiên người dùng.
Điểm cuối giao dịch iframe
Để biết điểm cuối giao dịch iframe và loại giao dịch được hỗ trợ cho từng điểm cuối, hãy xem Điểm cuối và
Loại giao dịch (ở trang 69).
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Triển khai khung nội tuyến| 241
Mã phản hồi an toàn của Visa
Mã phản hồi Visa Secure được trả về trong trường auth_cavv_result trong thông báo phản hồi cho một yêu cầu ủy quyền.
Mã phản hồi an toàn của Visa
Phản ứng Sự miêu tả

Mã số
0 CAVV không được xác thực vì dữ liệu sai đã được gửi.
1 CAVV không xác thực và xác thực.
2 CAVV đã thông qua xác nhận và xác thực.
3 CAVV đã vượt qua lần thử xác thực.
4 CAVV không thành công trong nỗ lực xác thực.
6 CAVV không được xác thực vì tổ chức phát hành không tham gia.
7 CAVV không thành công trong nỗ lực xác thực và nhà phát hành có sẵn.
số 8
CAVV đã vượt qua lần thử xác thực và nhà phát hành có sẵn.
9 CAVV không thành công trong nỗ lực xác thực và tổ chức phát hành không khả dụng.
MỘT
CAVV đã vượt qua lần thử xác thực và tổ chức phát hành không khả dụng.
b CAVV đã vượt qua quá trình xác thực chỉ với thông tin; không có sự thay đổi trách nhiệm.
C CAVV đã cố gắng nhưng không được xác thực; nhà phát hành đã không trả lại mã CAVV.
Đ. CAVV chưa được hợp lệ hoặc xác thực; nhà phát hành đã không trả lại mã CAVV.
TÔI
Dữ liệu bảo mật không hợp lệ.
bạn
Tổ chức phát hành không tham gia hoặc dữ liệu 3D Secure không được sử dụng.
99 Một giá trị không xác định đã được trả về từ bộ xử lý.
Chấp nhận an toàn Tích hợp thanh toán được lưu trữ trên máy chủ| Mã phản hồi an toàn của Visa| 242

Secure Acceptance Hosted Checkout

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Secure Acceptance Hosted Checkout

Uploaded by

Copyright:

Available Formats

Machine Translated by Google

Hướng dẫn dành cho nhà phát triển

© 2023. Cybersource Corporation. Đã đăng ký Bản quyền.

Truyền thuyết về quyền hạn chế

Phiên bản: 23.03

Về sự hướng dẫn này............................................... .................................................... ....................................................10

Yêu cầu về trang web ............................................................ .................................................... ..................................... 12

Các trình duyệt cần thiết ............................................................ .................................................... .................................................... ......13

Hồ sơ chấp nhận an toàn ............................................................ .................................................... ................................................14

Luồng giao dịch chấp nhận an toàn .................................................. .................................................... ..................... 15

Token thanh toán ................................................................ .................................................... .................................................... ............16

Thanh toán đăng ký ................................................................ .................................................... ...................................................17

Dữ liệu cấp II và III .................................................. .................................................... .................................................... .......18

Xuất chi Mã thông báo thanh toán .................................................. .................................................... ...................................................19

Phát trực tiếp với chấp nhận an toàn.................................................. .................................................... ....................................19

Cấu hình thanh toán ................................................................ .................................................... .................................... 20

Tạo hồ sơ chấp nhận an toàn .................................................. .................................................... ...................... 20

Cấu hình phương thức thanh toán.................................................. .................................................... ............................... 21

Thêm loại thẻ và đơn vị tiền tệ.................................................. .................................................... .................21

Kích hoạt đảo ngược ủy quyền tự động ................................................ ...................................................24

Kích hoạt Echeck.................................................................... .................................................... .................................................... 24

Cấu hình Nhấp để thanh toán của Visa.................................................. .................................................... ...................25

Kích hoạt PayPal Express Checkout.................................................. .................................................... ................27

Khóa bảo mật ................................................................ .................................................... .................................................... ..................28

Tạo khóa bảo mật............................................................. .................................................... ........................................28

Cấu hình thanh toán ................................................................ .................................................... ...................................................29

Thông báo của người bán ................................................................ .................................................... ...................................................33

Phiếu thu của khách hàng ............................................................................ .................................................... .................................................... .......34

Trang phản hồi của khách hàng ............................................................ .................................................... ............................................. 36

Giao diện thanh toán tùy chỉnh.................................................. .................................................... ..................................... 38

Thay đổi nội dung Header .............................................................. .................................................... ................................ 38

Thay đổi nền tổng số tiền và màu văn bản............................................. ................................. 39

Thay đổi màu của thanh tiến trình.................................................. .................................................... .....................40

Kích hoạt một hồ sơ ............................................................ .................................................... .................................................... .......44

Tùy chọn hồ sơ bổ sung.................................................. .................................................... ....................................44

Người bán lại: Tạo Hồ sơ chấp nhận an toàn............................................. .................................................... .....45

Cấu hình phương thức thanh toán.................................................. .................................................... ............................... 46

Người bán lại: Kích hoạt Echecks.................................................. .................................................... ................................ 49

Cấu hình Nhấp để thanh toán của Visa.................................................. .................................................... .........................50

Người bán lại: Kích hoạt PayPal Express Checkout............................................. ....................................................51

Phí dịch vụ................................................ .................................................... .................................................... ..........52

Khóa bảo mật ................................................................ .................................................... .................................................... ........52

Cấu hình thanh toán ................................................................ .................................................... .....................................54

Thông báo của người bán ................................................................ .................................................... .................................... 58

Phiếu thu của khách hàng ............................................................................ .................................................... ...................................................59

Trang phản hồi của khách hàng ............................................................ .................................................... ....................................60

Giao diện thanh toán tùy chỉnh.................................................. .................................................... ...................62

Người bán lại: Kích hoạt một Hồ sơ............................................. .................................................... .................................66

Ngôn ngữ kịch bản mẫu ............................................................ .................................................... ................................ 68

Quy trình giao dịch mẫu sử dụng JSP.................................................. .................................................... ................... 68

Giao dịch thanh toán ................................................................ .................................................... ....................................69

Điểm cuối và loại giao dịch .................................................. .................................................... .........................69

Các trường đã ký bắt buộc ............................................................ .................................................... ....................................................71

Token thanh toán ................................................................ .................................................... .................................................... ............72

Tạo mã thông báo thẻ thanh toán.................................................. .................................................... ....................72

Tạo mã thông báo Echeck .............................................................. .................................................... ....................................74

Giao dịch mã thông báo thanh toán .................................................. .................................................... .....................................75

Một lần bấm ............................................................. .................................................... .................................................... ................. 75

Kiểm tra thanh toán bằng mã thông báo.................................................. .................................................... ................................ 78

Thanh toán định kỳ ................................................................ .................................................... .................................................... ....79

Thanh toán từng lần................................................ .................................................... .................................................... 81

Cập nhật mã thông báo thanh toán.................................................. .................................................... ................................................. 83

Cập nhật mã thông báo thẻ thanh toán.................................................. .................................................... ......................83