Pay by link

Pay by link is for invoices, phone orders, and anything where you do not want to host card fields. Tokeni hosts the page. You get a token and a transaction.

Create a link

curl -sS https://sandbox-api.tokeni.io/api/v1/pay-by-link/ \
  -u "$TOKENI_API_KEY:$TOKENI_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "75.00",
    "currency": "USD",
    "description": "Invoice 1042"
  }'

The response includes a URL to send the customer. You can also create links from the dashboard.

After payment

Poll GET /api/v1/pay-by-link/{linkId} or wait for a webhook (transaction.success). The payload is metadata only: type, uuid, transaction type, status. No PAN, no CVV.

Cancel with DELETE /api/v1/pay-by-link/{linkId} before the customer pays.

Display

Show amount, currency, and description. Do not ask the customer to read a card number back to you and then type it into your own form. That puts you back in PCI scope.