Đến nội dung chính
notes.vinhnq.com

Tìm kiếm

System DesignSenior24 phút đọc

Tích hợp cổng thanh toán kiểu VNPay: redirect, chữ ký và IPN

Ôn 14 thẻ
Trong bài này

Cụm bài Tích hợp cổng thanh toán: 1. Redirect, chữ ký và IPN · 2. IPN tới muộn, đối soát và failure mode

Phần lớn bug thanh toán không nằm ở lời gọi API của cổng, mà ở những gì xảy ra xung quanh: khách đóng tab giữa chừng, cổng gọi callback ba lần, số tiền lệch 100 lần vì quên đơn vị. Bài này đi trọn luồng redirect kiểu VNPay (Momo, ZaloPay, OnePay, Stripe Checkout cùng khuôn) theo sơ đồ khoá học, bước 1 tới 9.2.3, gồm mô hình dữ liệu, ký URL, IPN, return URL và bảo mật. Phần 2 lo phần vận hành: IPN tới sau khi đã nhả chỗ, đối soát, test trên sandbox và bảng failure mode.

Nên đọc trước: Idempotency phần 2 (handler IPN tối giản) và bài encoding, hash và chữ ký (cơ sở HMAC). Ví dụ là booking của cụm bài thiết kế database đặt vé, áp dụng y nguyên cho đơn hàng. Chọn cổng nào (thứ tự bảo mật, độ tin cậy, hiệu năng, độ phức tạp; tiêu chí, phí, PCI DSS hiện hành) và timeout, retry, circuit breaker, webhook nằm ở cụm Tích hợp bên thứ ba.

Các tham số vnp_* theo tài liệu tích hợp VNPay phiên bản 2.1.0. Spec có thể đổi; luôn đối chiếu tài liệu hiện hành cổng cấp khi đăng ký merchant. Code ký URL đã chạy thử với JDK 21, SQL trên PostgreSQL 16.

1. Các bên và luồng từ 1 đến 9.2.3

Ý chính: bảy bên tham gia, nhưng backend chỉ tin hai thứ: số tiền do chính nó tính (bước 2–4) và IPN có chữ ký (bước 9.1). Mọi thứ đi qua trình duyệt đều sửa được hoặc có thể không tới.

sequenceDiagram
    actor U as Khách
    participant FE as Frontend
    participant BE as Backend
    participant DB as Database
    participant PF as Trang cổng (PGW FE)
    participant PB as Backend cổng (PGW BE)
    participant BK as Ngân hàng
    U->>FE: 1. Đặt vé
    FE->>BE: 2. Checkout
    BE->>DB: 3. Lưu booking PENDING_PAYMENT và payment PENDING
    BE-->>FE: 4. URL thanh toán đã ký
    FE->>PF: 5. Redirect sang trang cổng
    U->>PF: 6. Nhập thông tin thẻ/ví
    PF->>BK: 7. Xác thực (OTP)
    BK-->>PB: 8. Kết quả trừ tiền
    PB->>BE: 9.1.1 IPN server-to-server
    BE->>DB: 9.1.2 Xác minh, cập nhật trạng thái
    BE-->>PB: mã phản hồi
    PB-->>PF: 9.2.1 Kết quả
    PF->>FE: 9.2.2 Redirect về return URL
    FE->>BE: 9.2.3 Hỏi trạng thái booking
    BE-->>FE: trạng thái trong DB
Bước Ai làm Tin được tới đâu
2–4 Backend tính số tiền, tạo bản ghi, ký URL Số tiền do backend tính, không lấy từ client
5–8 Khách và cổng, ngoài tầm kiểm soát của mình Khách có thể bỏ ngang ở bất kỳ đâu
9.1 Cổng gọi thẳng backend (IPN) Nguồn sự thật, có chữ ký, cổng gửi lại khi không nhận được phản hồi hợp lệ
9.2 Trình duyệt quay về return URL Chỉ để hiển thị; tham số sửa được, và có thể không bao giờ tới

Hai đường 9.1 và 9.2 chạy song song, không có thứ tự. Return URL có thể tới trước IPN vài giây. Vì vậy ở bước 9.2.3 frontend hỏi backend và chấp nhận trạng thái “đang xử lý”, không suy ra kết quả từ tham số URL.

Luồng tiền khác luồng thông tin

