Payments Training Hub
Payment page 1 Payment page NOW 2 Token vault 3 Fraud screening 4 Retry logic and webhooks keep payments 5 Merchant system listens 6 Good reporting The payment page is the customer facing part of a gateway, and it must be fast, secure and easy to use. Step 1 of 6 Payment page 1 NOW Payment page 2 Token vault 3 Fraud screening 4 Retry logic and webhooks keep payments 5 Merchant system listens 6 Good reporting The payment page is the customer facing part of a gateway, and it must be fast, secure and easy to use. Step 1 of 6
Token vault 1 Payment page 2 Token vault NOW 3 Fraud screening 4 Retry logic and webhooks keep payments 5 Merchant system listens 6 Good reporting The token vault is the secure store where a gateway keeps card details after the first payment. Step 2 of 6 Token vault 1 Payment page 2 NOW Token vault 3 Fraud screening 4 Retry logic and webhooks keep payments 5 Merchant system listens 6 Good reporting The token vault is the secure store where a gateway keeps card details after the first payment. Step 2 of 6
Fraud screening 1 Payment page 2 Token vault 3 Fraud screening NOW 4 Retry logic and webhooks keep payments 5 Merchant system listens 6 Good reporting Fraud screening protects the merchant from stolen cards, fake orders and account takeover. Step 3 of 6 Fraud screening 1 Payment page 2 Token vault 3 NOW Fraud screening 4 Retry logic and webhooks keep payments 5 Merchant system listens 6 Good reporting Fraud screening protects the merchant from stolen cards, fake orders and account takeover. Step 3 of 6
Retry logic and webhooks keep payments moving 1 Payment page 2 Token vault 3 Fraud screening 4 Retry logic and webhooks keep payments NOW 5 Merchant system listens 6 Good reporting Retry logic and webhooks keep payments moving when something fails. Step 4 of 6 Retry logic and webhooks keep payments moving 1 Payment page 2 Token vault 3 Fraud screening 4 NOW Retry logic and webhooks keep payments 5 Merchant system listens 6 Good reporting Retry logic and webhooks keep payments moving when something fails. Step 4 of 6
Merchant system listens for these events 1 Payment page 2 Token vault 3 Fraud screening 4 Retry logic and webhooks keep payments 5 Merchant system listens NOW 6 Good reporting The merchant system listens for these events and updates the order status automatically, so the warehouse ships only after a confirmed capture. Step 5 of 6 Merchant system listens for these events 1 Payment page 2 Token vault 3 Fraud screening 4 Retry logic and webhooks keep payments 5 NOW Merchant system listens 6 Good reporting The merchant system listens for these events and updates the order status automatically, so the warehouse ships only after a confirmed capture. Step 5 of 6
Good reporting 1 Payment page 2 Token vault 3 Fraud screening 4 Retry logic and webhooks keep payments 5 Merchant system listens 6 Good reporting NOW Good reporting turns a gateway from a simple pipe into a control point for the whole payment operation. Step 6 of 6 Good reporting 1 Payment page 2 Token vault 3 Fraud screening 4 Retry logic and webhooks keep payments 5 Merchant system listens 6 NOW Good reporting Good reporting turns a gateway from a simple pipe into a control point for the whole payment operation. Step 6 of 6

Steps of this lesson, in order.

0:00 / 3:46 Step 1 of 6

Gateway Services

Payment Gateway Architecture, Lesson 2 of 7, Narration 3:46, D09 Payment architecture and technology

ReconciliationIdempotencyChargeback

What you will learn

Your objective. By the end of this lesson, you will be able to explain gateway services. The payment page is the customer facing part of a gateway, and it must be fast, secure and easy to use.

Why it matters. This matters because the architecture decides what the bank can build, how fast it can change, and where a payment can fail. Most payment requirements live in the architecture.

Chapter objective: Learner explains payment gateway architecture, including checkout, token vault, routing, retries, and settlement, and designs a gateway flow for an online merchant. Learner practises this skill on realistic banking cases, explaining the reasoning clearly and using correct terminology throughout the work.

Key learning points

  • Payment page
  • Token vault
  • Fraud screening
  • Retry logic and webhooks keep payments moving
  • Merchant system listens for these events
  • Good reporting

Key terms

Reconciliation: The process of comparing records from two sources, such as a bank statement and an internal ledger, to confirm they agree.

Idempotency: The property that repeating the same request has the same effect as sending it once. In payments, an idempotency key lets a client safely retry a request after a timeout without creating a duplicate...

Chargeback: A dispute raised by a cardholder through the issuer to reverse a card payment, for example for fraud, non delivery or a duplicate charge.

Banking architecture diagram showing Gateway Services.

Practise this lesson

Exercise

Map the payment in this lesson through the hub components.

Use the hub components and their order in this lesson.

  1. What to do. List each component the payment passes through, what it does, and what happens if it fails.

Correct result. The payment enters through a channel, passes the gateway, validation, fraud and sanctions checks, routing, and the ledger, then leaves through the right clearing system. A failure at any component stops or holds the payment, and the hub must record where it stopped.

Why. The hub is where most payment requirements live. If you cannot map a payment through it, you cannot specify, test or fix it.

Check your understanding

Practice question

A payment gateway receives a card payment request from a merchant website. The gateway must route it to the right acquirer and return the result to the merchant. What is the gateway main job here?

Takeaway and next step

What to remember

Reconciliation teams match the gateway report against the bank statement and the order management system, and investigate any mismatch, such as a captured payment that never settled or a refund that was processed twice.

Send a payment through the hub and watch it pass each component named in this lesson.

