Collect Payer Info - Base Documentation

Need checkout details? Pass a payerInfo object to pay() and the customer shares them in the same approval popup. A callbackURL lets you validate the data server-side before any funds move — return errors and the customer is prompted to fix them.

Demo

Request info with the payment

checkout.ts

import { pay } from '@base-org/account';

const payment = await pay({
  amount: '25.00',
  to: '0xYourReceivingAddress',
  payerInfo: {
    requests: [
      { type: 'email' },
      { type: 'physicalAddress', optional: true },
    ],
    callbackURL: 'https://your-api.com/validate', // optional server-side check
  },
});

const { email, physicalAddress } = payment.payerInfoResponses ?? {};

Supported request types: email, name, phoneNumber, physicalAddress, and onchainAddress. Fields are required unless you set optional: true.

See also

Accept a payment · Verify a payment
Data callback reference

⌘I