Ý chính: “đã thanh toán” (IPN thành công, ngày T) và “tiền đã về” (settlement, T+1) là hai sự kiện khác nhau. Báo cáo doanh thu và sổ cái phải tách hai thứ này.

  • Ngày T: tiền từ tài khoản khách chuyển vào tài khoản của cổng tại ngân hàng của khách; cổng báo kết quả cho backend (IPN).
  • Ngày T+1: cổng quyết toán (settlement — chuyển tiền thật, đã trừ phí) sang tài khoản ngân hàng của merchant.
  • Giữa hai ngân hàng và cổng có đối soát hai phía (phần 2).
flowchart LR
    K[Tài khoản khách] -->|"Ngày T: chuyển tiền"| G[Tài khoản cổng tại ngân hàng khách]
    G -->|báo kết quả| P[Cổng thanh toán]
    P -->|IPN| M[Backend merchant]
    P -->|"Ngày T+1: quyết toán trừ phí"| A[Tài khoản ngân hàng merchant]

2. Mô hình dữ liệu: booking và payment attempt

Ý chính: đừng gắn cột payment_status thẳng vào booking. Một booking có nhiều lần thử thanh toán (payment attempt), mỗi lần thử là một dòng payment với mã tham chiếu riêng.

Ví dụ: thẻ bị từ chối rồi thử ví, URL hết hạn rồi bấm lại. Bảng gateway_callback lưu nguyên văn mọi callback để debug và đối soát.

CREATE TABLE payment (
  payment_id     bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
  booking_id     bigint      NOT NULL REFERENCES booking,
  txn_ref        text        NOT NULL UNIQUE,          -- vnp_TxnRef: một mã cho mỗi lần thử
  gateway        text        NOT NULL DEFAULT 'VNPAY',
  amount         bigint      NOT NULL CHECK (amount > 0),   -- VND, chưa nhân 100
  status         text        NOT NULL DEFAULT 'PENDING'
                 CHECK (status IN ('PENDING', 'SUCCEEDED', 'FAILED', 'EXPIRED', 'REFUND_PENDING', 'REFUNDED')),
  pay_url        text        NOT NULL,
  expires_at     timestamptz NOT NULL,                 -- khớp vnp_ExpireDate
  gateway_txn_no text,                                 -- vnp_TransactionNo
  response_code  text,
  bank_code      text,
  paid_at        timestamptz,
  created_at     timestamptz NOT NULL DEFAULT now(),
  updated_at     timestamptz NOT NULL DEFAULT now(),
  UNIQUE (gateway, gateway_txn_no)
);
-- Tối đa một lần thử đang mở cho mỗi booking
CREATE UNIQUE INDEX payment_one_pending_idx ON payment (booking_id) WHERE status = 'PENDING';
CREATE INDEX payment_pending_expiry_idx ON payment (expires_at) WHERE status = 'PENDING';

-- Lưu nguyên văn mọi callback trước khi xử lý: để debug và để đối soát
CREATE TABLE gateway_callback (
  callback_id  bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
  gateway      text        NOT NULL,
  channel      text        NOT NULL CHECK (channel IN ('IPN', 'RETURN', 'QUERY')),
  txn_ref      text,
  payload      jsonb       NOT NULL,
  signature_ok boolean     NOT NULL,
  reply_code   text,
  received_at  timestamptz NOT NULL DEFAULT now()
);

Hai state machine (máy trạng thái: danh sách trạng thái và các bước chuyển được phép) chạy cạnh nhau. Booking:

stateDiagram-v2
    [*] --> PENDING_PAYMENT
    PENDING_PAYMENT --> PAID: payment SUCCEEDED
    PENDING_PAYMENT --> EXPIRED: hết hạn, không còn payment đang mở
    PENDING_PAYMENT --> CANCELLED: khách huỷ
    PAID --> TICKETED: xuất vé
    TICKETED --> CANCELLED: huỷ và hoàn tiền

Payment (một lần thử):

stateDiagram-v2
    [*] --> PENDING
    PENDING --> SUCCEEDED: IPN hoặc truy vấn báo thành công
    PENDING --> FAILED: IPN hoặc truy vấn báo thất bại
    PENDING --> EXPIRED: quá hạn, truy vấn xác nhận chưa trả
    EXPIRED --> SUCCEEDED: IPN tới muộn
    SUCCEEDED --> REFUND_PENDING: booking không còn giữ được
    REFUND_PENDING --> REFUNDED: cổng xác nhận hoàn

