Adquirente Cielo

Contratação e informações meios de pagamento

Na aba lateral direita está disponível exemplos para cada meio de pagamento em XML (para integração SOAP) e cURL (para integração REST).

Adquirente Cielo

MODALIDADE WEBSERVICE

Contratação

Contratando a solução da CIELO para e-commerce será possível oferecer na sua loja:

Vendas de cŕedito autenticadas (Bandeiras Visa e MasterCard);

  • Cartão de crédito Amex;
  • Cartão de crédito Aura;
  • Cartão de crédito Diners;
  • Cartão de crédito Discover;
  • Cartão de crédito Elo;
  • Cartão de crédito JCB;
  • Cartão de crédito MasterCard;
  • Cartão de crédito Visa;
  • Cartão de débito Maestro;
  • Cartão de débito Visa Electron;

Ao final do processo de contratação, deve-se estar de posse das seguintes informações para ativação da CIELO no Gateway:

  • Merchant ID;
  • Merchant Key;

O Yapay não participa das negociações entre o estabelecimento e bancos/adquirentes. Desta forma, taxas ou eventuais isenções são tratadas de forma direta entre os envolvidos.

Para contratar, acesse aqui.

Particulariedades

  • Para esta modalidade é necessário certificado SSL de segurança 2048 bits;
  • Integração na plataforma WebService API 3.0;
  • Caso o campo <codigoSeguranca> não for enviado ou for enviado com “000”, a transação será encaminhada a Cielo como modelo “Recorrente”, onde este campo não é obrigatório. Lembrando que para esta utilização é preciso habilitar junto a Adquirente. Salientamos que a conversão de seu estabelecimento pode diminuir;
  • Esta operadora de cartão permite cadastrar uma informação para aparecer na fatura dos clientes quando realizarem compras sua loja, funcionalidade chamada de SoftDescriptor. Esta deverá possuir até 13 caracteres. Caso queira utilizar, envie ao Suporte Yapay o nome desejado para configuração em seu estabelecimento. Também é possível o envio do SoftDescriptor por pedido, para isto solicite ao Suporte a ativação e envie a informação no campoLivre4 de cada transação;
  • Para transações com cartão de débito ou autenticada, o eCommerce deverá redirecionar o consumidor para a <urlPagamento>, onde o mesmo deverá incluir sua senha ou token no ambiente do banco emissor. Apenas após esta etapa, a transação será concluída.

Processo de Homologação com Adquirente

Após a integração com o Yapay, o estabelecimento deverá configurar as credenciais da Cielo no ambiente de produção do Yapay e apontar sua loja para o ambiente real do Gateway. Após isto, a loja deverá enviar ao Suporte Cielo (cieloecommerce@cielo.com.br) a URL da loja com um produto de teste no valor de R$1,00. O suporte Cielo realizará os testes em ambiente real e caso esteja dentro das conformidades a loja estará apta a realizar vendas em produção.

Exemplos Cartão de Crédito

REQUISIÇÃO

Estrutura simplificada de envio para adquirente Cielo. Caso seu estabelecimento utilize antifraude, seguir a estrutura completa.

RESPOSTA

Estrtura de retorno adquirente Cielo. Os comentários indicam a informação retornada da adquirente em cada campo.

Exemplos Cartão de Débito

REQUISIÇÃO

Estrutura simplificada de envio para adquirente Cielo.

Estrutra simplificada de envio Cielo:

RESPOSTA

Estrtura de retorno adquirente Cielo. Os comentários indicam a informação retornada da adquirente em cada campo.

    curl
        --request POST https://sandbox.gateway.yapay.com.br/checkout/api/v3/transacao
        --header "Content-Type: application/json"
        --header "usuario:{"login":"yapay","senha":"yapay"}"
        --data-binary
        {
        "codigoEstabelecimento" : 1000000000000,
        "codigoFormaPagamento" : 171,
        "transacao" : {
            "numeroTransacao" : 123,
            "valor" : 100,
            "parcelas" : 1,
            "idioma" : 1
        },
        "dadosCartao" : {
            "nomePortador" : "Teste Teste",
            "numeroCartao" : "0000000000000001",
            "codigoSeguranca" : "123",
            "dataValidade" : "12/2017"
        },
        "itensDoPedido" : [
        {
            "quantidadeProduto" : 1,
            "valorUnitarioProduto" : 100
        }
        ],
        "dadosCobranca" : {
            "nome" : "Teste Integração",
            "documento" : "12312312312"
        }
        }
    --header "Content-Type: application/json"
        {
        "numeroTransacao": 123,
        "codigoEstabelecimento": "1000000000000",
        "codigoFormaPagamento": 171,
        "valor": 2000,
        "valorDesconto": 0,
        "parcelas": 1,
        <!--Status que deverá ser tratado pelo eCommerce-->
        "statusTransacao": 1,
        <!--Código de autorização-->
        "autorizacao": "123456",
        <!--Código erro em caso de negação-->
        "codigoTransacaoOperadora": "0",
        <!--Data retorno adquirente-->
        "dataAprovacaoOperadora": "24/05/2017",
        <!--TID-->
        "numeroComprovanteVenda": "10069930690009F2122A",
        "nsu": "428706",
        <!--Mensagem adquirente-->
        "mensagemVenda": "Operation Success",
        "urlPagamento": "https://gateway.yapay.com.br/checkout/PagamentoCielo/PagamentoCielo.do?cod=14956291484887110cf2a-9aeb-4b34-a869-1a61f0611b66",
        "cartoesUtilizados": ["000000*******0001"]
        }

CHECKOUT CIELO (REDIRECIONADO)

Contratação

Contratando a solução da CIELO para e-commerce será possível oferecer os seguintes meios de pagamento na sua loja:

  • Cartão de crédito Amex;
  • Cartão de crédito Aura;
  • Cartão de crédito Diners;
  • Cartão de crédito Discover;
  • Cartão de crédito Elo;
  • Cartão de crédito JCB;
  • Cartão de crédito MasterCard;
  • Cartão de crédito Visa;
  • Cartão de débito Maestro;
  • Cartão de débito Visa Electron;

Ao final do processo de contratação, deve-se estar de posse das seguintes informações para ativação da CIELO no Gateway:

  • Código de filiação;
  • Merchant ID;

O Yapay não participa das negociações entre o estabelecimento e bancos/adquirentes. Desta forma, taxas ou eventuais isenções são tratadas de forma direta entre os envolvidos.

Para contratar, acesse aqui.

Particulariedades

  • Para utilização correta desta forma de pagamento, deve se enviado ao Suporte Yapay uma URL para redirecionamento do usuário após finalização do pagamento. Esta URL deve ser informada de forma completa, iniciando em HTTP ou HTTPS;
  • O eCommerce deverá redirecionar o consumidor para a URL retornada no campo <urlPagamento>;
  • Importante a utilização da campainha para atualização de status no eCommerce após finalização do pagamento;
  • O eCommerce enviará um único código ao Gateway relacionado ao meio de pagamento Checkout (52) e após a abertura da URL o consumidor escolherá a bandeira de cartão;
  • Necessário algumas configurações no painel Cielo. Passo a passo no próximo tópico deste documento.

Configuração painel Cielo

Etapas para configuração:

  • 1- Acesse o gerenciador Cielo
  • 2- Clique na aba “Configurações” –> “Configurações da loja”
  • 3- Primeiramente habilite em “Modo de Teste”
  • 4- Inclua as URLs abaixo:

EM TESTES Subtituir o valor 10000000000 pelo código de estabelecimento Yapay

Processo de Homologação com Adquirente

