Payments

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

const payment = await pay({
  amount: '10.50',
  to: '0xRecipientAddress',
  testnet: false,
});

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

const status = await getPaymentStatus({
  id: payment.id,
  testnet: false,
});

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

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

async function verifyPayment(txId: string, expectedAmount: string, expectedRecipient: string, authenticatedUser: string) {
  // 1. Check if already processed (dedup by txId)
  if (await isProcessed(txId)) throw new Error('Already processed');

  // 2. Verify payment status
  const { status, sender, amount, recipient } = await getPaymentStatus({ id: txId });
  if (status !== 'completed') throw new Error(`Payment not completed: ${status}`);

  // 3. Verify sender matches authenticated user (prevents impersonation)
  if (sender.toLowerCase() !== authenticatedUser.toLowerCase()) {
    throw new Error('Sender mismatch');
  }

  // 4. Validate amount and recipient
  if (amount !== expectedAmount || recipient.toLowerCase() !== expectedRecipient.toLowerCase()) {
    throw new Error('Payment details mismatch');
  }

  // 5. Mark processed BEFORE fulfilling
  await markProcessed(txId);
  await fulfillOrder(txId);
}

// POST handler at your callbackURL
app.post('/validate', (req, res) => {
  const { requestData } = req.body;
  const info = requestData.capabilities.dataCallback.requestedInfo;

  // Reject with errors (shown to user)
  if (!isValidEmail(info.email)) {
    return res.json({ errors: { email: 'Invalid email address' } });
  }

  // Accept — return the original request data
  return res.json({ request: requestData });
});

import { BasePayButton } from '@base-org/account-ui/react';

<BasePayButton
  colorScheme="light"
  size="medium"
  onClick={handlePayment}
/>

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

const { id } = await pay({ amount: '5.00', to: '0x...', testnet: true });
const status = await getPaymentStatus({ id, testnet: true });