Chú ý cạnh EXPIRED → SUCCEEDED: tiền thật đã bị trừ thì phải ghi nhận, dù mình đã coi lần thử là hết hạn. Đây là nguồn của case study IPN tới muộn ở phần 2.

Tách bảng cũng là tách code: Payment là một bounded context (vùng nghiệp vụ có model riêng) riêng, Booking chỉ gọi nó qua một port. Khung package cho cách chia Booking, Flight, Payment có ở DDD và cấu trúc package.

3. Bước 4: tạo URL thanh toán có chữ ký

Ý chính: backend trả cho frontend một URL sang trang cổng, kèm chữ ký HMAC-SHA512 tính bằng hash secret chỉ mình và cổng biết. Cổng tính lại chữ ký, nên ai sửa số tiền trên URL sẽ làm chữ ký sai.

HMAC là mã xác thực tính từ nội dung và một khoá bí mật: không có khoá thì không tạo được chữ ký đúng. Cách ký:

  1. Sắp tham số theo tên (trừ vnp_SecureHash), bỏ tham số rỗng.
  2. Nối thành ten=giatri_da_url_encode bằng &.
  3. Tính HMAC-SHA512 với hash secret, ra chuỗi hex.

Ba tham số dễ sai: vnp_Amount là số tiền nhân 100; vnp_TxnRef không được trùng; vnp_CreateDate/vnp_ExpireDate dạng yyyyMMddHHmmss theo giờ Việt Nam (GMT+7).

final class Signer {
    private final byte[] secret;
    Signer(String secret) { this.secret = secret.getBytes(StandardCharsets.UTF_8); }

    static String canonical(SortedMap<String, String> params) {
        return params.entrySet().stream()
                .filter(e -> e.getValue() != null && !e.getValue().isEmpty())
                .map(e -> e.getKey() + "=" + URLEncoder.encode(e.getValue(), StandardCharsets.US_ASCII))
                .collect(Collectors.joining("&"));
    }

    String sign(SortedMap<String, String> params) {
        try {
            Mac mac = Mac.getInstance("HmacSHA512");
            mac.init(new SecretKeySpec(secret, "HmacSHA512"));
            return HexFormat.of().formatHex(mac.doFinal(canonical(params).getBytes(StandardCharsets.US_ASCII)));
        } catch (GeneralSecurityException e) {
            throw new IllegalStateException(e);
        }
    }

    boolean verify(Map<String, String> received) {
        SortedMap<String, String> fields = new TreeMap<>(received);
        String given = fields.remove("vnp_SecureHash");
        fields.remove("vnp_SecureHashType");
        if (given == null) return false;
        byte[] expected = sign(fields).getBytes(StandardCharsets.US_ASCII);
        return MessageDigest.isEqual(expected, given.toLowerCase(Locale.ROOT).getBytes(StandardCharsets.US_ASCII));
    }
}
Bảng tham số vnp_*, hàm buildPayUrl và kết quả chạy thử
Tham số Ý nghĩa Ghi chú
vnp_Version, vnp_Command 2.1.0, pay
vnp_TmnCode Mã merchant Cổng cấp khi đăng ký
vnp_Amount Số tiền nhân 100 6.820.000đ gửi 682000000
vnp_CurrCode VND
vnp_TxnRef Mã tham chiếu của lần thử Không được trùng
vnp_OrderInfo Mô tả đơn Không dấu, tránh ký tự đặc biệt
vnp_ReturnUrl URL trình duyệt quay về Lấy từ cấu hình server, không nhận từ client
vnp_IpAddr IP của khách Lấy đúng IP thật sau reverse proxy
vnp_CreateDate, vnp_ExpireDate yyyyMMddHHmmss theo giờ Việt Nam (GMT+7) Hạn của URL
vnp_SecureHash Chữ ký Tính trên mọi tham số còn lại
static final DateTimeFormatter VNP_TIME =
        DateTimeFormatter.ofPattern("yyyyMMddHHmmss").withZone(ZoneId.of("Asia/Ho_Chi_Minh"));

