Kết nối Authorize.Net

Những gì bạn cần

Trường	Nó làm gì
API Login ID	Nhận diện tài khoản của bạn trên các lệnh gọi API. Đi kèm với Transaction Key.
Transaction Key	Nửa bí mật của xác thực API. Cùng với Login ID, nó tạo ra mỗi biểu mẫu thanh toán. Bí mật.
Signature Key	Xác nhận một webhook thực sự đến từ Authorize.Net. Tách khỏi Transaction Key. Bí mật.
Success URL / Cancel URL	Nơi người mua đáp xuống sau khi trả tiền hoặc rút lui.

API Login ID và Transaction Key luôn đi cùng nhau. Signature Key là độc lập.

Vì sao chúng tôi hỏi mỗi trường

Đặt tên tài khoản của bạn trên các lệnh gọi API. Nó chỉ hoạt động khi đi kèm với Transaction Key.

Transaction Key

Bí mật chứng minh một yêu cầu API là của bạn. Cùng với API Login ID, nó cho phép chúng tôi dựng biểu mẫu thanh toán được lưu trữ, để khoản phí chạy qua tài khoản của bạn.

Signature Key

Chứng minh một webhook đến thực sự từ Authorize.Net, nên không ai có thể giả mạo một sự kiện "đã trả tiền". Nó là một giá trị riêng tách khỏi Transaction Key.

Success và Cancel URL

Cài đặt thông thường: nơi người mua đáp xuống sau khi trả tiền hoặc rút lui. Không bí mật.

Thiết lập

Tạo một tài khoản sandbox miễn phí (không thanh toán)
Bạn không cần một tài khoản người bán trả phí để kiểm tra. Authorize.Net cung cấp một sandbox miễn phí phản ánh môi trường sản xuất, không cần thẻ tín dụng.
1. Vào developer.authorize.net/hello_world/sandbox.html và đăng ký một tài khoản sandbox. Dùng liên kết đó, không phải trang đăng ký chính hay trang bảng giá (đó là đơn đăng ký live trả phí).
2. Đăng nhập vào Merchant Interface của sandbox tại sandbox.authorize.net.
Lược đồ chữ ký giống hệt môi trường sản xuất, nên bất cứ thứ gì bạn kiểm chứng trong sandbox đều hoạt động giống hệt khi chạy live.
Sao chép ba thông tin xác thực của bạn
Cùng đường dẫn ở cả sandbox lẫn live: Account → Settings → Security Settings → General Security Settings → API Credentials and Keys.
- API Login ID hiển thị ở trên cùng.
- Transaction Key: chọn "New Transaction Key", xác nhận, và sao chép ngay (nó chỉ hiển thị một lần).
- Signature Key: chọn "New Signature Key", xác nhận, và sao chép ngay lập tức.
Account → Settings → Security Settings → API Credentials and Keys
Thêm webhook
1. Account → Settings → Business Settings → Webhooks, thêm một endpoint.
2. Đặt URL endpoint thành địa chỉ webhook dự án của bạn (bên dưới).
3. Đăng ký các sự kiện. Thanh toán một lần: net.authorize.payment.authorization.created, authcapture.created, capture.created, priorAuthCapture.created, refund.created, void.created, và các sự kiện fraud.* (held, approved, declined). Gói đăng ký (Automated Recurring Billing): các sự kiện net.authorize.customer.subscription.*. Các lần gia hạn đến dưới dạng authcapture.created, đã được bao gồm. Sự kiện thừa là vô hại.
4. Lưu. Authorize.Net ký mỗi lần gửi bằng Signature Key của bạn.
```
https://api.coinmoebius.com/webhook/authorizenet/<your project id>
```
Account → Settings → Business Settings → Webhooks
Coin Moebius ghi lại mỗi id sự kiện một lần và bỏ qua các bản trùng, nên các webhook phát lại được xử lý hộ bạn.
Kiểm tra với thẻ sandbox
Thẻ sandbox không bao giờ tính phí một thẻ thật. Dùng bất kỳ ngày hết hạn tương lai nào (ví dụ 12/2030) và bất kỳ CVV nào (3 chữ số, hoặc 4 cho American Express).
Mạng lưới Thẻ
Visa 4111111111111111
Mastercard 5424000000000015
American Express 370000000000002
Discover 6011000000000012
Kết nối trong bảng điều khiển
Thêm nhà cung cấp → Authorize.Net. Nhập Success URL, Cancel URL, và nhóm Live (API Login ID, Transaction Key, Signature Key). Thêm nhóm Sandbox tùy chọn để kiểm tra. Nhóm Sandbox là tất-cả-hoặc-không-gì: cả ba trường, hoặc không trường nào. Live và sandbox được kiểm tra riêng.

