Fintoc via API direta

Visão geral

Fintoc é um método de pagamento instantâneo latino-americano (Iniciação de Pagamento / Conta a Conta) que permite aos usuários pagar diretamente de sua conta bancária. A DEUNA integra o Fintoc usando um modelo de redirecionamento: após iniciar a compra através da API DEUNA, o usuário é redirecionado para uma página hospedada pelo Fintoc para fazer login em seu banco e autenticar o pagamento, depois retorna ao seu site.

Requisitos:

Disponível em Chile
Moeda: CLP (Chile)
O usuário deve ter uma conta ativa em um banco apoiado pela Fintoc

Comprar v2

As compras V2 realizam a criação do pedido e o início do pagamento em um único endpoint.

O processo de compra do Fintoc é o seguinte:

Chamadas de usuário POST v2/merchants/order/purchase com as informações do pedido.
DEUNA cria o pedido e inicia a transação Fintoc.
DEUNA retorna um URL de redirecionamento na resposta.
Você redireciona o usuário para esse URL para concluir o login e autenticação do banco na página do Fintoc.
Após a autenticação, o Fintoc redireciona o usuário de volta ao seu site.
DEUNA escuta a notificação do Fintoc (webhook) para confirmar o status do pagamento final.

Integrar Fintoc por API

1. Faça uma compra Fintoc

Faça uma solicitação ao Compra V2 endpoint.

Para fazer uma compra Fintoc com DEUNA, a carga útil V2 deve conter:

Os dados do pedido
URLs de retorno de chamada para redirecionar o usuário após o pagamento
Opcionalmente, o email ou número de identificação fiscal do cliente para pré-preencher o ecrã do Fintoc

📘 Todos os valores devem ser expressos em centavos. Exemplo: CLP 10,50 = 1050

Exemplo de solicitação

JSON

{
  "order_type": "DEUNA_CHECKOUT",
  "payment_source": {
    "method_type": "bank_transfer",
    "processor": "fintoc",
    "method_type_specific_fields": {
      "customer_email": "customer@example.com"
    }
  },
  "callback_urls": {
    "on_success": "https://example.com/success",
    "on_error": "https://example.com/error"
  },
  "order": {
    "order_id": "d81fe7bf-748b-4a7a-bc8f-7be98c8ae748",
    "store_code": "all",
    "currency": "CLP",
    "total_amount": 1050,
    "items_total_amount": 1050,
    "sub_total": 1050,
    "items": [
      {
        "id": "1",
        "name": "Cinema ticket",
        "description": "Standard ticket",
        "total_amount": {
          "amount": 1050,
          "currency": "CLP",
          "currency_symbol": "$"
        },
        "unit_price": {
          "amount": 1050,
          "currency": "CLP",
          "currency_symbol": "$"
        },
        "quantity": 1
      }
    ]
  }
}

2. Redirecione o usuário

Após o início da compra, a API responde com um URL de redirecionamento no next_action node.

Pegue o URL
Redirecione o usuário para esse URL.
O usuário conclui a autenticação na página Fintoc:
- Seleciona seu banco
- Faça login com suas credenciais de banco on-line
- Conclui autorização de MFA/contato, se exigido pelo banco
- Confirma o pagamento
Após a autenticação, o Fintoc redireciona o usuário de volta para o seu callback_urls.on_success ou callback_urls.on_error.
Ouça os webhooks da DEUNA para confirmar o status do pagamento final.

Exemplo de resposta

JSON

{
  "order_type": "DEUNA_CHECKOUT",
  "order_token": "db3fc147-2a4e-460f-a874-f6f79b1e651c",
  "order": {
    "order_id": "d81fe7bf-748b-4a7a-bc8f-7be98c8ae748",
    "currency": "CLP",
    "total_amount": 1050,
    "status": "pending",
    "payment": {
      "data": {
        "status": "pending",
        "method_type": "bank_transfer",
        "processor": "fintoc",
        "next_action": {
          "action": "authorization_bank_transfer",
          "authorization_bank_transfer": {
            "redirect_url": "https://checkout.fintoc.com/cs_li5531onlFDi235"
          }
        }