String buildPayUrl(Payment p, String clientIp, Instant now) {
    SortedMap<String, String> q = new TreeMap<>();
    q.put("vnp_Version", "2.1.0");
    q.put("vnp_Command", "pay");
    q.put("vnp_TmnCode", cfg.tmnCode());
    q.put("vnp_Amount", Long.toString(Math.multiplyExact(p.amount(), 100L)));  // đơn vị của cổng
    q.put("vnp_CurrCode", "VND");
    q.put("vnp_TxnRef", p.txnRef());
    q.put("vnp_OrderInfo", "Thanh toan booking " + p.bookingCode());
    q.put("vnp_OrderType", "other");
    q.put("vnp_Locale", "vn");
    q.put("vnp_ReturnUrl", cfg.returnUrl());
    q.put("vnp_IpAddr", clientIp);
    q.put("vnp_CreateDate", VNP_TIME.format(now));
    q.put("vnp_ExpireDate", VNP_TIME.format(p.expiresAt()));
    String query = q.entrySet().stream()
            .map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.US_ASCII) + "="
                    + URLEncoder.encode(e.getValue(), StandardCharsets.US_ASCII))
            .collect(Collectors.joining("&"));
    return cfg.payUrl() + "?" + query + "&vnp_SecureHash=" + signer.sign(q);
}

Chạy thử bản đầy đủ với JDK 21 (khoá giả):

  • URL sinh ra có vnp_Amount=682000000, vnp_CreateDate=20261118100000 cho thời điểm 03:00 UTC.
  • verify trả true với tham số gốc, false khi sửa vnp_Amount thành 100, vẫn true khi chữ ký viết hoa.
  • Math.multiplyExact ném ArithmeticException khi tràn số.

Quy tắc khác cho bước này:

  • Số tiền lấy từ DB, không từ request. Frontend chỉ gửi booking_code.
  • Hash secret nằm trong secret manager (Vault, AWS Secrets Manager), không trong application.yml hay repo; có quy trình xoay khoá.
  • vnp_ExpireDate ngắn hơn hạn giữ chỗ: URL hết hạn sau 15 phút thì ghế giữ 20 phút, để khách trả ở phút 14 vẫn còn ghế (phần 2).
  • IP khách lấy từ X-Forwarded-For chỉ khi qua reverse proxy mình tin, và lấy địa chỉ do proxy của mình thêm vào, không lấy phần tử đầu do client tự gửi.

4. Bước 9.1: handler IPN

Ý chính: IPN (Instant Payment Notification) là request GET có chữ ký từ server cổng tới IPN URL đã đăng ký. Handler kiểm theo thứ tự cố định, chuyển trạng thái idempotent trong một transaction, rồi trả RspCode để cổng biết có gửi lại không.

IPN URL cấu hình ở phía merchant, không gửi theo từng giao dịch như return URL. Request mang vnp_TxnRef, vnp_Amount, vnp_ResponseCode, vnp_TransactionStatus, vnp_TransactionNo, vnp_BankCode, vnp_PayDate, vnp_SecureHash. Backend trả JSON {"RspCode": "..", "Message": ".."}.

RspCode Khi nào Cổng làm gì
00 Đã ghi nhận kết quả (thành công hoặc thất bại) Ngừng gửi
01 Không tìm thấy đơn theo vnp_TxnRef Ghi nhận lỗi phía merchant
02 Đơn đã được xác nhận trước đó Ngừng gửi
04 Số tiền không khớp Ghi nhận lỗi
97 Chữ ký không hợp lệ Ghi nhận lỗi
99 Lỗi khác (DB chết, exception) Gửi lại sau

Thứ tự kiểm tra: lưu nguyên văn → chữ ký → đơn → số tiền → trạng thái → cập nhật.

@RestController
@RequiredArgsConstructor
class VnpayIpnController {
    private final Signer signer;
    private final CallbackLog callbackLog;
    private final PaymentResultService results;

    @GetMapping("/payments/vnpay/ipn")
    IpnReply ipn(@RequestParam Map<String, String> params) {
        boolean signatureOk = signer.verify(params);
        long logId = callbackLog.save("IPN", params, signatureOk);            // giao dịch riêng, luôn được lưu
        IpnReply reply;
        try {
            reply = !signatureOk ? IpnReply.INVALID_SIGNATURE
                                 : results.apply(GatewayResult.fromVnpay(params));
        } catch (Exception e) {
            log.error("IPN failed txnRef={}", params.get("vnp_TxnRef"), e);
            reply = IpnReply.UNKNOWN_ERROR;                                   // 99: để cổng gửi lại
        }
        callbackLog.reply(logId, reply.rspCode());
        return reply;
    }
}

