Collect Payer Info

Request payer contact or shipping information in Base Pay and validate required fields before funds move.

Base Pay can request email, name, phone number, physical address, or onchain address in the approval flow. A callback validates required fields before the transaction is submitted.

Demo

1. Request the information

   checkout.ts

   export async function checkoutWithPayerInfo(merchant: Address) {
     const payment = await pay({
       amount: "25.00",
       to: merchant,
       testnet: true,
       payerInfo: {
         requests: [{ type: "email" }, { type: "physicalAddress", optional: true }],
         callbackURL: "https://merchant.example/api/validate-payer",
       },
     });
     if (!payment.payerInfoResponses?.email) throw new Error("Required email was not returned");
     return payment;
   }
   
2. Validate it on your server

   api/validate-payer.ts

   export async function validatePayerInfo(request: Request) {
     const body = await request.json();
     const requestedInfo = body?.capabilities?.dataCallback?.requestedInfo;
     const email = requestedInfo?.email as string | undefined;
     if (!email || !email.includes("@")) {
       return Response.json({ errors: { email: "Enter a valid email address" } }, { status: 400 });
     }
     return Response.json({ request: body });
   }
   

Treat payer information as sensitive personal data. Request only fields you need, validate the callback origin and payload, define retention limits, and never use optional data as proof of payment.

See also

• Accept payments from humans · Verify a payment
• Data callback