> For the complete documentation index, see [llms.txt](https://docs.yoplanning.support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yoplanning.support/pt/academia-yoplanning/yoplanning-parametrage/vente-en-ligne/procedure-de-mise-en-place-de-payline/note-technique-et-fonctionnelle-integration-payline.md).

# Nota Técnica e Funcional – Integração Payline

**Empresa:** Vakario (editora do software Yoplanning) **Produto em questão:** Motor de reservas Yoplanning **Data:** Outubro de 2025 **Assunto:** Descrição do fluxo de pagamento via Payline (MONEXT) e conformidade com o PCI DSS

***

### 1. Context

A Yoplanning é uma solução SaaS de reservas e gestão online utilizada por operadores de atividades de lazer e ao ar livre. A Vakario não recolhe, processa ou armazena **nenhum dado de cartão de crédito**. A integração de pagamentos utiliza exclusivamente o sistema **Payline by MONEXT**, que possui **certificação PCI DSS Nível 1 (certificado em anexo)**.

***

### 2. Diagrama de fluxo geral

1. O cliente clica em **“Pagar”** na interface de reservas do Yoplanning.
2. O servidor Yoplanning chama a API `do_web_payment` da Payline com os seguintes dados:
   * Quantia
   * Moeda
   * Número VAD do comerciante
   * ID do pedido Yoplanning
   * `url_de_sucesso` / `url_de_cancelamento` / `url_de_notificação`
   * Nome, sobrenome, e-mail e endereço de cobrança do pagador.
3. A Payline envia um **URL de pagamento seguro**, para o qual a Yoplanning **redireciona o cliente**.
4. O cliente insere seus dados bancários na **página Payline hospedada pela MONEXT**.
5. Após a autorização, o Payline redireciona o cliente para os URLs configurados e **notifica o servidor Yoplanning**.
6. Em seguida, o Yoplanning chama `get_web_payment_details` para recuperar as informações de pagamento e **cria o pedido interno**.

***

### 3. Dados registrados pelo Yoplanning

* Valor pago
* Moeda
* Número da transação Payline
* ID do pedido
* Informações de faturamento (nome, sobrenome, e-mail, endereço)

A Vakario não armazena nem processa dados de cartão de crédito. Todas as transações são criptografadas via HTTPS (TLS 1.2 no mínimo).

***

### 4. Segurança e conformidade

* Integração em **modo de redirecionamento** (fora do escopo do PCI DSS Vakario).
* Certificação MONEXT **AoC PCI DSS v4.0** que abrange todo o processamento.
* **Nenhum** dado de cartão bancário é armazenado, manipulado ou transmitido pela Yoplanning.
* Todas as conexões são protegidas via HTTPS (TLS 1.2 no mínimo).

***

### 5. Manutenção e atualizações

* Os pontos de extremidade da linha de pagamento são verificados a cada atualização importante.
* Rastreamento de versões da API e auditorias internas regulares.
* Preservação de **registros técnicos não sensíveis** para fins de rastreabilidade.

***

### 6. Apêndices

Certificação MONEXT / Payline PCI DSS

{% file src="/files/qlwLsZNpZNSn8GaPurW9" %}

***

**Vakario – Yoplanning** ►\* ► Empresa que publica o software Yoplanning\* 📧 <support@yoplanning.com> 🌐 <https://yoplanning.com>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.yoplanning.support/pt/academia-yoplanning/yoplanning-parametrage/vente-en-ligne/procedure-de-mise-en-place-de-payline/note-technique-et-fonctionnelle-integration-payline.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.