Para poder efetuar pagamentos via Rede Pay, o lojista deverá informar a maxiPago! a sua chave de autenticação na API da Rede Pay e um URL de callback (URL para a qual a maxiPago! enviará as alterações de status das transações).
Rede Pay – URLs Para Envio dos Dados
SANDBOX: https://testapi.maxipago.net/UniversalAPI/postXML
PRODUÇÃO: https://api.maxipago.net/UniversalAPI/postXML
Rede Pay – Exemplo de Requisição
<?xml version="1.0" encoding="UTF-8"?> <transaction-request> <version>3.1.1.15</version> <verification> <merchantId>store-id</merchantId> <merchantKey>store-key</merchantKey> </verification> <order> <sale> <processorID>18</processorID> <referenceNum>2013093001</referenceNum> <billing> <name>Billing name</name> <address>Rua billing street, 230</address> <address2>16 Andar</address2> <district>Braz de Pina</district> <city>Rio de Janeiro</city> <state>RJ</state> <postalcode>12345678</postalcode> <country>BR</country> <phone>2142419440</phone> <email>fulanodetal@email.com</email> <id>2546582</id> <type>Individual</type> <gender>M</gender> <birthDate>1982-03-08</birthDate> <phones> <phone> <phoneType>Mobile</phoneType> <phoneCountryCode>55</phoneCountryCode> <phoneAreaCode>11</phoneAreaCode> <phoneNumber>987654321</phoneNumber> </phone> <phone> <phoneType>Residential</phoneType> <phoneCountryCode>55</phoneCountryCode> <phoneAreaCode>11</phoneAreaCode> <phoneNumber>55554444</phoneNumber> <phoneExtension>B101</phoneExtension> </phone> </phones> <documents> <document> <documentType>CPF</documentType> <documentValue>025336839-14</documentValue> </document> <document> <documentType>RG</documentType> <documentValue>12546785-2Y</documentValue> </document> </documents> </billing> <shipping> <name>Fulano de Tal</name> <address>Rua de Teste, 123</address> <city>São Paulo</city> <state>SP</state> <postalcode>12345000</postalcode> <country>BR</country> </shipping> <transactionDetail> <payType> <eWallet> <parametersURL>type=redepay</parametersURL> </eWallet> </payType> </transactionDetail> <payment> <chargeTotal>1.01</chargeTotal> <shippingTotal>0.01</shippingTotal> </payment> <itemList itemCount="1"> <item> <itemIndex>1</itemIndex> <itemProductCode>Produto de Teste Um</itemProductCode> <itemDescription>Certificação de Integração PayPal</itemDescription> <itemQuantity>2</itemQuantity> <itemTotalAmount>1.00</itemTotalAmount> <itemUnitCost>0.50</itemUnitCost> </item> </itemList> </sale> </order> </transaction-request>
Rede Pay – Exemplo de Retorno em Caso de Sucesso
<?xml version="1.0" encoding="UTF-8"?> <transaction-response> <authCode/> <orderID/> <referenceNum/> <transactionID>196122833</transactionID> <transactionTimestamp>1502810665</transactionTimestamp> <responseCode>0</responseCode> <responseMessage>PENDING AUTHORIZE</responseMessage> <avsResponseCode/> <cvvResponseCode/> <processorCode/> <processorMessage/> <errorMessage/> <processorReferenceNumber>6491e31f-4907-47fd-8b4d-19df702a0a3f</processorReferenceNumber> <authenticationURL>https://authentication.maxipago.net/redirection_service/redepay?ref=k0LraTzJ0RMvT185vtEIioSeTVcbe2AABVKayk%2FWPVGHzxT8WaJGrAwZQfAHcGBBtI6pZQLnCAvt%0AA6lPUKpPIu8EiIWx8s7XYS9gmQhoPoLEFLXVs6FvMYS%2BKJu7rddwO1Anj7vx35r6dKFMWPayvc6w%0ArzE9SpFmlJEifqSrJtw5U7t8Wskmdw%3D%3D</authenticationURL> </transaction-response>
Rede Pay – Exemplo de Retorno em de Erro
<?xml version="1.0" encoding="UTF-8"?> <transaction-response> <authCode/> <orderID/> <referenceNum/> <transactionID/> <transactionTimestamp>1502811251375
Rede Pay – Tabela de parâmetros
Nome |
Obrigatório |
Tamanho |
Descrição |
version |
Sim |
11 |
Versão da API |
merchantId |
Sim |
20 |
Id de Loja que identifica o estabelecimento |
merchantKey |
Sim |
80 |
Chave associada ao ID da loja |
referenceNum |
Sim |
128 |
Identificador do pedido no estabelecimento Este campo aceita apenas valores alfanuméricos e deve ser único. |
processorID |
Sim |
2 |
Código da Adquirente que irá processar a transação
Rede Pay = 18 |
billing/id shipping/id |
Sim |
50 |
ID do consumidor na base do lojista |
billing/name shipping/name |
Sim |
64 |
Nome do cliente (somente alfabético) |
billing/address shipping/address |
Sim |
128 |
Logradouro de cobrança da transação (sem acentos e caracteres especiais) |
billing/address2 shipping/address2 |
Não |
128 |
Complemento do Logradouro de cobrança da transação (sem acentos e caracteres especiais) |
billing/district shipping/district |
Sim |
64 |
Bairro (sem acentos e caracteres especiais) |
billing/city shipping/city |
Sim |
64 |
Cidade (sem acentos e caracteres especiais) |
billing/state shipping/state |
Sim |
32 |
Estado (enviado com 2 dígitos) |
billing/postalcode shipping/postalcode |
Sim |
16 |
CEP de Cobrança |
billing/country shipping/country |
Sim |
64 |
País (Abreviação de 2 dígitos) |
billing/email shipping/email |
Sim |
128 |
Utilização obrigatória de “@” |
billing/phone shipping/phone |
Sim |
16 |
Telefone |
billing/type shipping/type |
Sim |
50 |
Use “Individual” para CPF e “Legal entity” para CNPJ |
billing/gender shipping/gender |
Sim |
1 |
Sexo (“M” ou “F) |
billing/birthDate shipping/birthDate |
Sim |
12 |
Data de nascimento (AAAA-MM-DD) |
phone/phoneType |
Sim |
50 |
Utilize um dos dados abaixo:
– Residential – Commercial – Mobile – Fax – Undefined – Message – Billing |
document/documentType |
Sim |
50 |
Tipo de Documento. Utilize a lista abaixo:
CPF RG CNPJ StateRegistration (não aplicado ao BR) MunicipalRegistration (não aplicado ao BR) Passport CTPS (Carteira de Trabalho – número PIS) VoterDocument (Título de Eleitor) |
document/documentValue |
Sim |
50 |
Número do documento |
chargeTotal |
Sim |
14.2 |
Valor do pedido Os decimais devem ser separados por ponto (“.”) |
shippingTotal |
Não |
14.2 |
Valor do frete que será cobrado. Os decimais devem ser separados por ponto (“.”) |
parametersURL |
Sim |
– – – – |
Parâmetro que será enviado em GET para a URL de Sucesso ou URL de Falha ao redirecionar o comprador de volta para o lojista. Por favor, deixe o campo vazio (não nulo) se não for usado. Exemplo: purchaseCode=123456&id=a1b2c3 (HTML encoded) |
itemIndex |
Sim |
1 |
Itens: Enumerador do item de 1 a n |
itemProductCode |
Não |
50 |
Itens: Categoria do produto; Alfanumérico Ex: Acessórios de cozinha |
itemDescription |
Sim |
100 |
Itens: Descrição do Item; Alfanumérico Ex: Facas Ginsu |
itemQuantity |
Sim |
10 |
Itens: Quantidade deste item |
itemTotalAmount |
Sim |
14.2 |
Valor do Item. Os decimais devem ser separados por ponto (“.”) |
itemUnitCost |
Sim |
14.2 |
Valor do Item. Os decimais devem ser separados por ponto (“.”) |