What is a payment form?

In short

A payment form is the set of fields in a checkout where a buyer enters payment details, such as the card number, the expiry date and the security code, and confirms the payment. How a payment form is built, and who serves it, decide how much of the card data the merchant's own systems handle.

Also called
Card form, Checkout form, Card entry form
Family
Accepting payments
Facts checked

How a payment form works

The form collects the details, checks them as they are typed and submits them to a payment provider. Typical checks are the length and check digit of the card number, the card brand from its first digits, and an expiry date in the future.

On submission the details are exchanged for a token, any 3-D Secure step runs, and the payment is authorised. The merchant's order system receives the token and the result, not the card number.

Three ways to build a payment form

  • Hosted page: the provider serves the whole form on its own domain
  • Hosted fields: the provider serves each sensitive field in an iframe inside the merchant's page
  • Direct form: the merchant's own fields, posting card data to the provider's API

The first two keep card numbers away from the merchant's servers and so narrow its PCI DSS scope. The third gives full control over the design and brings the merchant's site and servers into scope.

What a good payment form does

Small details move conversion: numeric keypads on phones, autofill and card scanning, clear inline errors, wallet buttons above the card fields, and the local payment methods of the buyer's country. Accessibility matters as much: labels, keyboard navigation and contrast decide whether some buyers can pay at all.

Payment form, checkout page or hosted checkout?

Checkout page
The whole page: basket, address, delivery and the payment form within it.
Hosted checkout
A payment form on a page that the provider hosts, reached by redirect.

Where a payment form shows up in a platform

Modules that do the work

Platforms that need it

Guides that go deeper

Every term

Start your project

Tell us the idea. We'll show you the platform.

One call is enough to map your product to the modules that already exist.

  • Response in under one business day
  • NDA on request
  • No obligation
How can we help?