Após a integração com o Yapay, o estabelecimento deverá configurar as credenciais da Cielo no ambiente de produção do Yapay e apontar sua loja para o ambiente real do Gateway. Após isto, a loja deverá enviar ao Suporte Cielo (cieloecommerce@cielo.com.br) a URL da loja com um produto de teste no valor de R$1,00. O suporte Cielo realizará os testes em ambiente real e caso esteja dentro das conformidades a loja estará apta a realizar vendas em produção.

Exemplos

REQUISIÇÃO

Estrutura simplificada de envio para adquirente Cielo. Caso seu estabelecimento utilize antifraude, seguir a estrutura completa.

Estrutra simplificada REST de envio Cielo.

RESPOSTA

Estrtura de retorno adquirente Cielo. Os comentários indicam a informação retornada da adquirente em cada campo.

    curl
        --request POST https://gateway.yapay.com.br/checkout/api/v2/transacao
        --header "Content-Type: application/json"
        --header "usuario:{"login":"yapay","senha":"yapay"}"
        --data-binary
        {
        "codigoEstabelecimento" : 1000000000000,
        "codigoFormaPagamento" : 52,
        "transacao" : {
            "numeroTransacao" : 123,
            "valor" : 100,
            "parcelas" : 1,
            "idioma" : 1
        },
        "itensDoPedido" : [
        {
            "quantidadeProduto" : 1,
            "valorUnitarioProduto" : 100
        }
        ],
        "dadosCobranca" : {
            "nome" : "Teste Integração",
            "documento" : "12312312312"
        }
        }
    --header "Content-Type: application/json"
    {
    "numeroTransacao": 123,
    "codigoEstabelecimento": "1000000000000",
    "codigoFormaPagamento": 179,
    "valor": 2000,
    "valorDesconto": 0,
    "parcelas": 1,
    <!--Status que deverá ser tratado pelo eCommerce-->
    "statusTransacao": 5,
    <!--Código de autorização-->
    "autorizacao": "0",
    <!--Código erro em caso de negação-->
    "codigoTransacaoOperadora": "0",
    <!--Data retorno adquirente-->
    "dataAprovacaoOperadora": "24/05/2017",
    <!--TID-->
    "numeroComprovanteVenda": "10069930690009F2122A",
    "nsu": "0",
    <!--Mensagem adquirente-->
    "mensagemVenda": "Operation Success",
    <!--URL para redirecionar o consumidor-->
    "urlPagamento": "https://gateway.yapay.com.br/checkout/PagamentoCielo/PagamentoVisaElectron.do?cod=14956291484887110cf2a-9aeb-4b34-a869-1a61f0611b66",
    "cartoesUtilizados": ["000000*******0001"]
    }

Adquirente Rede

MODALIDADE WEBSERVICE

Contratação

Contratando a solução da e-Rede será possível oferecer na sua loja:

Cartão de crédito aunteticado (Bandeiras Visa e MasterCard);

  • Cartão de crédito aunteticado;
  • Cartão de crédito Visa;
  • Cartão de crédito MasterCard;
  • Cartão de crédito Hiper;
  • Cartão de crédito HierpCard;
  • Cartão de crédito JCB;
  • Cartão de crédito Credz;
  • Cartão de débito Visa Electron;
  • Cartão de débito Maestro;

Ao final do processo de contratação, deve-se estar de posse das seguintes informações para ativação do e-Rede no Gateway:

  • Filiação (PV);
  • Token;

O Yapay não participa das negociações entre o estabelecimento e bancos/adquirentes. Desta forma, taxas ou eventuais isenções são tratadas de forma direta entre os envolvidos.

Informações sobre a contratação, acesse aqui.

Particulariedades

  • Para esta modalidade é necessário certificado SSL de segurança 2048 bits;
  • Integração na plataforma WebService API 3.0;
  • Caso o campo não for enviado ou for enviado com "000", a transação será encaminhada a Cielo como modelo "Recorrente", onde este campo não é obrigatório. Lembrando que para esta utilização é preciso habilitar junto a Adquirente. Salientamos que a conversão de seu estabelecimento pode diminuir;
  • Esta operadora de cartão permite cadastrar uma informação para aparecer na fatura dos clientes quando realizarem compras sua loja, funcionalidade chamada de SoftDescriptor. Esta deverá possuir até 13 caracteres. Caso queira utilizar, envie ao Suporte Yapay o nome desejado para configuração em seu estabelecimento. Também é possível o envio do SoftDescriptor por pedido, para isto solicite ao Suporte a ativação e envie a informação no campoLivre4 de cada transação;
  • Para transações com cartão de débito ou autenticada, o eCommerce deverá redirecionar o consumidor para a , onde o mesmo deverá incluir sua senha ou token no ambiente do banco emissor. Apenas após esta etapa, a transação será concluída.

Processo de Homologação com Adquirente

Após a integração com o Yapay, o estabelecimento deverá configurar as credenciais da Cielo no ambiente de produção do Yapay e apontar sua loja para o ambiente real do Gateway. Após isto, a loja deverá enviar ao Suporte Cielo (cieloecommerce@cielo.com.br) a URL da loja com um produto de teste no valor de R$1,00. O suporte Cielo realizará os testes em ambiente real e caso esteja dentro das conformidades a loja estará apta a realizar vendas em produção.

Exemplos Cartão de Crédito

REQUISIÇÃO

Estrutura simplificada de envio para adquirente Cielo. Caso seu estabelecimento utilize antifraude, seguir a estrutura completa.

RESPOSTA

Estrtura de retorno adquirente Cielo. Os comentários indicam a informação retornada da adquirente em cada campo.

    curl
    --request POST https://gateway.yapay.com.br/checkout/api/v2/transacao
    --header "Content-Type: application/json"
    --header "usuario:{"login":"yapay","senha":"yapay"}"
    --data-binary
    {
    "codigoEstabelecimento" : 1000000000000,
    "codigoFormaPagamento" : 171,
    "transacao" : {
        "numeroTransacao" : 123,
        "valor" : 100,
        "parcelas" : 1,
        "idioma" : 1
    },
    "dadosCartao" : {
        "nomePortador" : "Teste Teste",
        "numeroCartao" : "0000000000000001",
        "codigoSeguranca" : "123",
        "dataValidade" : "12/2017"
    },
    "itensDoPedido" : [
    {
        "quantidadeProduto" : 1,
        "valorUnitarioProduto" : 100
    }
    ],
    "dadosCobranca" : {
        "nome" : "Teste Integração",
        "documento" : "12312312312"
    }
    }
    --header "Content-Type: application/json"
        {
        "numeroTransacao": 123,
        "codigoEstabelecimento": "1000000000000",
        "codigoFormaPagamento": 191,
        "valor": 500000,
        "valorDesconto": 0,
        "parcelas": 1,
        <!--Status que deverá ser tratado pelo eCommerce-->
        "statusTransacao": 1,
        <!--Código de autorização-->
        "autorizacao": "123456",
        <!--Código retorno Cielo-->
        "codigoTransacaoOperadora": "0",
        <!--Data retorno adquirente-->
        "dataAprovacaoOperadora": "24/05/2017",
        <!--TID-->
        "numeroComprovanteVenda": "10117092708342800232",
        "nsu": "428706",
        <!--Mensagem adquirente-->
        "mensagemVenda": "00 - Success",
        "urlPagamento": "14956291484887110cf2a-9aeb-4b34-a869-1a61f0611b66",
        "cartoesUtilizados": ["589916******0005"]
        }

Adquirente Bin - First Data

Contratação

