POST
/
v1.1
/
pix-automatic
/
plans
Create a recurrence plan
curl --request POST \
  --url https://api.paymee.com.br/v1.1/pix-automatic/plans \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-api-token: <x-api-token>' \
  --data '{
  "title": "Plano Premium Mensal",
  "description": "Acesso completo a todas as funcionalidades da plataforma.",
  "frequency": "MONTHLY",
  "period": 1,
  "imediateAmount": 49.9,
  "recurrenceAmount": 29.9,
  "minimumRecurrenceAmount": 29.9,
  "retryPolicy": "ACCEPT_3R_7D",
  "enabled": true
}'
{
  "status": 0,
  "message": "success",
  "id": "6851c0842bf40769ead1fde5",
  "title": "Plano Premium Mensal",
  "description": "Acesso completo a todas as funcionalidades da plataforma.",
  "frequency": "MONTHLY",
  "period": 1,
  "imediateAmount": 49.9,
  "recurrenceAmount": 29.9,
  "minimumRecurrenceAmount": 29.9,
  "retryPolicy": "ACCEPT_3R_7D",
  "enabled": true,
  "creation": "2025-06-17 19:22:44"
}

Headers

x-api-key
string
required
Example:

"your-x-api-key"

x-api-token
string
required
Example:

"your-x-api-token"

Body

application/json
title
string

Title of the plan.

Example:

"Plano Premium Mensal"

description
string

Detailed description of the plan.

Example:

"Acesso completo a todas as funcionalidades da plataforma."

frequency
string

Billing frequency.

Example:

"MONTHLY"

period
integer

Period of the frequency (e.g., 1 for monthly, 3 for quarterly).

Example:

1

imediateAmount
number

Immediate charge amount upon joining the plan.

Example:

49.9

recurrenceAmount
number

Amount for recurring charges.

Example:

29.9

minimumRecurrenceAmount
number

Minimum amount accepted for recurring charges.

Example:

29.9

retryPolicy
enum<string>

Retry policy in case of failure.

Available options:
ACCEPT_3R_7D,
NOT_ACCEPT
Example:

"ACCEPT_3R_7D"

enabled
boolean

Indicates if the plan is active.

Example:

true

Response

Plan created successfully.

status
integer
Example:

0

message
string
Example:

"success"

id
string

Unique ID of the generated plan.

Example:

"6851c0842bf40769ead1fde5"

title
string
Example:

"Plano Premium Mensal"

description
string
Example:

"Acesso completo a todas as funcionalidades da plataforma."

frequency
string
Example:

"MONTHLY"

period
integer
Example:

1

imediateAmount
number
Example:

49.9

recurrenceAmount
number
Example:

29.9

minimumRecurrenceAmount
number
Example:

29.9

retryPolicy
string
Example:

"ACCEPT_3R_7D"

enabled
boolean
Example:

true

creation
string<date-time>

Date and time of plan creation.

Example:

"2025-06-17 19:22:44"