# Opções de Integração

Escolha o método de integração que melhor se adequa às suas necessidades. A Easypay oferece três formas principais de integrar processamento de pagamentos na sua plataforma.

## Visão Geral

| Método de Integração | Melhor Para | Nível Técnico | Tempo de Integração |
|  --- | --- | --- | --- |
| **Plugins** | Plataformas de e-commerce (WooCommerce, Shopify, etc.) | Não requer programação | 15-30 minutos |
| **Checkout** | Websites personalizados com desenvolvimento mínimo | HTML/JavaScript básico | 1-2 horas |
| **Servidor para Servidor** | Controlo total da API e personalização | Avançado (desenvolvimento API) | 2-4 horas |


## Plugins

A forma mais rápida de integrar a Easypay se estiver a usar uma plataforma de e-commerce suportada. Instale, configure e comece a aceitar pagamentos em minutos.

### Plataformas Suportadas

#### WooCommerce

Plugin de e-commerce WordPress para lojas online de todos os tamanhos.

**Funcionalidades:**

- Todos os métodos de pagamento Easypay (Cartão de Crédito, MB WAY, Multibanco, etc.)
- Pagamentos únicos e recorrentes
- Atualizações automáticas do estado do pedido
- Gestão de reembolsos no painel de administração WordPress