Contratando a solução da Bin eCommerce será possível oferecer na sua loja:

  • Cartão de crédito Visa;
  • Cartão de crédito MasterCard;
  • Cartão de crédito Cabal;

Ao final do processo de contratação, deve-se estar de posse das seguintes informações para ativação do e-Rede no Gateway:

  • Store Id;
  • User Id;
  • Password;
  • Arquivo do certificado BIN;
  • Senha do certificado;
  • Terminal ID.

O Yapay não participa das negociações entre o estabelecimento e bancos/adquirentes. Desta forma, taxas ou eventuais isenções são tratadas de forma direta entre os envolvidos.

Informações sobre a contratação, acesse aqui

Particulariedades

  • Para esta modalidade é necessário certificado SSL de segurança 2048 bits;
  • Integração apenas na modalidade WebService.

Informações sobre a contratação, acesse aqui.

Particulariedades

  • Para esta modalidade é necessário certificado SSL de segurança 2048 bits;
  • Integração apenas na modalidade WebService.

Exemplos

REQUISIÇÃO

Estrutura simplificada de envio para adquirente Bin. Caso seu estabelecimento utilize antifraude, seguir a estrutura completa.

Estrutra simplificada REST de envio Bin:

RESPOSTA

Estrtura de retorno adquirente Bin. Os comentários indicam a informação retornada da adquirente em cada campo

    curl
        --request POST https://gateway.yapay.com.br/checkout/api/v2/transacao
        --header "Content-Type: application/json"
        --header "usuario:{"login":"yapay","senha":"yapay"}"
        --data-binary
        {
        "codigoEstabelecimento" : 1000000000000,
        "codigoFormaPagamento" : 381,
        "transacao" : {
            "numeroTransacao" : 123,
            "valor" : 500000,
            "parcelas" : 1,
            "idioma" : 1
        },
        "dadosCartao" : {
            "nomePortador" : "Teste Teste",
            "numeroCartao" : "5547220000000102",
            "codigoSeguranca" : "123",
            "dataValidade" : "12/2017"
        },
        "itensDoPedido" : [
        {
            "quantidadeProduto" : 1,
            "valorUnitarioProduto" : 100
        }
        ],
        "dadosCobranca" : {
            "nome" : "Teste Integração",
            "documento" : "12312312312"
        }
        }
    --header "Content-Type: application/json"
    {
    "numeroTransacao": 123,
    "codigoEstabelecimento": "1000000000000",
    "codigoFormaPagamento": 381,
    "valor": 100,
    "valorDesconto": 0,
    "parcelas": 1,
    <!--Status que deverá ser tratado pelo eCommerce-->
    "statusTransacao": 1,
    <!--Código de autorização-->
    "autorizacao": "657409",
    <!--Código retorno Bin-->
    "codigoTransacaoOperadora": "0",
    <!--Data retorno adquirente-->
    "dataAprovacaoOperadora": "20/10/2017 16:36:43",
    <!--TID-->
    "numeroComprovanteVenda": "Y:657409:4514266711:PPX :632615",
    "nsu": "",
    <!--Mensagem adquirente-->
    "mensagemVenda": "APPROVAL 000009113",
    "urlPagamento": "14956291484887110cf2a-9aeb-4b34-a869-1a61f0611b66",
    "cartoesUtilizados": ["554722******0102"]
    }

Adquirente GetNet

Contratação

Contratando a solução da GetNet eCommerce será possível oferecer na sua loja:

  • Cartão de crédito Visa;
  • Cartão de crédito MasterCard;

Ao final do processo de contratação, deve-se estar de posse das seguintes informações para ativação da GetNet no Gateway:

  • Merchant Id;
  • Terminal Id;
  • Usuário;
  • Senha.

O Yapay não participa das negociações entre o estabelecimento e bancos/adquirentes. Desta forma, taxas ou eventuais isenções são tratadas de forma direta entre os envolvidos.

Informações sobre a contratação, acesse aqui.

Particulariedades

  • Para esta modalidade é necessário certificado SSL de segurança 2048 bits;
  • Integração apenas na modalidade WebService.

Exemplos

REQUISIÇÃO

Estrutura simplificada de envio para adquirente GetNet. Caso seu estabelecimento utilize antifraude, seguir a estrutura completa.

Estrutra simplificada REST de envio GetNet:

RESPOSTA

Estrtura de retorno adquirente GetNet. Os comentários indicam a informação retornada da adquirente em cada campo.

    curl
        --request POST https://gateway.yapay.com.br/checkout/api/v2/transacao
        --header "Content-Type: application/json"
        --header "usuario:{"login":"yapay","senha":"yapay"}"
        --data-binary
        {
        "codigoEstabelecimento" : 1000000000000,
        "codigoFormaPagamento" : 271,
        "transacao" : {
            "numeroTransacao" : 123,
            "valor" : 500000,
            "parcelas" : 1,
            "idioma" : 1
        },
        "dadosCartao" : {
            "nomePortador" : "Teste Teste",
            "numeroCartao" : "5453010000083303",
            "codigoSeguranca" : "123",
            "dataValidade" : "12/2017"
        },
        "itensDoPedido" : [
        {
            "quantidadeProduto" : 1,
            "valorUnitarioProduto" : 100
        }
        ],
        "dadosCobranca" : {
            "nome" : "Teste Integração",
            "documento" : "12312312312"
        }
        }

    --header "Content-Type: application/json"
        {
        "numeroTransacao": 123,
        "codigoEstabelecimento": "1000000000000",
        "codigoFormaPagamento": 271,
        "valor": 100,
        "valorDesconto": 0,
        "parcelas": 1,
        <!--Status que deverá ser tratado pelo eCommerce-->
        "statusTransacao": 1,
        <!--Código de autorização-->
        "autorizacao": "1234",
        <!--Código retorno GetNet-->
        "codigoTransacaoOperadora": "0",
        <!--Data retorno adquirente-->
        "dataAprovacaoOperadora": "1017",
        <!--TID-->
        "numeroComprovanteVenda": "1662429594",
        "nsu": "",
        <!--Mensagem adquirente-->
        "mensagemVenda": "CAPTURED",
        "urlPagamento": "14956291484887110cf2a-9aeb-4b34-a869-1a61f0611b66",
        "cartoesUtilizados": ["545301******3303"]
        }

Adquirente Stone

Contratação

Contratando a solução da Stone eCommerce será possível oferecer na sua loja:

  • Cartão de crédito Visa;
  • Cartão de crédito MasterCard;

Ao final do processo de contratação, deve-se estar de posse das seguintes informações para ativação do e-Rede no Gateway:

  • Sale affiliation key;
  • Stone Code;

As credenciais deverão ser solicitadas para ecommerce@stone.com.br ou (11) 31573124.

O Yapay não participa das negociações entre o estabelecimento e bancos/adquirentes. Desta forma, taxas ou eventuais isenções são tratadas de forma direta entre os envolvidos.

Informações sobre a contratação, acesse aqui.

Particulariedades

  • Para esta modalidade é necessário certificado SSL de segurança 2048 bits;
  • Integração apenas na modalidade WebService.

Exemplos

REQUISIÇÃO

Estrutura simplificada de envio para adquirente GetNet. Caso seu estabelecimento utilize antifraude, seguir a estrutura completa.

Estrutra simplificada REST de envio GetNet:

RESPOSTA

