# Payments

HTML: https://www.app2email.com/docs/api/payments · Index: https://www.app2email.com/docs/api/llms.txt

Payments for appointments through the business's own Stripe or PayPal account, one-off payment requests, refunds, prepaid packages, the customer profile (with GDPR-style erase) and meeting polls.

| Method | Path | Summary | Scope | Sandbox key |
| --- | --- | --- | --- | --- |
| GET | `/v1/{number}/payments` | [The payments, newest first](https://www.app2email.com/docs/api/payments/list-payments.md) | `bookings:manage\|messages:read` | reads |
| GET | `/v1/{number}/payments/{id}` | [One payment](https://www.app2email.com/docs/api/payments/get-payment.md) | `bookings:manage\|messages:read` | reads |
| POST | `/v1/{number}/payments/links` | [Ask a customer to pay an amount](https://www.app2email.com/docs/api/payments/create-payment-link.md) | `bookings:manage` | refused |
| POST | `/v1/{number}/payments/{id}/refund` | [Refund a payment, in full or a part](https://www.app2email.com/docs/api/payments/refund-payment.md) | `bookings:manage` | refused |
| POST | `/v1/{number}/bookings/{id}/payment` | [Record a payment taken outside app2email](https://www.app2email.com/docs/api/payments/set-booking-payment.md) | `bookings:manage` | refused |
| GET | `/v1/{number}/bookings/packages` | [The prepaid packages on sale](https://www.app2email.com/docs/api/payments/list-packages.md) | `bookings:manage\|messages:read` | reads |
| GET | `/v1/{number}/bookings/packages/purchases` | [The packages customers hold](https://www.app2email.com/docs/api/payments/list-package-purchases.md) | `bookings:manage\|messages:read` | reads |
| POST | `/v1/{number}/bookings/packages/grant` | [Give a customer a package without a payment](https://www.app2email.com/docs/api/payments/grant-package.md) | `bookings:manage` | refused |
| GET | `/v1/{number}/bookings/customers` | [The customers with appointments](https://www.app2email.com/docs/api/payments/list-booking-customers.md) | `bookings:manage\|messages:read` | reads |
| GET | `/v1/{number}/bookings/customers/{contact}` | [A customer's whole profile](https://www.app2email.com/docs/api/payments/get-customer-profile.md) | `bookings:manage\|messages:read` | reads |
| PATCH | `/v1/{number}/bookings/customers/{contact}` | [Change a customer's name, e-mail, tags or fields](https://www.app2email.com/docs/api/payments/update-customer.md) | `bookings:manage` | refused |
| DELETE | `/v1/{number}/bookings/customers/{contact}` | [Erase a customer's booking data](https://www.app2email.com/docs/api/payments/erase-customer-booking-data.md) | `bookings:manage` | refused |
| GET | `/v1/{number}/bookings/polls` | [The meeting polls](https://www.app2email.com/docs/api/payments/list-polls.md) | `bookings:manage\|messages:read` | reads |
| POST | `/v1/{number}/bookings/polls` | [Offer several times and let people vote](https://www.app2email.com/docs/api/payments/create-poll.md) | `bookings:manage` | refused |
| GET | `/v1/{number}/bookings/polls/{id}` | [One poll with its votes](https://www.app2email.com/docs/api/payments/get-poll.md) | `bookings:manage\|messages:read` | reads |
| POST | `/v1/{number}/bookings/polls/{id}/close` | [Close a poll to new votes](https://www.app2email.com/docs/api/payments/close-poll.md) | `bookings:manage` | refused |
| POST | `/v1/{number}/bookings/polls/{id}/book` | [Pick the winning time](https://www.app2email.com/docs/api/payments/book-poll.md) | `bookings:manage` | refused |