record IpnReply(@JsonProperty("RspCode") String rspCode, @JsonProperty("Message") String message) {
    static final IpnReply CONFIRMED = new IpnReply("00", "Confirm Success");
    static final IpnReply ORDER_NOT_FOUND = new IpnReply("01", "Order not found");
    static final IpnReply ALREADY_CONFIRMED = new IpnReply("02", "Order already confirmed");
    static final IpnReply INVALID_AMOUNT = new IpnReply("04", "Invalid amount");
    static final IpnReply INVALID_SIGNATURE = new IpnReply("97", "Invalid signature");
    static final IpnReply UNKNOWN_ERROR = new IpnReply("99", "Unknown error");
}

PaymentResultService.apply là hàm dùng chung cho IPN và job truy vấn giao dịch (phần 2). Nó idempotent (gọi lại nhiều lần cho cùng kết quả như một lần) nhờ điều kiện trạng thái trong WHERE, và chạy trong một transaction:

-- 1. Chuyển payment, chỉ từ trạng thái chưa chốt (EXPIRED vẫn nhận: tiền thật đã bị trừ)
UPDATE payment
SET    status = 'SUCCEEDED', gateway_txn_no = :txnNo, response_code = '00',
       bank_code = :bank, paid_at = :payDate, updated_at = now()
WHERE  txn_ref = :txnRef AND status IN ('PENDING', 'EXPIRED')
RETURNING booking_id;
-- 0 dòng: đã xử lý trước đó → trả 02 (hoặc 00), không làm gì thêm

-- 2. Chuyển booking, chỉ từ PENDING_PAYMENT, có version và history (xem bài booking/ledger)
UPDATE booking
SET    status = 'PAID', paid_at = :payDate, version = version + 1, updated_at = now()
WHERE  booking_id = :bookingId AND status = 'PENDING_PAYMENT';

-- 3a. 1 dòng: ghế HELD → BOOKED, ghi sổ cái, chèn outbox "xuất vé"
-- 3b. 0 dòng: booking đã hết hạn hoặc bị huỷ → IPN tới muộn (phần 2)
  • Thành công khi cả hai: vnp_ResponseCode = 00 và vnp_TransactionStatus = 00.
  • Kết quả thất bại cũng ghi (payment FAILED) và trả 00, để cổng ngừng gửi.
Lưu callback ở transaction riêng hay chung, và kết quả chạy thử handler

Chạy thử: IPN thành công lần đầu chuyển payment sang SUCCEEDED và booking sang PAID version 2; cùng IPN gửi lại cập nhật 0 dòng ở cả hai câu; tạo lần thử PENDING thứ hai cho cùng booking bị partial unique index từ chối.

5. Bước 9.2: return URL và màn hình kết quả

Ý chính: trang return chỉ hiển thị trạng thái thật lấy từ backend; không ghi gì xuống DB từ đường này.

  • Đọc vnp_TxnRef để biết booking nào, gọi GET /bookings/{code}, hiển thị.
  • Còn PENDING_PAYMENT (IPN chưa tới): hiện “đang xác nhận thanh toán”, hỏi lại với backoff (1s, 2s, 4s), sau đó đưa khách tới trang “đơn của tôi”.
  • Có thể kiểm chữ ký tham số return để báo sớm.

Backend có thể coi việc trình duyệt quay về là tín hiệu để truy vấn giao dịch sớm cho đúng lần thử đó (phần 2), thay vì chờ job định kỳ. Kết quả vẫn đi qua hàm apply.

6. HTTPS và bảo mật

Ý chính: slide khoá học chỉ ghi “HTTPS”; thực tế cần thêm chữ ký trên mọi thứ nhận vào, chống phát lại bằng state machine, và không để dữ liệu thẻ chạm vào hệ thống của mình.

  • HTTPS ở mọi chặng: return URL, IPN URL, API truy vấn. IPN qua HTTP thường cho kẻ ở giữa đọc và phát lại.
  • Kiểm chữ ký mọi thứ nhận vào, so bằng hàm thời gian hằng (MessageDigest.isEqual: luôn so hết mọi byte) để không lộ chữ ký qua thời gian phản hồi.
  • Chữ ký không chống phát lại: IPN hợp lệ gửi lại vẫn đúng chữ ký. Chống phát lại là việc của state machine và unique constraint.
  • Không chạm vào dữ liệu thẻ: xem khối dưới.
  • Return URL cố định trong cấu hình, không nhận từ client (tránh open redirect — bị lợi dụng để chuyển khách sang trang giả).
  • Che log: không log hash secret; log tham số IPN được (không có số thẻ), nhưng che email, số điện thoại nếu có.
  • Lọc IP nguồn của IPN theo danh sách cổng công bố (nếu có) là lớp phụ, không thay chữ ký.