Estrtura de retorno adquirente GetNet. Os comentários indicam a informação retornada da adquirente em cada campo.

    curl
        --request POST https://gateway.yapay.com.br/checkout/api/v2/transacao
        --header "Content-Type: application/json"
        --header "usuario:{"login":"yapay","senha":"yapay"}"
        --data-binary
        {
        "codigoEstabelecimento" : 1000000000000,
        "codigoFormaPagamento" : 351,
        "transacao" : {
            "numeroTransacao" : 123,
            "valor" : 500000,
            "parcelas" : 1,
            "idioma" : 1
        },
        "dadosCartao" : {
            "nomePortador" : "Teste Teste",
            "numeroCartao" : "5431111111111111",
            "codigoSeguranca" : "123",
            "dataValidade" : "12/2017"
        },
        "itensDoPedido" : [
        {
            "quantidadeProduto" : 1,
            "valorUnitarioProduto" : 100
        }
        ],
        "dadosCobranca" : {
            "nome" : "Teste Integração",
            "documento" : "12312312312"
        }
        }

    --header "Content-Type: application/json"
        {
        "numeroTransacao": 123,
        "codigoEstabelecimento": "1000000000000",
        "codigoFormaPagamento": 351,
        "valor": 100,
        "valorDesconto": 0,
        "parcelas": 1,
        <!--Status que deverá ser tratado pelo eCommerce-->
        "statusTransacao": 1,
        <!--Código de autorização-->
        "autorizacao": "1234",
        <!--Código retorno Stone-->
        "codigoTransacaoOperadora": "0",
        <!--Data retorno adquirente-->
        "dataAprovacaoOperadora": "20/10/2017 16:36:43",
        <!--TID-->
        "numeroComprovanteVenda": "1662429594",
        "nsu": "",
        <!--Mensagem adquirente-->
        "mensagemVenda": "Transação Aprovada",
        "urlPagamento": "14956291484887110cf2a-9aeb-4b34-a869-1a61f0611b66",
        "cartoesUtilizados": ["543111******1111"]
        }

Banco Banrisul

Contratação

Contratando a solução BanriCompras será possível oferecer na sua loja:

  • Boleto sem registro;
  • Pagamento pré datado;
  • Pagamentos parcelados;
  • Pagamentos á vista.

Ao final do processo de contratação, deve-se estar de posse das seguintes informações para ativação do e-Rede no Gateway:

  • Código do estabelecimento Banrisul;
  • Código da rede;
  • Senha de consulta.

O Yapay não participa das negociações entre o estabelecimento e bancos/adquirentes. Desta forma, taxas ou eventuais isenções são tratadas de forma direta entre os envolvidos.

Informações sobre a contratação, entre em contato com banrisul_cartoes_atendimento_adquirencia@banrisul.com.br

Particulariedades

  • Modalidades com redirecionamento;
  • Para utilização das modalidades Banricompras, todos os campos referente aos dados do cliente devem ser preenchidos;
  • Se não for informado uma data de vencimento do boleto, a data de vencimento que aparecerá no boleto será os dias de vencimento configurado internamente no Gateway;
  • Processo de homologação junto ao Banrisul obrigatório para liberação em produção.

Configurações ambiente Banrisul

Para o Gateway de Pagamento funcionar corretamente, é necessário configurar algumas urls no ambiente do Banricompras.

Ambiente Link Painel Banrisul Url Campainha Método para envio
HOMOLOGAÇÃO https://ww4.banrisul.com.br/banricompras/ https://gateway.sandbox.yapay.com.br/checkout/Banrisul/NotificacaoBanrisul.do POST
PRODUÇÃO https://ww7.banrisul.com.br/banricompras/ https://gateway.yapay.com.br/checkout/Banrisul/NotificacaoBanrisul.do POST

PÁGINAS DE AVISO DE OPERAÇÃO

Ambiente Link Painel Banrisul Url Sucesso Url Não Pago
HOMOLOGAÇÃO https://ww4.banrisul.com.br/banricompras/ https://gateway.sandbox.yapay.com.br/checkout/Banrisul/RedirecionamentoBanrisulOk.do https://gateway.yapay.com.br/yapay/Banrisul/RedirecionamentoBanrisulNoOk.do
PRODUÇÃO https://ww7.banrisul.com.br/banricompras/ https://gateway.yapay.com.br/checkout/Banrisul/RedirecionamentoBanrisulOk.do https://gateway.yapay.com.br/checkout/Banrisul/RedirecionamentoBanrisulNoOk.do

Processo de Homologação

Após realizar a integração com o Yapay em ambiente de testes e configurações no painel Banrisul, enviar para tecnologia_homologacoes@banrisul.com.br o link de acesso a página de testes, bem como o código de usuário e senha para login. Assim que o processo for finalizado pela equipe Banrisul, os mesmos enviarão os dados de produção para o estabelecimento.

Exemplos

REQUISIÇÃO

Estrutura de envio para banco Banrisul.

Estrutra SOAP de envio Banrisul:

    curl
        --request POST https://gateway.yapay.com.br/checkout/api/v2/transacao
        --header "Content-Type: application/json"
        --header "usuario:{"login":"yapay","senha":"yapay"}"
        --data-binary
        {
        codigoEstabelecimento: 1000000000000,
        codigoFormaPagamento: 26,
        transacao: {
            numeroTransacao: 1,
            valor: 2000,
            valorDesconto: 0,
            parcelas : 1,
            urlCampainha : http://seusite.com.br/campainha,
            urlResultado : http://seusite.com.br/retorno,
            ip : "192.168.12.110",
            idioma : 1,
            dataVencimentoBoleto : "10/10/2018"
        },
        itensDoPedido: [
        {
            codigoProduto: 1,
            nomeProduto: Blusa,
            codigoCategoria: 1,
            nomeCategoria : Roupa,
            quantidadeProduto : 1,
            valorUnitarioProduto : 2000
        }
        ],
        dadosCobranca : {
            codigoCliente : 1,
            tipoCliente : 1,
            nome : Teste Yapay,
            email : teste@teste.com,
            dataNascimento : "",
            sexo : "M",
            documento : "12312321312",
            endereco : {
            logradouro : Rua Teste,
            numero : 123,
            complemento : "",
            cep : 12345-678,
            bairro : Bairro Teste,
            cidade : Cidade Teste,
            estado : SP,
            pais : BR
        },
        telefone : [
        {
            tipoTelefone : 1,
            ddi : 55,
            ddd : 12,
            telefone : 1234-5678
        }
        ]
        },
        dadosEntrega : {
            nome : Teste Yapay,
            email : teste@teste.com,
            endereco : {
            logradouro : Rua teste,
            numero : 123,
            complemento : "",
            cep : 12345-678,
            bairro : Bairro Teste,
            cidade : Cidade Teste,
            estado : SP,
            pais : BR
        },
        telefone : [
        {
            tipoTelefone : 1,
            ddi : 55,
            ddd : 12,
            telefone : 1234-5678
        }
        ]
        }
        }

    --header "Content-Type: application/json"
        {
        "numeroTransacao": 1,
        "codigoEstabelecimento": "1000000000000",
        "codigoFormaPagamento": 26,
        "valor": 2000,
        "valorDesconto": 0,
        "parcelas": 1,
        "statusTransacao": 8,
        "autorizacao": ,
        "codigoTransacaoOperadora": "0",
        "dataAprovacaoOperadora": ,
        "numeroComprovanteVenda": ,
        "nsu": ,
        "mensagemVenda": ,
        "urlPagamento": "https://gateway.yapay.com.br/checkout/Boleto/PagamentoBanrisul.do?cod=141348960683a720e602-5631-4725-8f79-268c06795a3c"
        }

Itaú ShopLine

Contratação

