Pular para o conteúdo principal

Migrando do iPAGARE

Lucas Santos - Suporte iPAGARE
Atualizado

Esta seção mostra o comparativo entre a integração com o iPAGARE e a integração correspondente no novo gateway Southpayments.

A API Direct substitui a Integração WEBSERVICE do iPAGARE, através da qual o estabelecimento já deve informar todos os dados para que a cobrança seja realizada. Não há necessidade de o cliente interagir com uma tela do Gateway.

A diferença principal é que, no iPAGARE, apenas pagamentos por cartão de crédito são possíveis via este tipo de integração. Ja na Southpayments é possível também efetuar pagamento por Boleto e PIX.

A integração com o iPAGARE recebe um POST de parâmetros de um formulário HTML, enquanto a Southpayments recebe um POST com dados no formato JSON.

 

1. PROCESSANDO UM PAGAMENTO

iPAGARE: POST em https://ww2.ipagare.com.br/service/process.do

Southpayments: POST em https://api.southpayments.com/orders

 

Cobrança de R$199,90 paga no cartão de crédito em 5x sem juros.

 

Parâmetro Nome no iPAGARE Nome na Southpayments
identificador do estabelecimento estabelecimento merchant_id
identificador da função a ser executada acao N/A (definida pela URL e método (POST))
chave de segurança da transação chave N/A (token no header do request)
código do pedido codigo_pedido order[merchant_key]
valor do pedido valor_total order[amount]
meio de pagamento codigo_pagamento

order[payment][payment_type]
parcelamento forma_pagamento order[payment][installments]
número do cartão de crédito numero_cartao order[payment][card_number]
mês de validade do cartão

mes_validade_cartao

 order[payment][card_expiration_month]
ano de validade do cartão ano_validade_cartao order[payment][card_expiration_year]
código de segurança do cartão codigo_seguranca_cartao order[payment][card_cvv]
nome do titular do cartão N/A order[payment][card_holder]
tipo do cliente tipo_cliente customer[customer_type]
nome do cliente nome_clinete customer[name]
email do cliente email_cliente customer[email]
cpf ou cnpj do cliente cpf_cnpj_cliente

customer[legal_number]

 

Envio dos parâmetros para o iPAGARE

<input type="hidden" name="estabelecimento" value="999999"/>
<input type="hidden" name="acao" value="1"/>
<input type="hidden" name="chave" value="f7372395c794c31dfb306c0042a9c3dd"/>
<input type="hidden" name="codigo_pedido" value="codigo do pedido"/>
<input type="hidden" name="valor_total" value="19990"/>
<input type="hidden" name="codigo_pagamento" value="53"/>
<input type="hidden" name="forma_pagamento" value="A05"/>
<input type="hidden" name="numero_cartao" value="4111111111111111"/>
<input type="hidden" name="mes_validade_cartao" value="12"/>
<input type="hidden" name="ano_validade_cartao" value="2025"/>
<input type="hidden" name="codigo_seguranca_cartao" value="123"/>
<input type="hidden" name="tipo_cliente" value="1"/>
<input type="hidden" name="nome_clinete" value="Joao Silva"/>
<input type="hidden" name="email_cliente" value="joao@silva.com"/>
<input type="hidden" name="cpf_cnpj_cliente" value="33333333333"/>


Envio dos parâmetros na Southpayments:

{
  "merchant_id": "4398yfnru3f7813",
  "order": {
    "merchant_key": "codigo do pedido", 
    "amount": 19990, 
    "payment:
     {
      "payment_type": "credit_card",
      "installments": 5,
      "card_number": "4111111111111111",
      "card_cvv": "123", 
      "card_expiration_month": "03", 
      "card_expiration_year": "2024", 
      "card_holder": "Joao Silva", 
     },
    "customer": {
     "customer_type":0,
     "name":"João Silva",
     "email":"joao@silva.com",
     "legal_number": "33333333333"
    }
  }
}

 

2. CONSULTANDO UM PEDIDO

iPAGARE: POST em https://ww2.ipagare.com.br/service/process.do

Southpayments: duas maneiras distintas

 

Parâmetro Nome no iPAGARE Nome na Southpayments
identificador do estabelecimento estabelecimento merchant_id
identificador da função a ser executada acao N/A (definida pela URL e método (GET))
código do pedido codigo_pedido merchant_key
versão da API versao N/A
chave de segurança da transação chave

N/A (token no Header do request)

 

Envio dos parâmetros para o iPAGARE

<input type="hidden" name="estabelecimento" value="999999"/>
<input type="hidden" name="acao" value="3"/>
<input type="hidden" name="chave" value="f7372395c794c31dfb306c0042a9c3dd"/>
<input type="hidden" name="codigo_pedido" value="codigo do pedido"/>
<input type="hidden" name="versao" value="2"/>


Envio dos parâmetros para a Southpayments:

1. Através do UID do Pedido

GET em https://api.southpayments.com/orders/67uygrbwIDssd982

{
  "merchant_id": "4398yfnru3f7813",
}

2. Através do Código do Pedido

GET em https://api.southpayments.com/orders/find_by_merchant_key

{
  "merchant_id": "4398yfnru3f7813",
  "merchant_key": "codigo do pedido",
}

Comentários

0 comentário

Por favor, entre para comentar.

Powered by Zendesk