[Ver Guia de Integração WooCommerce](https://www.easypay.pt/en/integrations/woocommerce/)

#### PrestaShop

Plataforma de e-commerce open-source com extensas opções de personalização.

**Funcionalidades:**

- Suporte completo de métodos de pagamento
- Suporte multi-moeda
- Instalação com um clique
- Sincronização de pedidos


[Ver Guia de Integração PrestaShop](https://www.easypay.pt/en/integrations/prestashop/)

#### Shopify

Plataforma de e-commerce hospedada para lojas online e sistemas de ponto de venda.

**Funcionalidades:**

- Integração perfeita com Shopify
- Todos os métodos de pagamento disponíveis
- Sincronização automática de inventário
- Checkout otimizado para móvel


[Ver Guia de Integração Shopify](https://www.easypay.pt/en/integrations/shopify/)

#### Magento

Plataforma Adobe Commerce para soluções de e-commerce empresariais.

**Funcionalidades:**

- Processamento de pagamentos de nível empresarial
- Gestão avançada de pedidos
- Suporte multi-loja
- Fluxos de pagamento personalizados


[Ver Guia de Integração Magento](https://www.easypay.pt/en/integrations/magento/)

#### VTEX

Plataforma de comércio cloud-native para marcas empresariais.

**Funcionalidades:**

- Integração nativa VTEX
- Suporte de pagamento omnicanal
- Atualizações de pagamento em tempo real
- Compatibilidade VTEX IO


[Ver Guia de Integração VTEX](https://www.easypay.pt/en/integrations/vtex/)

#### Wix

Construtor de websites com capacidades de e-commerce integradas.

**Funcionalidades:**

- Integração de pagamento arrastar e soltar
- Checkout responsivo para móvel
- Compatibilidade com Wix Stores
- Não requer programação


[Ver Guia de Integração Wix](https://www.easypay.pt/en/integrations/wix-en/)

#### Jumpseller

Plataforma de e-commerce para pequenas e médias empresas.

**Funcionalidades:**

- Processo de configuração rápido
- Todos os métodos de pagamento
- Gestão de inventário
- Suporte multi-idioma


[Ver Guia de Integração Jumpseller](https://www.easypay.pt/en/integrations/jumpseller/)

#### nopCommerce

Plataforma de e-commerce ASP.NET open-source.

**Funcionalidades:**

- Integração ASP.NET Core
- Configuração de pagamento flexível
- Suporte de arquitetura de plugins
- Pronto para marketplace multi-fornecedor


[Ver Guia de Integração nopCommerce](https://www.easypay.pt/en/integrations/nopcommerce/)

## Checkout

Formulário de pagamento pré-construído da Easypay que pode incorporar diretamente em qualquer website com apenas algumas linhas de código. Perfeito para websites e aplicações personalizados.

### Principais Benefícios

- **Desenvolvimento Mínimo**: Incorpore com apenas algumas linhas de JavaScript
- **Todos os Métodos de Pagamento**: Cartões de crédito, MB WAY, Apple Pay, Google Pay, Samsung Pay, Multibanco, Débito Direto, IBAN Virtual
- **Totalmente Personalizável**: Combine com a sua marca com extensas opções de estilo
- **Responsivo para Móvel**: Funciona perfeitamente em todos os dispositivos
- **Conforme PCI**: Nós tratamos da segurança e conformidade


### Como Funciona

1. **Criar uma sessão de checkout** (chamada API do lado do servidor)
2. **Incorporar o formulário de checkout** (adicionar snippet JavaScript à sua página)
3. **Tratar a resposta de pagamento** (receber notificações webhook)


### Exemplo Rápido


```javascript
// Incluir o SDK
<script src="https://cdn.easypay.pt/checkout/2.9.1/"></script>

// Inicializar checkout com a sua sessão
const manifest = await getManifestFromServer();
easypayCheckout.startCheckout(manifest);
```

### Saber Mais

- [Guia Completo de Checkout](/docs/products/checkout) - Documentação completa de integração
- [Demo Ao Vivo](https://checkout-demo.easypay.pt) - Experimente em ação
- [Exemplo GitHub](https://github.com/Easypay/checkout-demo) - Código funcional completo


## Servidor para Servidor (Integração Direta da API)

Para programadores que precisam de controlo total sobre o fluxo de pagamento. Construa experiências de pagamento personalizadas usando diretamente a nossa API REST.

### Quando Usar

- Fluxos de pagamento personalizados
- Aplicações móveis
- Integrações apenas backend
- Lógica de pagamento avançada
- Plataformas multi-inquilino


### Pré-requisitos

Antes de começar, precisará de:

1. Uma conta Easypay
2. Credenciais API (ID da Conta e Chave API)


### Obter as Suas Credenciais API

Para criar credenciais para a sua conta, siga [este guia](https://www.easypay.pt/blog/como-gerar-chaves-de-autenticacao/).

Para fins de teste, pode usar estas credenciais:


```
AccountId: 2b0f63e2-9fb5-4e52-aca0-b4bf0339bbe6
ApiKey: eae4aa59-8e5b-4ec2-887d-b02768481a92
```

**Nota**: Estas credenciais apenas funcionam no ambiente de teste.

### Escolha o Seu Ambiente

A Easypay disponibiliza dois ambientes:

- **Teste**: `https://api.test.easypay.pt/2.0`
- **Produção**: `https://api.prod.easypay.pt/2.0`


Comece sempre com o ambiente de teste para se familiarizar com a API.

### Faça a Sua Primeira Chamada à API

Aqui está um exemplo simples para criar um pagamento único:


```bash
curl -L -X POST 'https://api.test.easypay.pt/2.0/single' \
  -H 'AccountId: 2b0f63e2-9fb5-4e52-aca0-b4bf0339bbe6' \
  -H 'ApiKey: eae4aa59-8e5b-4ec2-887d-b02768481a92' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "type": "sale",
    "value": 10.00,
    "currency": "EUR",
    "method": "cc",
    "customer": {
      "name": "John Doe",
      "email": "john.doe@example.com"
    }
  }'
```

### Tratar a Resposta

Uma resposta bem-sucedida incluirá os detalhes do pagamento e um ID de pagamento único:


```json
{
  "status": "success",
  "id": "5eca7446-14e9-47bb-aabb-5ee237159b8b",
  "method": "cc",
  "customer": {
    "name": "John Doe",
    "email": "john.doe@example.com"
  }
}
```

### Saber Mais

- [Autenticação](/docs/authentication) - Guia detalhado de autenticação
- [Referência da API](/openapi) - Documentação completa de endpoints
- [Métodos de Pagamento](/docs/guides/payment-methods) - Métodos de pagamento disponíveis
- [Tipos de Pagamento](/docs/guides/payment-types) - Pagamentos únicos, frequentes e subscrições
- [Webhooks](/docs/guides/webhooks) - Receba notificações de pagamento em tempo real
- [Tratamento de Erros](/docs/error-handling) - Trate erros graciosamente


## Precisa de Ajuda?

Contacte o nosso suporte técnico em [correio@easypay.pt](mailto:correio@easypay.pt).