Contratando a solução Itaú ShopLine será possível oferecer na sua loja:

  • Boleto sem ou com registro, dependendo de seu contrato com o banco;
  • Transferência eletrônica;

Ao final do processo de contratação, deve-se estar de posse das seguintes informações para ativação do e-Rede no Gateway:

  • Código da empresa;
  • Chave de acesso.

O Yapay não participa das negociações entre o estabelecimento e bancos/adquirentes. Desta forma, taxas ou eventuais isenções são tratadas de forma direta entre os envolvidos.

Informações sobre a contratação, acesse aqui.

Particulariedades

  • Modalidades com redirecionamento;
  • O tamanho do número do pedido deverá ser de no máximo 8 dígitos;
  • Para utilização das modalidades ShopLine, todos os campos referente aos dados do cliente devem ser preenchidos;
  • Tempo padrão de consulta no banco para atualização do status no Yapay: 120 dias;
  • Se não for informado uma data de vencimento do boleto, a data de vencimento que aparecerá no boleto será os dias de vencimento configurado internamente no Gateway;

Configurações ambiente Itaú ShopLine

  • Para o Gateway de Pagamento funcionar corretamente, é necessário configurar URL de retorno no BankLine.
  • Acesse o BankLine, aba Cobrança > Itaú Shopline > Informações Cadastrais e inclua a URL abaixo no campo “URL Retorno”

URL RETORNO: https://gateway.yapay.com.br/checkout/

Exemplos

REQUISIÇÃO

Estrutura de envio para banco Itaú.

Estrutra REST de envio Itaú:

RESPOSTA

Estrtura de retorno Itaú.

    curl
        --request POST https://gateway.yapay.com.br/checkout/api/v2/transacao
        --header "Content-Type: application/json"
        --header "usuario:{"login":"yapay","senha":"yapay"}"
        --data-binary
        {
        codigoEstabelecimento: 1000000000000,
        codigoFormaPagamento: 16,
        transacao: {
            numeroTransacao: 1,
            valor: 2000,
            valorDesconto: 0,
            parcelas : 1,
            urlCampainha : http://seusite.com.br/campainha,
            urlResultado : http://seusite.com.br/retorno,
            ip : "192.168.12.110",
            idioma : 1
        },
        itensDoPedido: [
        {
            codigoProduto: 1,
            nomeProduto: Blusa,
            codigoCategoria: 1,
            nomeCategoria : Roupa,
            quantidadeProduto : 1,
            valorUnitarioProduto : 2000
        }
        ],
        dadosCobranca : {
            codigoCliente : 1,
            tipoCliente : 1,
            nome : Teste Yapay,
            email : teste@teste.com,
            dataNascimento : "",
            sexo : "M",
            documento : "12312321312",
            endereco : {
            logradouro : Rua Teste,
            numero : 123,
            complemento : "",
            cep : 12345-678,
            bairro : Bairro Teste,
            cidade : Cidade Teste,
            estado : SP,
            pais : BR
        },
        telefone : [
        {
            tipoTelefone : 1,
            ddi : 55,
            ddd : 12,
            telefone : 1234-5678
        }
        ]
        },
        dadosEntrega : {
            nome : Teste Yapay,
            email : teste@teste.com,
            endereco : {
            logradouro : Rua teste,
            numero : 123,
            complemento : "",
            cep : 12345-678,
            bairro : Bairro Teste,
            cidade : Cidade Teste,
            estado : SP,
            pais : BR
        },
        telefone : [
        {
            tipoTelefone : 1,
            ddi : 55,
            ddd : 12,
            telefone : 1234-5678
        }
        ]
        }
        }


    --header "Content-Type: application/json"
        {
        "numeroTransacao": 1,
        "codigoEstabelecimento": "1000000000000",
        "codigoFormaPagamento": 16,
        "valor": 2000,
        "valorDesconto": 0,
        "parcelas": 1,
        "statusTransacao": 8,
        "autorizacao": ,
        "codigoTransacaoOperadora": "0",
        "dataAprovacaoOperadora": ,
        "numeroComprovanteVenda": ,
        "nsu": ,
        "mensagemVenda": ,
        "urlPagamento": "https://gateway.yapay.com.br/checkout/PagamentoItauShopline/PagamentoItauShopline.do?cod=141348960683a720e602-5631-4725-8f79-268c06795a3c"
        }

Bradesco ShopFácil

BOLETO

Contratação

Contratando a solução Bradesco ShopFácil será possível oferecer na sua loja:

  • Boleto sem ou com registro, dependendo de seu contrato com o banco;

Ao final do processo de contratação, deve-se estar de posse das seguintes informações para ativação do e-Rede no Gateway:

  • Merchantid;
  • Email de acesso ao gerenciador;
  • Chave de Acesso; (Gerada dentro do gerenciador do Bradesco, passo a passo abaixo);
  • Número da Carteira.

O Yapay não participa das negociações entre o estabelecimento e bancos/adquirentes. Desta forma, taxas ou eventuais isenções são tratadas de forma direta entre os envolvidos.

Informações sobre a contratação, acesse aqui

Particulariedades

  • Modalidades com redirecionamento;
  • Para utilização das modalidades ShopFácil, todos os campos referente aos dados do cliente devem ser preenchidos;
  • Se não for informado uma data de vencimento do boleto, a data de vencimento que aparecerá no boleto será os dias de vencimento configurado internamente no Gateway;

Configurações ambiente ShopFácil

Gerando chave de acesso

Procedimento idêntico em ambos ambientes:

Ambiente URL
HOMOLOGAÇÃO https://homolog.meiosdepagamentobradesco.com.br/gerenciadorapi
PRODUÇÃO https://meiosdepagamentobradesco.com.br/gerenciadorapi

Após logar, acesse Configurações > Meios de Pagamento > Boleto Bancário, inclua uma palavra secreta para geração da chave.

Configurando URL de notificação

Após logar, acesse Configuração > Meios de Pagamento > Boleto Bancário, incluir no campo “URL de notificação”:

Ambiente URL
HOMOLOGAÇÃO https://homologacao.yapay.com.br/checkout/bradesco/confirmaBoletoRegistro
PRODUÇÃO https://yapay.com.br/checkout/bradesco/confirmaBoletoRegistro

Processo de Homologação

Procedimento deve ser realizado em duas etapas, ambiente de homologação e ambiente de Produção:

Homologação

Realizar as configurações no painel Bradesco conforme informado acima e solicitar ao Suporte Yapay realizar a configuração do meio de pagamento em nosso ambiente de homologação, informando a ele os dados abaixo:

  • Merchantid;
  • Email de acesso ao gerenciador de homologação;
  • Chave de acesso de homologação;
  • Número da carteira;

A loja virtual deverá estar apontando para o ambiente de homologação e depois disto basta enviar email kit@scopus.com.br com a URL da loja com um produto de R$1,00 disponível para testes e o CNPJ do estabelecimento. Depois que a equipe do Bradesco validar este ambiente, o estabelecimento receberá novos dados, desta vez os dados reais da loja. E o procedimento deverá ser repedito porém desta vez em ambiente de produção.

Produção

Realizar as configurações no painel Bradesco conforme informado acima e solicitar ao Suporte Yapay realizar a configuração do meio de pagamento em nosso ambiente de produção, informando a ele os dados abaixo:

  • Merchantid;
  • Email de acesso ao gerenciador de homologação;
  • Chave de acesso de homologação;
  • Número da carteira;

A loja virtual deverá estar apontando para o ambiente de produção e depois disto basta enviar email kit@scopus.com.br com a URL da loja com um produto de R$1,00 disponível para testes e o CNPJ do estabelecimento. Depois que a equipe do Bradesco validar este ambiente, o estabelecimento estará apto a realizar vendas em produção.

