Checkout
Transactions
Payment Methods
Webhooks and Callbacks
Payer Information
Pix Automatic (Recurrence)
Pix Automatic (Recurrence)
Create Pix Automatic Recurrence
Creates a Pix Automatic recurrence journey. Use the immediatePayment
flag inside the recurrence
object to control the flow: false
for Journey 2 (authorization only), or true
for Journey 3 (authorization with an immediate payment).
POST
/
v1.1
/
checkout
/
pix-automatic
Copy
curl --request POST \
--url https://api.paymee.com.br/v1.1/checkout/pix-automatic \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--header 'x-api-token: <x-api-token>' \
--data '{
"currency": "BRL",
"referenceCode": "ref-journey2-xyz-123",
"maxAge": 120,
"callbackURL": "https://foo.bar/paymeeListener",
"shopper": {
"id": "24391203",
"email": "foo@bar.com",
"name": "JOHN DOE",
"document": {
"type": "CPF",
"number": "00000000000"
},
"phone": {
"type": "MOBILE",
"number": "11999990000"
}
},
"recurrence": {
"planId": "6852768495f9a7e75febdbe3",
"immediatePayment": false,
"amount": {
"recurrenceAmount": 11
},
"calendar": {
"initialDate": "2025-07-25",
"finalDate": "2025-12-25",
"periodicity": "MONTHLY"
},
"retry": true
}
}'
Copy
{
"status": 0,
"message": "success",
"response": {
"id": 215832474,
"referenceCode": "ref-journey3-abc-456",
"amount": 15,
"saleCode": "215832474",
"uuid": "ed700503-e3e0-3c3f-867f-0bd7bba3424a",
"shopper": {
"id": "24391204",
"name": "JOHN DOE",
"email": "jane@doe.com",
"document": {
"type": "CPF",
"number": "00000000000"
},
"phone": {
"type": "MOBILE",
"number": "11999990000"
}
},
"instructions": {
"chosen": "PIX_RECURRENCE",
"name": "Pagamento Recorrente via PIX",
"label": "Pagamento Recorrente via PIX",
"qrCode": {
"url": "https://api.paymee.com.br/resources/payments/pix/qrcode/ed700503-e3e0-3c3f-867f-0bd7bba3424a",
"base64": "iVBORw0KGgoAAAANSUhEUgAAAPoAAAD6CAIAAAAHjs1q... (base64 image data)",
"plain": "00020101021226930014br.gov.bcb.pix... (qr code text)"
},
"steps": {
"qrCode": [
"Acesse o APP ou o Internet Banking do seu Banco",
"Acesse o menu PIX",
"Abra o leitor de QRCode no APP e escaneie o código informado",
"Siga os passos no APP e finalize a transação"
]
}
}
}
}
Headers
Example:
"your-x-api-key"
Example:
"your-x-api-token"
Body
application/json
Response
200
application/json
Pix Automatic journey created successfully. The response contains QR code instructions to start the flow.
The response is of type object
.
Copy
curl --request POST \
--url https://api.paymee.com.br/v1.1/checkout/pix-automatic \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--header 'x-api-token: <x-api-token>' \
--data '{
"currency": "BRL",
"referenceCode": "ref-journey2-xyz-123",
"maxAge": 120,
"callbackURL": "https://foo.bar/paymeeListener",
"shopper": {
"id": "24391203",
"email": "foo@bar.com",
"name": "JOHN DOE",
"document": {
"type": "CPF",
"number": "00000000000"
},
"phone": {
"type": "MOBILE",
"number": "11999990000"
}
},
"recurrence": {
"planId": "6852768495f9a7e75febdbe3",
"immediatePayment": false,
"amount": {
"recurrenceAmount": 11
},
"calendar": {
"initialDate": "2025-07-25",
"finalDate": "2025-12-25",
"periodicity": "MONTHLY"
},
"retry": true
}
}'
Copy
{
"status": 0,
"message": "success",
"response": {
"id": 215832474,
"referenceCode": "ref-journey3-abc-456",
"amount": 15,
"saleCode": "215832474",
"uuid": "ed700503-e3e0-3c3f-867f-0bd7bba3424a",
"shopper": {
"id": "24391204",
"name": "JOHN DOE",
"email": "jane@doe.com",
"document": {
"type": "CPF",
"number": "00000000000"
},
"phone": {
"type": "MOBILE",
"number": "11999990000"
}
},
"instructions": {
"chosen": "PIX_RECURRENCE",
"name": "Pagamento Recorrente via PIX",
"label": "Pagamento Recorrente via PIX",
"qrCode": {
"url": "https://api.paymee.com.br/resources/payments/pix/qrcode/ed700503-e3e0-3c3f-867f-0bd7bba3424a",
"base64": "iVBORw0KGgoAAAANSUhEUgAAAPoAAAD6CAIAAAAHjs1q... (base64 image data)",
"plain": "00020101021226930014br.gov.bcb.pix... (qr code text)"
},
"steps": {
"qrCode": [
"Acesse o APP ou o Internet Banking do seu Banco",
"Acesse o menu PIX",
"Abra o leitor de QRCode no APP e escaneie o código informado",
"Siga os passos no APP e finalize a transação"
]
}
}
}
}
Assistant
Responses are generated using AI and may contain mistakes.