Santander: mudanças entre as edições

De Wiki Doth
Ir para navegação Ir para pesquisar
Linha 38: Linha 38:
# Cadastrar chave pix aleatório
# Cadastrar chave pix aleatório


= MTLs =


O certificado MTLS do retorno do pix é diferente dos demais certificados
= Webhook =
 
# Retorno do santander
# Necessário ter certificados MTLs
# O certificado MTLS do retorno do pix é diferente dos demais certificados
# Certificado do pix baixa no portal do santander
# Certificado da cobrança disponível na documentação
 
<code>
{
"message": "WBHKPAGEST",
"function": "PAGAMENTO",
"paymentType": "PIX",
"issueDate": "2023-07-14",
"paymentDate": "2023-07-14-10.46.52.015034",
"bankCode": "0033",
"paymentChannel": "INTERNET BANKING",
"paymentKind": "DEBITO EM CONTA",
"covenant": "001234567",
"typeOfPersonAgreement": "CNPJ",
"agreementDocument": "00111222000105",
"bankNumber": "0000000000018",
"clientNumber": "EXEMPLO WEBHOOK",
"participantCode": "",
"txId": "YKP001234567000000000001814072023",
"payerDocumentType": "CPF",
"payerDocumentNumber": "00000015860",
"payerName": "JOAO DA SILVA",
"finalBeneficiaryrDocumentType": "",
"finalBeneficiaryDocumentNumber": "",
"finalBeneficiaryName": "",
"dueDate": "2023-08-14",
"nominalValue": 0.01,
"payedValue": 0.01,
"interestValue": 0.0,
"fine": 0.0,
"deductionValue": 0.0,
"rebateValue": 0.0,
"iofValue": 0.0
}
</code>

Edição das 21h00min de 3 de abril de 2025

Integração com o santander

Liberação de acesso

  1. acesso através de portal developers com o usuário master
  2. Membros: convidar membro murilo.pz@gmail.com
  3. É necessário ter certificado digital a1

Certificado

Obs. 2: O certificado não pode ter uma expiração inferior a 30 dias.

Ao receberem o Certificado Digital da certificadora (arquivo .pfx – parte privada), devem seguir com a instalação desse certificado. Ao realizar a instalação, marcar a chave como exportável (isso permitirá o backup do transporte das chaves posteriormente). Incluir todas as propriedades estendidas.

Após instalado o certificado, vão precisar exportar (criação da parte pública) para inserir no Portal do Desenvolvedor. Seguir os passos abaixo para exportar (sistema WINDOWS):

No menu de Pesquisa do Windows, digitar “Opções da Internet” e clicar no conteúdo encontrado;

Clicar na aba “Conteúdo”;

Clicar em “Certificados”;

Selecionar o Certificado que deseja exportar e clicar em “Exportar”;

Marque a opção “Não, não exportar a chave privada”;

Marque a opção “X.509 codificado na base 64(*.cer)”;

Salvar o certificado em alguma pasta.

Access Token

O access token para pix é diferente dos demais

Pix

  1. Cadastrar chave pix aleatório


Webhook

  1. Retorno do santander
  2. Necessário ter certificados MTLs
  3. O certificado MTLS do retorno do pix é diferente dos demais certificados
  4. Certificado do pix baixa no portal do santander
  5. Certificado da cobrança disponível na documentação

{ "message": "WBHKPAGEST", "function": "PAGAMENTO", "paymentType": "PIX", "issueDate": "2023-07-14", "paymentDate": "2023-07-14-10.46.52.015034", "bankCode": "0033", "paymentChannel": "INTERNET BANKING", "paymentKind": "DEBITO EM CONTA", "covenant": "001234567", "typeOfPersonAgreement": "CNPJ", "agreementDocument": "00111222000105", "bankNumber": "0000000000018", "clientNumber": "EXEMPLO WEBHOOK", "participantCode": "", "txId": "YKP001234567000000000001814072023", "payerDocumentType": "CPF", "payerDocumentNumber": "00000015860", "payerName": "JOAO DA SILVA", "finalBeneficiaryrDocumentType": "", "finalBeneficiaryDocumentNumber": "", "finalBeneficiaryName": "", "dueDate": "2023-08-14", "nominalValue": 0.01, "payedValue": 0.01, "interestValue": 0.0, "fine": 0.0, "deductionValue": 0.0, "rebateValue": 0.0, "iofValue": 0.0 }