Processor: Amazon pay (amazon payment services)
Amazon Payment Services (APS, formerly PayFort) is a V1 payment processor configured at the center level. It supports hosted-page card payments and card-on-file storage, primarily serving businesses in the Middle East and North Africa (UAE, Saudi Arabia, Egypt, Kuwait, Jordan, Lebanon, Qatar, Oman, Bahrain).
Regional availability: UAE and Kuwait are confirmed live. Saudi Arabia, Egypt, Jordan, Lebanon, Qatar, and Oman are listed as coming soon β verify current status with Zenoti before enabling.
Before you begin
Permission: You need center-level payment configuration permissions to configure Amazon Payment Services.
APS merchant-side prerequisites
- APS merchant account activated for your country and settlement currency. APS activates card schemes (Visa, Mastercard, Amex, MADA, KNET) individually per MID (Merchant Identifier).
- Return URL allow-list β share the Zenoti return domain with your APS representative so the hosted page can redirect successfully.
Credentials
| Field | Source / owner | What to enter |
|---|---|---|
| Merchant identifier | APS merchant portal (Security Settings) | The MID assigned by APS. |
| Access code | APS merchant portal (Security Settings) | Access code tied to the merchant identifier. |
| SHA request phrase | APS merchant portal (Security Settings) | Used to sign outbound requests. Must match the value in the APS portal byte-for-byte. |
| SHA response phrase | APS merchant portal (Security Settings) | Used to verify responses returned from APS. |
Note: All four values are managed by your APS merchant admin in the APS portal. Zenoti does not supply defaults. Regenerating the SHA phrases in the APS portal invalidates the Zenoti configuration β you must re-enter both whenever APS rotates them.
Network requirements
| Direction | Port | Protocol | Why |
|---|---|---|---|
| Outbound from Zenoti to APS API | 443 | HTTPS | Authorise, capture, refund, void calls |
| Outbound from guest browser to APS hosted page | 443 | HTTPS | HPP (Hosted Payment Page) payment flow |
| Outbound from APS to Zenoti | 443 | HTTPS | Post-payment server-to-server callback |
APS capabilities in Zenoti
| Capability | Supported | Notes |
|---|---|---|
| Online card payments (HPP) | Yes | |
| Stored accounts (card on file) | Yes | APS local token; not cross-processor portable |
| Recurring payments | Yes | |
| Pre-authorize and capture | Yes | |
| Refund | Yes | [SOURCE GAP β PM VERIFY: partial-refund support] |
| Void (pre-settlement) | Yes | |
| Terminal (POS (Point of Sale)) | No | APS is online-only |
| Global tokenization (cross-processor) | No |
Transaction types
Amazon Payment Services supports two transaction types:
- Manual (MOTO) β mail order / telephone order, for card-not-present staff-entered transactions. Prerequisite: your merchant account must be approved for MOTO by your acquiring bank before enabling this transaction type. Contact your acquiring bank to request MOTO approval.
- Online (Webstore and CMA) β for guest-initiated payments on the Zenoti Webstore and Customer Mobile App.
Configure Amazon Payment Services
- At the center level, navigate to Configuration > Payments > Settings (the center-scope caption of the Payments row).
- Select Amazon Payment Services as the payment processor.
- Enter the credentials from the credentials table.
- Enable the payment types you want to accept.
- Select Save.
- Select Test to verify the credentials.
Toggle interactions
| Card payments | Card-on-file (stored accounts) | Behaviour |
|---|---|---|
| Off | Off | APS not available at checkout. |
| On | Off | One-off hosted-page payments only. |
| Off | On | Invalid combination β stored-card charges require the card-payments channel to be enabled at APS. |
| On | On | Recommended for membership / return-guest flows. |
Process a payment
- Guest chooses APS at checkout.
- Zenoti redirects to the APS hosted page with the SHA-signed request.
- Guest enters card details (or selects a stored APS card).
- APS redirects back with the result; Zenoti verifies the SHA response signature and closes the invoice on success.
Process a refund
Refunds use the Merchant identifier, Access code, and SHA phrases configured at setup.
- Open the invoice, select the APS transaction, and choose Refund.
- Confirm.
Refund β dual-system perspective
| System | What happens |
|---|---|
| Zenoti | Negative payment line; Collections report shows the refund row tied to the original transaction. |
| APS | Separate refund record linked to the original transaction ID; visible on the APS settlement report. Match key: APS transaction ID or Zenoti invoice number. |
Process a void
Voids cancel an authorised but unsettled charge. After settlement, use a refund.
Edit or reverse a posted payment
| Invoice state | What you can do |
|---|---|
| Open | Remove the APS payment line, then void (pre-settlement) or refund (post-settlement). |
| Closed | Reopen if permissions allow, or post a compensating refund. Original line preserved for audit. |
Failure modes
| Failure mode | User-visible symptom | Resolution |
|---|---|---|
| APS gateway unreachable | HPP fails to load or times out. | Check outbound HTTPS and APS status page. Invoice stays open. |
| SHA signature mismatch | Every transaction fails with a signature error. | The SHA phrases in Zenoti no longer match APS; re-copy both from the APS portal. |
| Access code invalid / expired | Auth error on every call. | Re-verify the access code with APS. |
| Card declined | HPP shows issuer decline. | Guest retries with another method. |
| Amount out of range | APS rejects the charge. | APS enforces per-country minimums and maximums; confirm with APS. |
| Currency mismatch | Transaction rejected. | Confirm the center currency matches the APS-activated currency for the MID. |
| Settlement failure | Charge approved but missing from settlement. | Raise with APS support using the transaction ID; do not re-charge. |
Settlement and reconciliation
APS settlement timing varies by country and acquirer relationship. [SOURCE GAP β PM VERIFY: exact T+N per country.] Working days exclude the local weekend (Friday/Saturday in many MENA markets, Saturday/Sunday elsewhere) and public holidays.
| Source | Report / view | Match key |
|---|---|---|
| Zenoti | Collections report (filter: Payment Method = Amazon Payment Services) | APS transaction ID + Zenoti invoice number |
| APS | Merchant portal settlement report | Same fields |
Recommended cadence: daily for high-volume centers, weekly for low-volume.
Tips
- Amazon Payment Services uses SHA request and response phrases for transaction security. Ensure these are entered exactly as configured in the APS portal.
- Verify that your account is in production mode before processing live payments.
- Contact your APS account representative if you encounter authentication errors.