Exemplos

REQUISIÇÃO

Estrutura de envio para banco Bradesco.

Estrutra REST de envio Bradesco Transferência:

Estrtura de retorno Bradesco.

curl
--request POST https://homologacao.yapay.com.br/checkout/api/v2/transacao
--header "Content-Type: application/json"
--header "usuario:{"login":"yapay","senha":"yapay"}"
--data-binary
{
   codigoEstabelecimento: 1000000000000,
   codigoFormaPagamento: 18,
   transacao: {
    numeroTransacao: 1,
    valor: 2000,
    valorDesconto: 0,
    parcelas : 1,
    urlCampainha : http://seusite.com.br/campainha,
    urlResultado : http://seusite.com.br/retorno,
    ip : "192.168.12.110",
    idioma : 1
   },
   itensDoPedido: [
  {
    codigoProduto: 1,
    nomeProduto: Blusa,
    codigoCategoria: 1,
    nomeCategoria : Roupa,
    quantidadeProduto : 1,
    valorUnitarioProduto : 2000
  }
   ],
   dadosCobranca : {
    codigoCliente : 1,
    tipoCliente : 1,
    nome : Teste Yapay,
    email : teste@teste.com,
    dataNascimento : "",
    sexo : "M",
    documento : "12312321312",
    endereco : {
    logradouro : Rua Teste,
    numero : 123,
    complemento : "",
    cep : 12345-678,
    bairro : Bairro Teste,
    cidade : Cidade Teste,
    estado : SP,
    pais : BR
  },
  telefone : [
  {
    tipoTelefone : 1,
    ddi : 55,
    ddd : 12,
    telefone : 1234-5678
  }
  ]
   },
   dadosEntrega : {
    nome : Teste Yapay,
    email : teste@teste.com,
    endereco : {
    logradouro : Rua teste,
    numero : 123,
    complemento : "",
    cep : 12345-678,
    bairro : Bairro Teste,
    cidade : Cidade Teste,
    estado : SP,
    pais : BR
  },
  telefone : [
  {
    tipoTelefone : 1,
    ddi : 55,
    ddd : 12,
    telefone : 1234-5678
  }
  ]
   }
}


--header "Content-Type: application/json"
{
   "numeroTransacao": 1,
   "codigoEstabelecimento": "1000000000000",
   "codigoFormaPagamento": 18,
   "valor": 2000,
   "valorDesconto": 0,
   "parcelas": 1,
   "statusTransacao": 8,
   "autorizacao": ,
   "codigoTransacaoOperadora": "0",
   "dataAprovacaoOperadora": ,
   "numeroComprovanteVenda": ,
   "nsu": ,
   "mensagemVenda": ,
   "urlPagamento": "https://gateway.yapay.com.br/checkout/Transferencia/PagamentoBradescoShopFacil.do?cod=141348960683a720e602-5631-4725-8f79-268c06795a3c"
}

Banco do Brasil Online

Contratação

Contratando a solução BBOnline será possível oferecer na sua loja:

  • Boleto sem ou com registro, dependendo de seu contrato com o banco;
  • Transferência Eletrônica.

Ao final do processo de contratação, deve-se estar de posse das seguintes informações para ativação do e-Rede no Gateway:

  • Códido do convênio;
  • Código cobrança.

O Yapay não participa das negociações entre o estabelecimento e bancos/adquirentes. Desta forma, taxas ou eventuais isenções são tratadas de forma direta entre os envolvidos.

Informações sobre a contratação, acesse aqui

Particulariedades

  • Modalidades com redirecionamento;
  • Para utilização das modalidades BBOnline, todos os campos referente aos dados do cliente devem ser preenchidos;
  • Se não for informado uma data de vencimento do boleto, a data de vencimento que aparecerá no boleto será os dias de vencimento configurado internamente no Gateway;

Exemplos

REQUISIÇÃO

Estrutura de envio para banco do Brasil.

RESPOSTA

Estrtura de retorno BBOnline:

curl
--request POST https://gateway.yapay.com.br/checkout/api/v2/transacao
--header "Content-Type: application/json"
--header "usuario:{"login":"yapay","senha":"yapay"}"
--data-binary
{
   codigoEstabelecimento: 1000000000000,
   codigoFormaPagamento: 21,
   transacao: {
    numeroTransacao: 1,
    valor: 2000,
    valorDesconto: 0,
    parcelas : 1,
    urlCampainha : http://seusite.com.br/campainha,
    urlResultado : http://seusite.com.br/retorno,
    ip : "192.168.12.110",
    idioma : 1
   },
   itensDoPedido: [
  {
    codigoProduto: 1,
    nomeProduto: Blusa,
    codigoCategoria: 1,
    nomeCategoria : Roupa,
    quantidadeProduto : 1,
    valorUnitarioProduto : 2000
  }
   ],
   dadosCobranca : {
    codigoCliente : 1,
    tipoCliente : 1,
    nome : Teste Yapay,
    email : teste@teste.com,
    dataNascimento : "",
    sexo : "M",
    documento : "12312321312",
    endereco : {
    logradouro : Rua Teste,
    numero : 123,
    complemento : "",
    cep : 12345-678,
    bairro : Bairro Teste,
    cidade : Cidade Teste,
    estado : SP,
    pais : BR
  },
  telefone : [
  {
    tipoTelefone : 1,
    ddi : 55,
    ddd : 12,
    telefone : 1234-5678
  }
  ]
   },
   dadosEntrega : {
    nome : Teste Yapay,
    email : teste@teste.com,
    endereco : {
    logradouro : Rua teste,
    numero : 123,
    complemento : "",
    cep : 12345-678,
    bairro : Bairro Teste,
    cidade : Cidade Teste,
    estado : SP,
    pais : BR
  },
  telefone : [
  {
    tipoTelefone : 1,
    ddi : 55,
    ddd : 12,
    telefone : 1234-5678
  }
  ]
   }
}


--header "Content-Type: application/json"
{
   "numeroTransacao": 1,
   "codigoEstabelecimento": "1000000000000",
   "codigoFormaPagamento": 21,
   "valor": 2000,
   "valorDesconto": 0,
   "parcelas": 1,
   "statusTransacao": 8,
   "autorizacao": ,
   "codigoTransacaoOperadora": "0",
   "dataAprovacaoOperadora": ,
   "numeroComprovanteVenda": ,
   "nsu": ,
   "mensagemVenda": ,
   "urlPagamento": "https://gateway.yapay.com.br/checkout/PagamentoBBOnline/PagamentoBBOnline.do?cod=147499950329455715d65-621f-4b80-896c-5d1a645fb9e0"
}

Boletos Offlines

BOLETOS REGISTRADOS

Com esta modalidade, os bancos possuem conehcimento do boleto desde sua geração, permitindo o lojista realizar protestos ao cliente caso o pagamento não for realizado.

Para utilização de qualquer boleto com carteira registrada é preciso realizar a abertura de relacionamento entre o banco e VAN homologada com o Yapay.

Santander

  • agência;
  • conta;
  • código do cedente;
  • número da carteira;
  • espécie de documento; (Exemplos: DM, RM, ME, NP)
  • código de transmissão.

Caixa Econômica Federal

  • agência;
  • conta;
  • código do convênio;
  • número da carteira;
  • código de operação;
  • espécie de documento. (Exemplos: DM, RM, ME, NP)

Itaú

  • agência;
  • conta;
  • número da carteira;
  • espécie de documento. (Exemplos: DM, RM, ME, NP)

