• Nenhum resultado encontrado

Recorrência. Decisão em caso de Falha

N/A
N/A
Protected

Academic year: 2021

Share "Recorrência. Decisão em caso de Falha"

Copied!
7
0
0

Texto

(1)

Recorrência

Decisão em caso de Falha

(2)

Request que possibilita ação em caso de falha na cobrança:

Abaixo modelo de request para criação de ordem de pagamento com parâmetro que

pertime decisão em caso de falha da cobrança:

<transaction-request> <version>3.1.1.15</version> <verification> <merchantId>store-id</merchantId> <merchantKey>store-key</merchantKey> </verification> <order> <recurringPayment> <processorID>1</processorID> <referenceNum>TestTransaction123</referenceNum> <customerIdExt>123.123.123-12</customerIdExt> <billing> <name>Fulano de Tal</name>

<address>Av. Republica Livre, 230</address> <district>Centro</district> <city>Sao Paulo</city> <state>SP</state> <postalcode>08021310</postalcode> <country>BR</country> <phone>1132890900</phone> <email>billing@maxipago.com</email> </billing> <shipping> <name>Fulano de Tal</name>

<address>Av. Republica Livre, 230</address> <district>Centro</district> <city>Sao Paulo</city> <state>SP</state> <postalcode>08021310</postalcode> <country>BR</country> <phone>1132890900</phone> <email>shipping@maxipago.com</email> </shipping> <transactionDetail> <payType> <creditCard> <number>5537837159928759</number> <expMonth>07</expMonth> <expYear>2021</expYear> <cvvNumber>268</cvvNumber> </creditCard> </payType> </transactionDetail> <payment> <chargeTotal>10.00</chargeTotal> <currencyCode>BRL</currencyCode> </payment> <recurring> <action>new</action> <startDate>2020-10-05</startDate> <period>monthly</period> <frequency>1</frequency> <installments>12</installments> <firstAmount>22.00</firstAmount> <lastAmount>22.00</lastAmount> <lastDate>2018-10-05</lastDate> <failureThreshold>15</failureThreshold> <onFailureAction>skip</ onFailureAction> </recurring> </recurringPayment> </order> </transaction-request>

(3)

Retorno da Requisição com Sucesso

Retorno da Requisição com Erro

<?xml version="1.0" encoding="UTF-8"?> <transaction-response> <authCode>123456</authCode> <orderID>0A0115A6:01773F2A789E:552C:475C1728</orderID> <referenceNum>max123</referenceNum> <transactionID>383975027</transactionID> <transactionTimestamp>1611672484</transactionTimestamp> <responseCode>0</responseCode> <responseMessage>CAPTURED</responseMessage> <avsResponseCode>YYY</avsResponseCode> <cvvResponseCode>M</cvvResponseCode> <processorCode>A</processorCode> <processorMessage>APPROVED</processorMessage> <processorName>SIMULATOR</processorName> <errorMessage/> <processorTransactionID>803664</processorTransactionID> <processorReferenceNumber>584432</processorReferenceNumber> <creditCardCountry>US</creditCardCountry> <creditCardScheme>Mastercard</creditCardScheme> </transaction-response>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <api-error>

<errorCode>1</errorCode> <errorMsg>

<![CDATA[Schema validation for the vertical SA for the incoming transaction xml failed. Reason Parser Error: URI=null Line=1: cvc-enumeration-valid: Value 'SKIP' is not facet-valid with respect to enumeration '[, cancel, skip, pause]'. It must be a value from the enumeration.]]>

</errorMsg> </api-error>

(4)

Nome

Obrigatório

Tama

nho

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

estabelecimentoEste campo

aceita apenas valores

alfanuméricos e deve ser

único.

processorID

Sim

2

Código da adquirente que irá

processar a transação:

Simulador de teste = 1 Rede =

2 GetNet = 3 Cielo = 4 e.REDE=

5 Elavon = 6 ChasePaymentech

= 8 Stone = 9

fraudCheck

Não

1

Flag para enviar transação para

verificação de fraude. Se

deixado em branco a transação

será verificada. Y ou vazio/nulo

= checar N = não checar Este