Bài tập

Bài 1: Review một handler IPN

Đề: một handler nhận return URL, nếu vnp_ResponseCode == "00" thì cập nhật booking PAID theo vnp_TxnRef bằng UPDATE booking SET status = 'PAID' WHERE booking_code = ?, rồi gửi email xác nhận, rồi redirect sang trang cảm ơn. Liệt kê lỗi và sửa.

Lời giải bài 1: tám lỗi
  1. Dùng return URL làm nguồn sự thật: chuyển sang IPN, return chỉ hiển thị.
  2. Không kiểm chữ ký: thêm verify trước mọi thứ.
  3. Không kiểm số tiền (và đơn vị nhân 100): so vnp_Amount / 100 với payment.amount.
  4. Không kiểm vnp_TransactionStatus: kiểm cả hai mã.
  5. UPDATE không điều kiện trạng thái: booking EXPIRED hay CANCELLED cũng bị đè thành PAID; thêm AND status = 'PENDING_PAYMENT' và xử lý nhánh 0 dòng.
  6. Mã booking làm txn_ref: không thử lại được; tách bảng payment.
  7. Gửi email đồng bộ trước khi commit: chuyển qua outbox.
  8. Không ghi sổ cái, không ghi lịch sử, không lưu callback: thêm cả ba trong cùng transaction (callback lưu riêng).

Bài 2: Viết test cố định cho chữ ký

Đề: viết test bảo đảm mọi thay đổi trong code ký đều bị phát hiện, kể cả đổi thư viện encode.

Lời giải bài 2: test với fixture

Lấy một bộ tham số và chữ ký đã biết đúng (từ tài liệu hoặc giao dịch sandbox thật, lưu làm fixture), rồi kiểm ba điều:

  • sign(fixture) ra đúng chữ ký mẫu.
  • verify trả true với fixture và false khi đổi một ký tự của bất kỳ tham số nào.
  • Một giá trị có dấu cách và ký tự đặc biệt (/, :, &) ký ra đúng như cổng.

Chạy test này trong CI; nó rẻ và bắt được lỗi “invalid checksum” trước khi lên production.

Ghi nhớ

  • Giải thích được vì sao IPN là nguồn sự thật còn return URL chỉ để hiển thị, và vì sao hai đường không có thứ tự.
  • Vẽ được bảng payment tách khỏi booking, hai state machine và cạnh EXPIRED → SUCCEEDED.
  • Kể được ba bước ký URL và ba nguồn “invalid checksum” hay gặp.
  • Đọc thuộc thứ tự kiểm của handler IPN và ý nghĩa 00, 01, 02, 04, 97, 99.
  • Biết khi nào việc gì phải ra khỏi handler IPN (outbox) và vì sao.

Câu hỏi phỏng vấn

Junior

IPN là gì, khác return URL thế nào?

IPN là callback server-to-server có chữ ký, là nguồn sự thật; return URL là trình duyệt quay về, chỉ để hiển thị.

IPN (Instant Payment Notification) đi thẳng từ cổng tới backend, cổng gửi lại nếu không nhận được phản hồi hợp lệ. Return URL có tham số sửa được và có thể không bao giờ tới nếu khách đóng tab.

Vì sao số tiền phải do backend tính chứ không lấy từ frontend?

Vì frontend nằm trong tay người dùng: sửa request để trả 1.000đ cho vé 6 triệu chỉ mất vài giây.

Backend tính số tiền từ booking trong DB và ký vào URL. Cổng kiểm chữ ký nên số tiền không sửa được trên đường đi, và lúc nhận IPN backend so lại số tiền với DB.

Mid

Chữ ký HMAC trên URL thanh toán bảo vệ được gì và không bảo vệ được gì?

Bảo vệ toàn vẹn và nguồn gốc; không chống phát lại, không giữ bí mật nội dung, vô dụng nếu lộ secret.