Bradesco

  • agência;
  • conta;
  • número da carteira;
  • espécie de documento. (Exemplos: DM, RM, ME, NP)

Banco do Brasil

  • agência;
  • conta;
  • código do convênio;
  • número da carteira;
  • variação da carteira;
  • espécie de documento. (Exemplos: DM, RM, ME, NP);
  • client ID;
  • secret;

Particulariedades

  • Para a geração de Boleto offlines, todos os campos referente aos dados do cliente devem ser preenchidos;
  • Arquivo de registro e conciliação com layout de 400 posições para todos os bancos;
  • Campo <estadoComprador> deve ser preenchido pela sigla;
  • O tamanho do número do pedido, deverá possuir no máximo 8 dígitos;
  • Se não for informado uma data de vencimento do boleto na requisição, a data de vencimento que aparecerá no boleto será os dias de vencimento configurados internamente no Gateway;
  • A URL retornada no campo <urlPagamento> em SOAP e <url_acesso> em REST deverá ser repassada ao comprador para visualização/pagamento do boleto;
  • A requisição e retorno do Yapay para boletos registrados possuem a mesma estrutura dos sem registro, porém o status a ser retornado será 5 (transação em andamento) ao invés de 8 (aguardando pagamento);
  • Para ativação do boleto registrado e Módulo de Conciliação entrar em contato com comercial@yapay.com.br;
  • O Yapay não participa das negociações entre o estabelecimento e bancos/administradoras. Desta forma, taxas ou eventuais isenções são tratadas de forma direta entre os envolvidos.

BOLETOS SEM REGISTROS

O Gateway de Pagamento aceita boletos sem registro emitidos pelos seguintes bancos:

  • Itaú;
  • Bradesco;
  • Banco do Brasil;
  • Caixa;
  • Santander.

Ao final do processo de contratação, deve-se estar de posse das seguintes informações para ativação dos boletos no Gateway:

  • Convênio;
  • Agência;
  • Conta;
  • Número da Carteira;
  • Espécie de Documento. (Exemplos: DM, RM, ME, NP)

Particulariedades

  • Para a geração de Boleto offlines, todos os campos referente aos dados do cliente devem ser preenchidos.
  • Campo <estadoComprador> deve ser preenchido pela sigla;
  • O tamanho do número do pedido, deverá possuir no máximo 8 dígitos;
  • Se não for informado uma data de vencimento do boleto na requisição, a data de vencimento que aparecerá no boleto será os dias de vencimento configurados internamente no Gateway;
  • A URL retornada no campo <urlPagamento> em SOAP e <url_acesso> em REST deverá ser repassada ao comprador para visualização/pagamento do boleto;
  • Conciliação de boletos não é realizada automaticamente, para tal deve ser contratado o Módulo de Conciliação do Gateway. Para informações entrar em contato com comercial@yapay.com.br;
  • O Yapay não participa das negociações entre o estabelecimento e bancos/administradoras. Desta forma, taxas ou eventuais isenções são tratadas de forma direta entre os envolvidos.

Contratação

Contratando a solução BBOnline será possível oferecer na sua loja:

  • Boleto sem ou com registro, dependendo de seu contrato com o banco;
  • Transferência Eletrônica.

Ao final do processo de contratação, deve-se estar de posse das seguintes informações para ativação do e-Rede no Gateway:

  • Códido do convênio;
  • Código cobrança.

O Yapay não participa das negociações entre o estabelecimento e bancos/adquirentes. Desta forma, taxas ou eventuais isenções são tratadas de forma direta entre os envolvidos.

Informações sobre a contratação, acesse aqui

Particulariedades

  • Modalidades com redirecionamento;
  • Para utilização das modalidades BBOnline, todos os campos referente aos dados do cliente devem ser preenchidos;
  • Se não for informado uma data de vencimento do boleto, a data de vencimento que aparecerá no boleto será os dias de vencimento configurado internamente no Gateway;

Exemplos

REQUISIÇÃO

Estrutura de envio para geração de boletos sem/com registro.

RESPOSTA

Estrtura de retorno Boleto registrado:

curl
--request POST https://gateway.yapay.com.br/checkout/api/v2/transacao
--header "Content-Type: application/json"
--header "usuario:{"login":"yapay","senha":"yapay"}"
--data-binary
{
   codigoEstabelecimento: 1000000000000,
   codigoFormaPagamento: 30,
   transacao: {
    numeroTransacao: 1,
    valor: 2000,
    valorDesconto: 0,
    parcelas : 1,
    urlCampainha : http://seusite.com.br/campainha,
    urlResultado : http://seusite.com.br/retorno,
    ip : "192.168.12.110",
    idioma : 1
   },
   itensDoPedido: [
  {
    codigoProduto: 1,
    nomeProduto: Blusa,
    codigoCategoria: 1,
    nomeCategoria : Roupa,
    quantidadeProduto : 1,
    valorUnitarioProduto : 2000
  }
   ],
   dadosCobranca : {
    codigoCliente : 1,
    tipoCliente : 1,
    nome : Teste Yapay,
    email : teste@teste.com,
    dataNascimento : "",
    sexo : "M",
    documento : "12312321312",
    endereco : {
    logradouro : Rua Teste,
    numero : 123,
    complemento : "",
    cep : 12345-678,
    bairro : Bairro Teste,
    cidade : Cidade Teste,
    estado : SP,
    pais : BR
  },
  telefone : [
  {
    tipoTelefone : 1,
    ddi : 55,
    ddd : 12,
    telefone : 1234-5678
  }
  ]
   },
   dadosEntrega : {
    nome : Teste Yapay,
    email : teste@teste.com,
    endereco : {
    logradouro : Rua teste,
    numero : 123,
    complemento : "",
    cep : 12345-678,
    bairro : Bairro Teste,
    cidade : Cidade Teste,
    estado : SP,
    pais : BR
  },
  telefone : [
  {
    tipoTelefone : 1,
    ddi : 55,
    ddd : 12,
    telefone : 1234-5678
  }
  ]
   }
}


--header "Content-Type: application/json"
{
   "numeroTransacao": 1,
   "codigoEstabelecimento": "1000000000000",
   "codigoFormaPagamento": 30,
   "valor": 2000,
   "valorDesconto": 0,
   "parcelas": 1,
   "statusTransacao": 8,
   "autorizacao": ,
   "codigoTransacaoOperadora": "0",
   "dataAprovacaoOperadora": ,
   "numeroComprovanteVenda": ,
   "nsu": ,
   "mensagemVenda": ,
   "urlPagamento": "https://gateway.yapay.com.br/GeradorBoleto.do?cod=1413487983447baddcb56-0126-4353-9253-538f64d"
}

SafetyPay

Com este meio de pagamento é possível trabalhar com transferências entre vários bancos sem possuir contrato com cada um deles.

Contratação

Contratando a solução da SafetyPay para e-commerce será possível oferecer na sua loja:

Transferência entre bancos; Ao final do processo de contratação, deve-se estar de posse das seguintes informações para ativação dos boletos no Gateway:

  • API Key;
  • Signature Key;
  • Usuário;
  • Senha.

O Yapay não participa das negociações entre o estabelecimento e bancos/adquirentes. Desta forma, taxas ou eventuais isenções são tratadas de forma direta entre os envolvidos.

Para contratar, acesse aqui.

Particulariedades

  • Modalidade com redirecionamento;
  • A URL retornada no campo <urlPagamento> em SOAP e <url_acesso> em REST deverá ser repassada ao comprador para visualização/pagamento do boleto;
  • Enviar todos campos referente aos dados do comprador.

