Skip to main content

​
Overview

Pix Automatic depends on asynchronous webhooks sent by the acquirer (mandate approvals, scheduled charges, settlements, failures). In the Sandbox, PayMee exposes a simulator that produces those exact webhooks and feeds them to the same handlers used in production, so you can exercise the entire recurrence lifecycle end to end without a real payer. All simulator endpoints live under:
These endpoints exist only in the Sandbox. They authenticate with the same x-api-key and x-api-token as the rest of the API and act only on recurrences that belong to your test merchant.

​
Authentication

Every simulator call requires both headers:

​
Typical end-to-end flow

1

Create a plan

POST /v1.1/pix-automatic/plans — defines the frequency and amount of the recurrence.
2

Create the recurrence (checkout)

POST /v1.1/checkout/pix-automatic — returns an idRec for the new authorization, which starts in CREATED.
3

Authorize the mandate

POST /sandbox/sim/mandate/{idRec}/approved — drives the approval and moves the recurrence to APPROVED. A RECURRENCE_AUTHORIZED webhook is emitted.
4

Generate the due charge

POST /sandbox/sim/recurrence/{idRec}/run-due — generates the next scheduled collection (a sale) for recurrences whose next charge falls within the due window.
5

Settle or fail the charge

POST /sandbox/sim/collection/{txId}/concluded to settle, or POST /sandbox/sim/collection/{txId}/reject/{code} to fail with a reason code.
Each individual mandate action drives the full prerequisite sequence automatically. Calling .../mandate/{idRec}/approved on a recurrence still in CREATED first drives APPROVING and then APPROVED, so the action works from any starting state.

​
Mandate (authorization) endpoints

​
Collection (charge) endpoints

​
One-shot scenarios

For convenience, composite scenarios drive a whole sequence in a single call:

​
Failure reason codes

Use these codes with .../collection/{txId}/reject/{code} (or .../recurrence/{idRec}/fail/{code}):
The due window for run-due is [now + 2 days, now + 10 days]. A freshly created recurrence whose next charge date is outside this window will not generate a collection until its next cycle approaches; the approve-and-settle scenario handles the first charge for you.

Webhook Notifications

See the Pix Automatic (Recurrence) notification payloads emitted during these flows.