基于Square与PHP实现活动固定金额无接触支付的技术咨询

Does Square Support This Use Case? #

Absolutely—your exact scenario is a perfect fit for Square's non-contact card readers. Here's why:

• Square's Contactless + Chip Reader or Square Terminal are designed for fast, minimal-interaction payments. You can set a fixed £5 amount, and users only need to tap, insert a card, or scan a QR code to complete payment.
• No mandatory user information collection is required. You don't have to ask for names, emails, or addresses—just confirm the payment success and grant entry.
• For even more simplicity, Square Terminal lets you preload the £5 amount directly on the device, so users can complete payments without interacting with your PHP app at all (though you can still integrate it if you want to tie payment success to your entry system).

PHP Starter Template for Simplified Fixed-Amount Payments #

Since you have basic PHP skills, Square's official PHP SDK makes this straightforward. Here's a minimal, customizable template to get you started:

First, install the SDK via Composer:

composer require square/square

Then use this code as a base (replace placeholder values with your Square credentials):

<?php
require 'vendor/autoload.php';

use Square\SquareClient;
use Square\Environment;
use Square\Exceptions\ApiException;
use Square\Models\CreatePaymentRequest;
use Square\Models\Money;

// Initialize Square client (use SANDBOX for testing, PRODUCTION for live)
$client = new SquareClient([
    'accessToken' => 'YOUR_SQUARE_ACCESS_TOKEN',
    'environment' => Environment::SANDBOX,
]);

$paymentsApi = $client->getPaymentsApi();

// Set fixed £5 amount (amount in smallest currency unit: 500 pence)
$amount = new Money();
$amount->setAmount(500);
$amount->setCurrency('GBP');

// Build payment request with zero user data requirements
$paymentRequest = new CreatePaymentRequest();
$paymentRequest->setSourceId('YOUR_DEVICE_SOURCE_ID'); // Get this from paired reader
$paymentRequest->setAmountMoney($amount);
$paymentRequest->setAutocomplete(true); // Auto-finalize payment without extra steps
$paymentRequest->setNote('Event Admission - £5'); // Internal tracking note (optional)

try {
    $response = $paymentsApi->createPayment($paymentRequest);
    
    if ($response->isSuccess()) {
        $payment = $response->getResult()->getPayment();
        echo "Payment approved! Grant entry now. Payment ID: " . $payment->getId();
        // Add your entry logic here (e.g., trigger a door lock, print a ticket)
    } else {
        foreach ($response->getErrors() as $error) {
            echo "Payment failed: " . $error->getDetail();
        }
    }
} catch (ApiException $e) {
    echo "Error connecting to Square: " . $e->getMessage();
}
?>

Key Notes for Customization:

• YOUR_DEVICE_SOURCE_ID: You'll get this by pairing your Square reader with your app via Square's Device API, or by retrieving it from the Square POS app after pairing the device.
• Testing: Use Square's sandbox environment with virtual test cards (e.g., 4111 1111 1111 1111) to test payments without real money.
• QR Code Payments: If you prefer QR codes instead of card taps, you can generate a fixed-amount QR code via Square's API and display it at your entry point—users scan it with their phone and pay without extra info.

内容的提问来源于stack exchange，提问作者Exoon