Mạng lưới	Thẻ
Visa	4111111111111111
Mastercard	5424000000000015
American Express	370000000000002
Discover	6011000000000012

Sau khi bạn kết nối

Chạy một khoản thanh toán thử nghiệm trước khi chạy thật:

Tạo một sản phẩm và đặt Môi trường của nó thành Testing. Việc đó chạy sản phẩm trên thông tin xác thực sandbox của bạn, nên bạn có thể đặt một đơn hàng đầy đủ mà không di chuyển tiền. (Nếu bạn bỏ qua bộ sandbox, một sản phẩm Testing sẽ quay về live, nên hãy thêm nó trước.)
Đặt nút mua lên một trang (một tệp HTML cục bộ cũng được) trỏ về dự án của bạn.
Hoàn tất thanh toán với một thẻ thử nghiệm sandbox ở trên.
Mở tab Giao dịch. Một hàng mới xuất hiện, gắn nhãn Testing. Khi trạng thái của nó đạt succeeded, thông tin xác thực và webhook của bạn đều hoạt động trọn vẹn đầu cuối.

Chuyển Môi trường sản phẩm sang Live khi bạn sẵn sàng cho thanh toán thật.

Khắc phục sự cố

Bắt đầu với Xác minh. Trong bảng điều khiển, nhấp Xác minh (hoặc Xác minh thông tin xác thực thử nghiệm cho bộ sandbox) để kiểm tra API Login ID và Transaction Key của bạn.

Xác minh thất bại.

API Login ID và Transaction Key phải là cặp từ cùng một tài khoản (live hoặc sandbox). Sao chép lại cả hai.

Xác minh chữ ký thất bại.

Signature Key là một giá trị khác với Transaction Key. Sao chép Signature Key từ cùng màn hình. Lược đồ giống hệt ở sandbox và live.

Thanh toán hoàn tất nhưng đơn hàng vẫn đang chờ.

Xác nhận URL webhook khớp chính xác và rằng bạn đã đăng ký các sự kiện thanh toán.

Một sản phẩm thử nghiệm đã tính phí một thẻ live.

Một sản phẩm đánh dấu là thử nghiệm sẽ quay về thông tin xác thực live của bạn khi không có bộ sandbox đầy đủ nào được cấu hình. Thêm cả ba trường sandbox, hoặc bỏ đánh dấu thử nghiệm cho sản phẩm.

Xác nhận nó trọn vẹn đầu cuối.

Authorize.Net chỉ ping các webhook không hoạt động: đặt endpoint ở trạng thái không hoạt động, gửi một ping, rồi kích hoạt lại nó, và quan sát đơn hàng cập nhật.

Cần biết

Token tồn tại ngắn. Token biểu mẫu được lưu trữ tồn tại khoảng 15 phút. Chúng tôi tạo một token mới cho mỗi khâu thanh toán.

Tiền tệ. Authorize.Net chủ yếu là một cổng của Mỹ, dùng USD. Hỗ trợ ngoài USD phụ thuộc vào thỏa thuận với đơn vị xử lý của bạn.

Xoay khóa. Tạo một Transaction Key hoặc Signature Key mới bất cứ lúc nào, rồi dán nó vào. Các trường bí mật vẫn để trống khi chỉnh sửa.

Câu hỏi? Join our Discord

Authorize.Net