Descrição
Para esta solução é necessário utilizar a rotina ConfiguraIntSiTefInterativoEx, pois será utilizado o parâmetro adicional que não existe na rotina ConfiguraIntSiTefInterativo
long ConfiguraIntSiTefInterativoEx (IPSiTef, IdLoja, IdTerminal, Reservado, ParametrosAdicionais)
Sendo que no último parâmetro ( ParametrosAdicionais ) deve ser enviada a seguinte informação:
[DadosSubAdquirencia=<DadosSubAdquirencia>]
onde
<DadosSubAdquirencia>=<Id1><Tam1><Val1><Id2><Tam2><Val2>...<IdN><TamN><ValN>
<id>- identificador do campo com 2 bytes , confor me valores definidos na tabela abaixo<tam>- tamanho do campo com 2 bytes .<val>- valor do campo.
| Tag | Formato | Tamanho Máximo | Campo |
|---|---|---|---|
| 00 | Alfanumérico | 22 | Nome fantasia (Merchant Name) |
| 01 | Alfanumérico | 48 | Endereço |
| 02 | Alfanumérico | 13 | Cidade |
| 03 | Alfanumérico | 2 | UF |
| 04 | Alfanumérico | 3 | País |
| 05 | Alfanumérico | 10 | CEP |
| 06 | Numérico | 4 | MCC (Merchant Category Code) |
| 07 | Numérico | 14 | CNPJ/CPF |
| 08 | Numérico | 11 | Telefone |
| 09 | Alfanumérico | 22 | Id (Código de Identificação do Estabelecimento) |
| 10 | Alfanumérico | 99 | |
| 11 | Alfanumérico | 60 | Razão Social/Nome Completo |
| 12 | Alfanumérico | 1 | Tipo de Pessoa (F ou J) |
| 13 | Alfanumérico | 15 | Facilitator Merchant ID OBSERVAÇÃO: - Este campo não se refere ao dado “Payment Facilitator ID”. Se tratam de dados distintos. - No momento, o campo “Facilitator Merchant ID“ é de uso exclusivo da rede PagSeguro. |
Abaixo são apresentados 3 possíveis modelos de formatação para o campo Nome Fantasia (tag 00) e descrita a forma de sua composição, visando padronizar esta informação:
SSS*NNNNNNNNNNNNNNNNNN
ou SSSSSSSNNNNNNNNNNNNNN ou SSSSSSSSSSSSNNNNNNNNN
Onde:
S = Identificação da sub-adquirente, devendo ter tamanho 3, 7 ou 12 e, necessariamente, deve ser complementado com brancos caso necessário (baseado em um dos 3 modelos possíveis).
* = Separador obrigatório em caso de sub-adquirente
N = Nome que identificará o estabelecimento na fatura do cliente portador do cartão. Sendo de extrema importância que esta informação permita identificar de forma clara o estabelecimento na fatura do cliente, evitando desta forma possível fallback da transação.
Lembrando que a definição do tamanho total do campo é de 22 posições, resultando nas possíveis formatações a seguir: 318 ou 714 ou 12*9 (conforme os modelos apresentados anteriormente).
Este padrão, a ser seguido pela aplicação, se faz necessário devido aos diferentes tratamentos desta informação por parte dos autorizadores.
Exemplo:
[DadosSubAdquirencia=0022STL*SOFTWARE EXPRESS 0122AVENIDA PAULISTA, 22020209SAO PAULO0302SP]
No exemplo acima foram passados os seguintes campos(conforme padrão “IDTAMVAL”):
- 00 (Nome fantasia) com tamanho 22 (padrão 318) e valor igual a: “STL” (identificação sub-adquirente), (separador) e “SOFTWARE EXPRESS “ (Nome Fantasia, com dois brancos para complemento de tamanho);
- 01 (Endereço) com tamanho 22 e valor igual a AVENIDA PAULISTA, 2202;
- 02 (Cidade) com tamanho 09 e valor igual a SAO PAULO;
- 03 (UF) com tamanho 02 e valor igual a SP.
Vale ressaltar que caso algum dos campos definidos não seja passado pela automação comercial, ele será enviado com brancos para o autorizador. A lista de quais campos devem ser enviados pode variar de adquirente para adquirente.