Open the Payment Hub Architecture Simulator →

Builds on "What a Payment Gateway Does".

Transcript and full text

Show transcript

The payment page is the customer facing part of a gateway, and it must be fast, secure and easy to use. A hosted payment page redirects the customer to a gateway page that displays the order amount, the merchant name, and the available payment methods, while a checkout embedded in the merchant site keeps the customer on the same page and calls the gateway through an application programming interface. In both cases the card details go directly to the gateway, not to the merchant server, which keeps the merchant outside the strictest PCI DSS scope. A well designed page supports saved cards, one click checkout, address autofill and clear error messages, because every extra step or confusing message increases the chance that a customer abandons the purchase. The token vault is the secure store where a gateway keeps card details after the first payment. Instead of storing the real 16 digit card number, the gateway stores a token, which is a random reference such as tok_8f3k2m9q, and maps it to the card in an encrypted vault. The merchant stores only the token, so a breach of the merchant database does not expose card numbers. When a returning customer pays again, the merchant sends the token and the gateway retrieves the real card details from the vault. Under Reserve Bank of India rules, merchants in India must use tokenization through the card network or the gateway, and must not store the actual card number, CVV or expiry date on their own systems. Fraud screening protects the merchant from stolen cards, fake orders and account takeover. A gateway fraud engine checks the card country against the billing country, the velocity of attempts from one device or internet address, the order value against the customer history, and the result of 3D Secure authentication, which asks the customer to confirm the payment with a one time password or a bank application approval. High risk transactions can be blocked, sent for manual review, or allowed with extra checks. For example, a first time order of 85,000 rupees for electronics, paid with a card issued in another country and shipped to a different address, would score high and trigger a review before capture. Retry logic and webhooks keep payments moving when something fails. If an authorization fails because of a temporary network error, the gateway can retry the request with the same acquirer or route it to a backup acquirer, without asking the customer to enter card details again. An idempotency key, which is a unique value sent with the original request, prevents the retry from charging the customer twice. Webhooks are server to server notifications that the gateway sends to the merchant when the payment status changes, for example payment authorized, payment captured, refund processed, or chargeback received. The merchant system listens for these events and updates the order status automatically, so the warehouse ships only after a confirmed capture. Reporting closes the loop for finance, operations and reconciliation teams. A gateway dashboard shows daily transaction volume, approval rates by payment method, failure reasons, refund totals and settlement amounts. The merchant can download a settlement report that lists each transaction, its order identifier, its authorization code, the gross amount, the fee deducted and the net settlement amount. Reconciliation teams match the gateway report against the bank statement and the order management system, and investigate any mismatch, such as a captured payment that never settled or a refund that was processed twice. Good reporting turns a gateway from a simple pipe into a control point for the whole payment operation.

The payment page is the customer facing part of a gateway, and it must be fast, secure and easy to use. A hosted payment page redirects the customer to a gateway page that displays the order amount, the merchant name, and the available payment methods, while a checkout embedded in the merchant site keeps the customer on the same page and calls the gateway through an application programming interface. In both cases the card details go directly to the gateway, not to the merchant server, which keeps the merchant outside the strictest PCI DSS scope. A well designed page supports saved cards, one click checkout, address autofill and clear error messages, because every extra step or confusing message increases the chance that a customer abandons the purchase.

The token vault is the secure store where a gateway keeps card details after the first payment. Instead of storing the real 16 digit card number, the gateway stores a token, which is a random reference such as tok_8f3k2m9q, and maps it to the card in an encrypted vault. The merchant stores only the token, so a breach of the merchant database does not expose card numbers. When a returning customer pays again, the merchant sends the token and the gateway retrieves the real card details from the vault. Under Reserve Bank of India rules, merchants in India must use tokenization through the card network or the gateway, and must not store the actual card number, CVV or expiry date on their own systems.

Fraud screening protects the merchant from stolen cards, fake orders and account takeover. A gateway fraud engine checks the card country against the billing country, the velocity of attempts from one device or internet address, the order value against the customer history, and the result of 3D Secure authentication, which asks the customer to confirm the payment with a one time password or a bank application approval. High risk transactions can be blocked, sent for manual review, or allowed with extra checks. For example, a first time order of 85,000 rupees for electronics, paid with a card issued in another country and shipped to a different address, would score high and trigger a review before capture.

Retry logic and webhooks keep payments moving when something fails. If an authorization fails because of a temporary network error, the gateway can retry the request with the same acquirer or route it to a backup acquirer, without asking the customer to enter card details again. An idempotency key, which is a unique value sent with the original request, prevents the retry from charging the customer twice. Webhooks are server to server notifications that the gateway sends to the merchant when the payment status changes, for example payment authorized, payment captured, refund processed, or chargeback received. The merchant system listens for these events and updates the order status automatically, so the warehouse ships only after a confirmed capture.

Reporting closes the loop for finance, operations and reconciliation teams. A gateway dashboard shows daily transaction volume, approval rates by payment method, failure reasons, refund totals and settlement amounts. The merchant can download a settlement report that lists each transaction, its order identifier, its authorization code, the gross amount, the fee deducted and the net settlement amount. Reconciliation teams match the gateway report against the bank statement and the order management system, and investigate any mismatch, such as a captured payment that never settled or a refund that was processed twice. Good reporting turns a gateway from a simple pipe into a control point for the whole payment operation.

Full lesson text (all scenes)

Completing a lesson updates your progress dashboard on the homepage.

Scene timestamps are estimated by allocating the narration text proportionally across the real audio length. The audio playback position is the source of truth: pause freezes the visual, seeking restores the correct scene, replay restarts the scene animation.