Qual método escolher?

Guia de decisão

Preciso de...	Método	Quando usar
Pagamento imediato no telemóvel	MB WAY	Cliente tem a app MB WAY. Aprovação em 5 min.
Referência ATM/homebanking	Multibanco	Cliente paga ao seu ritmo (1–30 dias).
Cartão em página alojada	Credit Card	Checkout web com 3D-Secure.
Apple Wallet (iOS/Safari)	Apple Pay	Pagamento tokenizado no browser ou app.
Google Pay (Android/Chrome)	Google Pay	Pagamento tokenizado no browser ou app.
Cliente escolhe como pagar	Pay By Link	Envia um único URL — facturas, social, sem checkout.
Reembolsar um pagamento	Refunds	Total ou parcial, requer credenciais OAuth.

Todos os métodos devolvem um PaymentResult. Campos comuns: transaction_id, status (PaymentStatus), amount (Decimal), payment_url (quando há redirect), raw_response (o JSON cru do eupago).

O ciclo completo

Todos os métodos seguem a mesma forma: criar → esperar → webhook → (opcional) reembolsar. A única diferença é como o cliente paga.

sequenceDiagram
    participant App
    participant eupago
    participant Cliente
    App->>eupago: create_payment / create_reference / pay_by_link
    eupago-->>App: PaymentResult (transaction_id, status PENDING, payment_url)
    App->>Cliente: Mostra entidade+referência / Redirect para payment_url / Envia link
    Cliente->>eupago: Conclui o pagamento (app / ATM / formulário cartão)
    eupago->>App: Webhook (status PAID)
    Note over App,eupago: Reembolso opcional (não há webhook para reembolso)
    App->>eupago: refunds.refund(transaction_id, value)
    eupago-->>App: PaymentResult (status REFUNDED)

Mesma forma para todos os métodos

from decimal import Decimal
from eupago import EupagoClient

client = EupagoClient(api_key="...", sandbox=True)

result = client.<metodo>.create_payment(
    order_id="ORD-001",
    amount=Decimal("49.90"),
    ...
)

print(result.status)          # PaymentStatus.PENDING
print(result.transaction_id)  # ID da transação
print(result.payment_url)     # URL da página alojada (quando aplicável)
print(result.raw_response)    # JSON cru do eupago (sempre)

Consulta as páginas individuais para os parâmetros exactos, e a pasta examples para scripts runnable de ponta a ponta.