Configuração ambiente SafetyPay

Configurar em seu painel safetyPay a URL de notificação do Gateway + seu código de estabelecimento Yapay:

Ambiente URL
HOMOLOGAÇÃO https://gateway.sandbox.yapay.com.br/checkout/SafetyPay/Notificacao?codigoEstabelecimento={CODIGOYAPAY}
PRODUÇÃO https://gateway.yapay.com.br/checkout/SafetyPay/Notificacao?codigoEstabelecimento={CODIGOYAPAY}

Exemplo URL notificação: https://gateway.yapay.com.br/checkout/SafetyPay/Notificacao?codigoEstabelecimento=1000000000000

Exemplos

REQUISIÇÃO

Estrutura de envio SafetyPay.

RESPOSTA

Estrtura de retorno SafetyPay:

curl
--request POST https://gateway.yapay.com.br/checkout/api/v2/transacao
--header "Content-Type: application/json"
--header "usuario:{"login":"yapay","senha":"yapay"}"
--data-binary
{
   codigoEstabelecimento: 1000000000000,
   codigoFormaPagamento: 155,
   transacao: {
    numeroTransacao: 1,
    valor: 2000,
    valorDesconto: 0,
    parcelas : 1,
    urlCampainha : http://seusite.com.br/campainha,
    urlResultado : http://seusite.com.br/retorno,
    ip : "192.168.12.110",
    idioma : 1
   },
   itensDoPedido: [
  {
    codigoProduto: 1,
    nomeProduto: Blusa,
    codigoCategoria: 1,
    nomeCategoria : Roupa,
    quantidadeProduto : 1,
    valorUnitarioProduto : 2000
  }
   ],
   dadosCobranca : {
    codigoCliente : 1,
    tipoCliente : 1,
    nome : Teste Yapay,
    email : teste@teste.com,
    dataNascimento : "",
    sexo : "M",
    documento : "12312321312",
    endereco : {
    logradouro : Rua Teste,
    numero : 123,
    complemento : "",
    cep : 12345-678,
    bairro : Bairro Teste,
    cidade : Cidade Teste,
    estado : SP,
    pais : BR
  },
  telefone : [
  {
    tipoTelefone : 1,
    ddi : 55,
    ddd : 12,
    telefone : 1234-5678
  }
  ]
   },
   dadosEntrega : {
    nome : Teste Yapay,
    email : teste@teste.com,
    endereco : {
    logradouro : Rua teste,
    numero : 123,
    complemento : "",
    cep : 12345-678,
    bairro : Bairro Teste,
    cidade : Cidade Teste,
    estado : SP,
    pais : BR
  },
  telefone : [
  {
    tipoTelefone : 1,
    ddi : 55,
    ddd : 12,
    telefone : 1234-5678
  }
  ]
   }
}


--header "Content-Type: application/json"
{
   "numeroTransacao": 1,
   "codigoEstabelecimento": "1000000000000",
   "codigoFormaPagamento": 155,
   "valor": 2000,
   "valorDesconto": 0,
   "parcelas": 1,
   "statusTransacao": 8,
   "autorizacao": ,
   "codigoTransacaoOperadora": "0",
   "dataAprovacaoOperadora": ,
   "numeroComprovanteVenda": ,
   "nsu": ,
   "mensagemVenda": ,
   "urlPagamento": "https://gateway.yapay.com.br/checkout/PagamentoSafetyPay/PagamentoSafetyPay.do?cod=141348960683a720e602-5631-4725-8f79-268c06795a3c"
}

Intermediário Financeiro

Contratação

Abaixo segue lista de intermediário financeiro disponíveis através do Yapay:

  • PagSeguro;
  • PayPal.

Ao final do processo de contratação, deve-se estar de posse das seguintes informações para ativação no Gateway:

PagSeguro

  • email
  • token

Contração acesse aqui.

PayPal

  • assinatura
  • email
  • usuário
  • senha

Contração acesse aqui.

O Yapay não participa das negociações entre o estabelecimento e bancos/administradoras. Desta forma, taxas ou eventuais isenções são tratadas de forma direta entre os envolvidos.

Particulariedades

  • Modalidade com redirecionamento;
  • A URL retornada no campo <urlPagamento> em SOAP e <url_acesso> em REST deverá ser repassada ao comprador para abertura do intermediador;
  • Enviar todos campos referente aos dados do comprador.

Configuração ambiente PagSeguro

Configurar em seu painel PagSeguro a URL de notificação do Gateway:

Ambiente URL
HOMOLOGAÇÃO https://gateway.sandbox.yapay.com.br/checkout/PagamentoPagSeguro/RetornoPagSeguro.do
PRODUÇÃO https://gateway.yapay.com.br/checkout/PagamentoPagSeguro/RetornoPagSeguro.do

Exemplos

REQUISIÇÃO

Estrutura de envio PayPal.

RESPOSTA

Estrtura de retorno PayPal:

curl
--request POST https://homologacao.yapay.com.br/checkout/api/v2/transacao
--header "Content-Type: application/json"
--header "usuario:{"login":"yapay","senha":"yapay"}"
--data-binary
{
   codigoEstabelecimento: 1000000000000,
   codigoFormaPagamento: 39,
   transacao: {
    numeroTransacao: 1,
    valor: 2000,
    valorDesconto: 0,
    parcelas : 1,
    urlCampainha : http://seusite.com.br/campainha,
    urlResultado : http://seusite.com.br/retorno,
    ip : "192.168.12.110",
    idioma : 1
   },
   itensDoPedido: [
  {
    codigoProduto: 1,
    nomeProduto: Blusa,
    codigoCategoria: 1,
    nomeCategoria : Roupa,
    quantidadeProduto : 1,
    valorUnitarioProduto : 2000
  }
   ],
   dadosCobranca : {
    codigoCliente : 1,
    tipoCliente : 1,
    nome : Teste Yapay,
    email : teste@teste.com,
    dataNascimento : "",
    sexo : "M",
    documento : "12312321312",
    endereco : {
    logradouro : Rua Teste,
    numero : 123,
    complemento : "",
    cep : 12345-678,
    bairro : Bairro Teste,
    cidade : Cidade Teste,
    estado : SP,
    pais : BR
  },
  telefone : [
  {
    tipoTelefone : 1,
    ddi : 55,
    ddd : 12,
    telefone : 1234-5678
  }
  ]
   },
   dadosEntrega : {
    nome : Teste Yapay,
    email : teste@teste.com,
    endereco : {
    logradouro : Rua teste,
    numero : 123,
    complemento : "",
    cep : 12345-678,
    bairro : Bairro Teste,
    cidade : Cidade Teste,
    estado : SP,
    pais : BR
  },
  telefone : [
  {
    tipoTelefone : 1,
    ddi : 55,
    ddd : 12,
    telefone : 1234-5678
  }
  ]
   }
}


--header "Content-Type: application/json"
{
   "numeroTransacao": 1,
   "codigoEstabelecimento": "1000000000000",
   "codigoFormaPagamento": 39,
   "valor": 2000,
   "valorDesconto": 0,
   "parcelas": 1,
   "statusTransacao": 8,
   "autorizacao": ,
   "codigoTransacaoOperadora": "0",
   "dataAprovacaoOperadora": ,
   "numeroComprovanteVenda": ,
   "nsu": ,
   "mensagemVenda": ,
   "urlPagamento": "https://gateway.yapay.com.br/checkout/PagamentoPagSeguro/PagamentoPagSeguro.do?cod=1413489786995834a2f60-aa50-4615-92bd-45c46a7397a5"
}