campo só funciona para

clientes que possuem o serviço

de antifraude contratado.

ipAddress

Não

16

CPF do comprador

customerIdExt

Sim

16

Endereço de IP do comprador

billing/name

shipping/name

Sim

64

Nome do cliente

billing/address

shipping/address

Sim

128

Logradouro de cobrança da

transação (sem acentos e

caracteres especiais).

(5)

billing/address2

shipping/address2

Não

128

Complemento do logradouro

de cobrança da transação (sem

acentos e caracteres especiais).

billing/distric

shipping/distric

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

(UF)).

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/country

shipping/country

Sim

64

País (abreviação de 2 dígitos).

billing/companyName

Sim

64

Biling: Nome da empresa

vendedora.

number

Sim

19

Número do cartão de crédito

do cliente

expMonth

Sim

2

Mês de vencimento do cartão

com 2 dígitos.

Exemplo: Janeiro = 01

expYear

Sim

4

Ano de vencimento do cartão

com 4 dígitos

(6)

Obs.: embora o campo não seja

obrigatório em nosso sistema

as adquirentes podem

bloquear transações caso este

campo esteja vazio.

Por favor, cheque suas

permissões na Adquirente.

chargeTotal

Sim

14.2

Valor do pedido. Os decimais

devem ser separados por

ponto (.)

currencyCode

Não

3

Código da moeda da transação

no formato ISO 4217.

action

Sim

10

new

startDate

Sim

12

Data de início da cobrança.

Formato AAAA-MM-DD

period

Sim

10

Intervalo de tempo entre

cobranças:

daily = dia(s)

weekly = semana(s)

monthly = mês(es)

bimonthly = bimestral

quarterly = trimestral

semiannual = semestral

annual = anual

frequency

Sim

2

Frequência de cobrança. Este

campo é combinado com a tag

para definir o intervalo.

Exemplo: Se “frequency” = 2 e

“period” = weekly, então

cobrar a cada 2 semanas.

Se deixado em branco será

entendido como “1”.

installments

Sim

4

Número de cobranças a serem

efetuadas.

Exemplo: Se “installments” = 5,

então serão feitas 5 cobranças

(7)

seguindo o intervalo definido

acima, a partir da data de

início.

firstAmount

Sim

14.2

Valor a ser cobrado na primeira

parcela da recorrência.

lastAmount

Sim

14.2

Valor a ser cobrado na última

parcela da recorrência.

lastDate

Sim

Date

Data da última cobrança

failureThreshold

Sim

2

Número de tentativas negadas

necessárias para ativar a

notificação por e-mail à loja e

cancelar a recorrência

onFailureAction

Não

São aceitos apenas os valores:

skip, cancel, pause.

Considerando:

- Skipe (pula a parcela)

- Cancel (cancela a recorrência

– ação DEFAULT)

Referências

Documentos relacionados

ITIL, biblioteca de infraestrutura de tecnologia da informação, é um framework que surgiu na década de mil novecentos e oitenta pela necessidade do governo

Tem como diretrizes, a integração com as políticas e diretrizes das Secretarias Municipais, das Subprefeituras e órgãos equiparados; o incentivo e apoio às

Este trabalho traz uma contribuição conceitual sobre a utilização do sistema de gestão de produtividade que poderá motivar futuras pesquisas sobre o tema, bem

Analisando a metodologia de produção de materiais da FIAP, é possível verificar que existem processos mais complexos se comparados à proposta de Kilpatrick (1918), pois as

Foram abordados aspectos da biologia de morcegos em duas cavernas no estado de São Paulo, em estado de preservação distintos: Gruta da Toca, mais preservada e Gruta do

Então eu acho também bacana, Evelyn, de você trazer essa rede colaborativa para esse nível de escola de você trocar com seus pares, que não é aquela coisa nas portas, ficar

Em seu íntimo, Catalina pensava em conseguir um emprego para ajudar nas despesas da casa. Percebia que a mãe precisava de ajuda. Também sonhava crescer logo, e

A Produção mais Limpa (P+L) permite melhorar internamente a sustentabilidade dos processos, a gestão de serviços é necessária para melhorar a compreensão