Không có hash secret thì không ai sửa được số tiền, mã đơn hay return URL, và IPN giả không có chữ ký đúng. Phát lại thông điệp hợp lệ cần state machine và unique constraint; bí mật nội dung cần HTTPS; lộ secret cần secret manager và xoay khoá.

Handler IPN nên kiểm tra theo thứ tự nào và trả mã gì?

Lưu nguyên văn → chữ ký (97) → đơn (01) → số tiền (04) → đã chốt (02) → chuyển trạng thái (00); lỗi hệ thống trả 99 để cổng gửi lại.

So số tiền đúng đơn vị (chia 100). Kết quả thất bại cũng ghi lại và trả 00 để cổng ngừng gửi.

Vì sao tách bảng payment khỏi booking?

Vì một booking có nhiều lần thử thanh toán, và mỗi lần thử cần mã tham chiếu riêng.

Thẻ bị từ chối, URL hết hạn, đổi phương thức đều tạo lần thử mới; cổng không nhận mã trùng, và mỗi callback phải khớp đúng một lần thử. Tách bảng cho lịch sử rõ, cho phép partial unique “tối đa một lần thử đang mở”, và xử lý được hai lần thử cùng thành công.

Senior

Bạn nghĩ gì khi được yêu cầu gửi email xác nhận ngay trong handler IPN?

Không nên: ghi outbox trong cùng transaction chuyển trạng thái, worker gửi email sau commit.

Email không vào được transaction DB: gửi trước commit thì có email cho đơn rollback, gửi sau commit thì crash giữa chừng là mất email. Nó còn làm handler chậm, cổng timeout rồi gửi lại. Worker gửi email với idempotency theo booking; handler IPN chỉ chuyển trạng thái và trả lời nhanh.

Khách báo “trả tiền rồi mà web báo thất bại”. Bạn điều tra theo thứ tự nào?

Bắt đầu từ bảng gateway_callback theo txn_ref, song song hỏi cổng qua API truy vấn, cuối cùng kiểm frontend.

  • IPN có tới không, chữ ký hợp lệ không, mình trả mã gì.
  • Không có IPN: kiểm IPN URL đăng ký với cổng và log reverse proxy. Trả 97: nghi lệch cách encode khi ký. Trả 04: nghi đổi đơn vị.
  • Gọi API truy vấn giao dịch để biết sự thật phía cổng, chạy hàm apply nếu cổng báo đã trả.
  • Frontend: trang return có hỏi lại backend khi IPN tới chậm không, hay kết luận từ tham số URL.

Từ vựng tiếng Anh

Term Phát âm Nghĩa Ví dụ câu tiếng Anh dùng trong phỏng vấn
payment gateway /ˈpeɪ.mənt ˈɡeɪt.weɪ/ cổng thanh toán “We integrate the payment gateway through a redirect flow.”
redirect flow /riːˈdaɪ.rekt floʊ/ luồng chuyển hướng “In a redirect flow the card details never touch our servers.”
return URL /rɪˈtɝːn juː ɑːr el/ URL quay về “The return URL only drives the UI; it never changes payment state.”
server-to-server callback /ˈsɝː.vər tə ˈsɝː.vər ˈkɔːl.bæk/ gọi lại giữa hai server “The IPN is a signed server-to-server callback.”
signature /ˈsɪɡ.nə.tʃər/ chữ ký “We verify the HMAC signature before reading any parameter.”
constant-time comparison /ˈkɑːn.stənt taɪm kəmˈper.ə.sən/ so sánh thời gian hằng “Signatures are checked with a constant-time comparison.”
payment attempt /ˈpeɪ.mənt əˈtempt/ lần thử thanh toán “Each payment attempt gets its own transaction reference.”
PCI DSS scope /piː siː aɪ diː es es skoʊp/ phạm vi tuân thủ PCI DSS “The redirect keeps our PCI DSS scope minimal.”
hash secret /hæʃ ˈsiː.krət/ khoá bí mật dùng để ký “The hash secret lives in a secret manager and is rotated.”
canonical string /kəˈnɑː.nɪ.kəl strɪŋ/ chuỗi chuẩn hoá đem đi ký “Most checksum errors come from building a different canonical string.”

Ghi chép dựa trên khoá Advanced Backend (Ronin Engineer), viết lại theo cách hiểu của mình.