Invoice and receipt emails

Teyra Pay sends two emails to your customers:

• Invoice email: the amount, the description, your business name and a Pay now button that opens the payment's checkout_url.
• Receipt: sent after a payment succeeds. It shows your business name, the amount and currency the customer paid, the date and time, the payment method (with the card brand and last 4 digits when known), your reference (or the payment ID when there is none) and the description.

Both emails need a customer email on the payment (customer.email). They show only what the customer pays. Teyra Pay fees never appear in them.

When the invoice email is sent

curl https://api.teyra.co/v1/payments \
  -H "Authorization: Bearer $TEYRA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: invoice-2026-118" \
  -d '{
    "amount": 12500,
    "currency": "KWD",
    "return_url": "https://shop.example.com/return",
    "description": "2 × Arabic coffee beans 1 kg",
    "reference": "INV-1042",
    "customer": { "name": "Fatima Hassan", "email": "fatima@example.com" },
    "language": "ar",
    "expires_in_minutes": 10080,
    "send_email": true
  }'

send_email: true without customer.email returns 422 validation_error with details.fields["customer.email"] = "required".

Resend an invoice

In Invoices, the envelope button on an unpaid invoice emails it to the customer again. An invoice can be emailed at most 3 times per hour, the first email included. You can only resend an invoice that is still waiting for payment and has not expired.

When the receipt is sent

A receipt is sent once when a payment with a customer email succeeds, whatever created it (dashboard invoice, API, payment link or plugin). It is never sent twice for the same payment, even when Teyra Pay is told about the success more than once.

To stop receipts, turn off Settings → Business settings → Email receipts to customers. Receipts are on by default. The setting does not affect invoice emails.

Language

Both emails use the payment's language (en or ar): the Payment page language you choose on a dashboard invoice, or language on POST /v1/payments. Payments created without a language are emailed in English. Arabic emails are laid out right to left.

Amounts use the currency's decimals, for example KWD 12.500 or AED 1,250.50. Dates and times are shown in your country's time zone, for example 2026-10-28 17:05 (GMT+3) for Kuwait.

Sender and replies

The emails come from Teyra Pay's email address with your business name in the sender name, for example Gulf Coffee via Teyra Pay. Your business name is also at the top of the email.

When your customer replies, the reply goes to your Support email (Settings → Business settings). Without a support email, the footer points customers to Teyra Pay support, so set one before you send invoices.

Test mode

Test-mode payments are emailed too, so you can check the emails before going live. They carry a note that no real money is charged.