Clearsale – Tickets

Solução antifraude desenvolvida para vendas de ingressos online para qualquer tipo de evento.

Clearsale – URL de envio dos dados

SANDBOX: https://testapi.maxipago.net/UniversalAPI/postXML

PRODUÇÃO: https://api.maxipago.net/UniversalAPI/postXML

Cenários de Teste

Clearsale – Device Fingerprint

O Device Fingerprint é um scprit em JavaScript que realiza coleta de dados e análise de informações públicas da máquina do usuário. Através desse recurso é possível identificar se uma máquina já é conhecida pela Clearsale e qual seu histórico de ações.

• É necessário que o script esteja em somente uma única página do website.
• É obrigatório a inclusão das tags do script ao final da página html, antes do fechamento da tag body. Pois o cumprimento desta recomendação garante que o website não sofra nenhum prejuízo de performance na integração.

O código que deverá ser incluído na página, antes da tag body, está abaixo:

<script>
    (function (a, b, c, d, e, f, g){
            a['CsdpObject'] = e; a[e] = a[e] || function () {
                    (a[e].q = a[e].q || []).push(arguments)
               },
               a[e].l = 1 * new Date(); f = b.createElement(c),
               g = b.getElementsByTagName(c)[0]; f.async = 1; f.src = d;
               g.parentNode.insertBefore(f, g)
    })
    (window, document, 'script', '//device.clearsale.com.br/p/fp.js','csdp');
    csdp('app', 'seu_app');
    csdp('sessionid', 'seu_id_de_sessao');
</script>

A Clearsale deverá informar qual valor deve ser utilizado na palavra sinalizada na variável “seu-app”. Ele serve para identificar o seu website em nosso sistema.

Já o valor a ser informador na variável “seu-id-de-sessao”, trata-se do id da sessão do usuário no website. Esta informação é extremamente relevante e deverá ser armazenada para um envio posterior.

Importante:

É preciso considerar que os parâmetros: <captureOnLowRisk> e <voidOnHighRisk> devem estar com a opção “Y“; somente com a opção flag “Y” as capturas e estornos serão feito de maneira automática. Caso estejam com a opção “N”, capturas e estornos somente serão realizamos por ação manual do lojista.

Exemplo de Requisição

<?xml version="1.0" encoding="UTF-8"?>
<transaction-request>
	<version>3.1.1.15</version>
	<verification>
		<merchantId>XXXXXXXXX</merchantId>
		<merchantKey>XXXXXX</merchantKey>
	</verification>
	<order>
		<auth>
			<processorID>1</processorID>
			<referenceNum>maxiteste01</referenceNum>
			<fraudCheck>Y</fraudCheck>
			<ipAddress>123.123.123.123</ipAddress>
			<billing>
				<id>17139871558</id>
				<name>Teste da Silva</name>
				<address>Av. Centro 230</address>
				<address2>16 Andar</address2>
				<district>Centro</district>
				<city>Sao Paulo</city>
				<state>SP</state>
				<postalcode>08021310</postalcode>
				<country>BR</country>
				<email>maxiteste@maxiteste.com</email>
				<type>Individual</type>
				<gender>F</gender>
				<birthDate>1982-03-08</birthDate>
				<phones>
					<phone>
						<phoneType>Commercial</phoneType>
						<phoneCountryCode>55</phoneCountryCode>
						<phoneAreaCode>11</phoneAreaCode>
						<phoneNumber>55554444</phoneNumber>
						<phoneExtension>ramal 12</phoneExtension>
					</phone>
					<phone>
						<phoneType>Residential</phoneType>
						<phoneCountryCode>55</phoneCountryCode>
						<phoneAreaCode>11</phoneAreaCode>
						<phoneNumber>55554444</phoneNumber>
						<phoneExtension>ramal 34</phoneExtension>
					</phone>
				</phones>
				<documents>
					<document>
						<documentType>CPF</documentType>
						<documentValue>17139871558</documentValue>
					</document>
					<document>
						<documentType>RG</documentType>
						<documentValue>12546785-2Y</documentValue>
					</document>
				</documents>
			</billing>
			<shipping>
				<id>17139871558</id>
				<name>Teste da Silva</name>
				<address>Rua Sem Fim, 123</address>
				<address2>16 Andar</address2>
				<district>Centro</district>
				<city>Cabo Frio</city>
				<state>RJ</state>
				<postalcode>25555781</postalcode>
				<country>BR</country>
				<type>Individual</type>
				<gender>F</gender>
				<birthDate>1982-03-08</birthDate>
				<phones>
					<phone>
						<phoneType>Commercial</phoneType>
						<phoneCountryCode>55</phoneCountryCode>
						<phoneAreaCode>11</phoneAreaCode>
						<phoneNumber>55554444</phoneNumber>
						<phoneExtension>ramal12</phoneExtension>
					</phone>
					<phone>
						<phoneType>Residential</phoneType>
						<phoneCountryCode>55</phoneCountryCode>
						<phoneAreaCode>11</phoneAreaCode>
						<phoneNumber>55554444</phoneNumber>
						<phoneExtension>ramal12</phoneExtension>
					</phone>
				</phones>
				<documents>
					<document>
						<documentType>CPF</documentType>
						<documentValue>17139871558</documentValue>
					</document>
					<document>
						<documentType>RG</documentType>
						<documentValue>123456789-60Z</documentValue>
					</document>
				</documents>
			</shipping>
			<fraudDetails>
				<fraudProcessorID>100</fraudProcessorID>
				<captureOnLowRisk>Y</captureOnLowRisk>
				<voidOnHighRisk>Y</voidOnHighRisk>
				<fraudToken>135f1eb0-30c9-64c7-45ed-05f271a760c5</fraudToken>
				<websiteId>MXP_DEV</websiteId>
				<tickets>
					<ticket_event>
						<convenienceFee>0.00</convenienceFee>
						<quantityFull>1</quantityFull>
						<quantityHalf>0</quantityHalf>
						<event>
							<id>ROCK15</id>
							<name>Rock in Rio 2015</name>
							<local>Rio de Janeiro</local>
							<date>2023-12-30 21:50:00</date>
							<quantityTicketSale>1</quantityTicketSale>
							<quantityEventHouse>1</quantityEventHouse>
						</event>
						<people>
							<person>
								<name>John Rock One</name>
								<documentType>CPF</documentType>
								<documentValue>17139871558</documentValue>
							</person>
						</people>
						<categories>
							<category>
								<name>BASIC</name>
								<quantity>1</quantity>
								<unitAmount>2.00</unitAmount>
							</category>
						</categories>
					</ticket_event>
				</tickets>
			</fraudDetails>
			<transactionDetail>
				<payType>
					<creditCard>
						<number>5390792465493442</number>
						<expMonth>12</expMonth>
						<expYear>2030</expYear>
						<cvvNumber>222</cvvNumber>
					</creditCard>
				</payType>
			</transactionDetail>
			<payment>
				<chargeTotal>2.00</chargeTotal>
			</payment>
		</auth>
	</order>
</transaction-request> 

Exemplo de Requisição – Retorno de Transação Aprovada Automaticamente

<?xml version="1.0" encoding="UTF-8"?>
<transaction-response>
	<authCode>123456</authCode>
	<orderID>0A0104A6:0185069D1845:D0D5:6149AE67</orderID>
	<referenceNum>maxiteste01</referenceNum>
	<transactionID>13959172</transactionID>
	<transactionTimestamp>1670853236</transactionTimestamp>
	<responseCode>0</responseCode>
	<responseMessage>CAPTURED</responseMessage>
	<avsResponseCode>YYY</avsResponseCode>
	<cvvResponseCode>M</cvvResponseCode>
	<processorCode>A</processorCode>
	<processorMessage>APPROVED</processorMessage>
	<processorName>SIMULATOR</processorName>
	<creditCardBin>539079</creditCardBin>
	<creditCardLast4>3442</creditCardLast4>
	<errorMessage/>
	<processorTransactionID>152701</processorTransactionID>
	<processorReferenceNumber>965723</processorReferenceNumber>
	<fraudScore>0.01999999999999602</fraudScore>
	<creditCardCountry>US</creditCardCountry>
	<creditCardScheme>Mastercard</creditCardScheme>
</transaction-response>

Exemplo de Requisição – Retorno de Transação Declinada Automaticamente

<?xml version="1.0" encoding="UTF-8"?>
<transaction-response>
	<authCode>123456</authCode>
	<orderID>0A0104A6:018506A13AD8:6DGG:47539CF8</orderID>
	<referenceNum>maxiteste01</referenceNum>
	<transactionID>13959232</transactionID>
	<transactionTimestamp>1670853507</transactionTimestamp>
	<responseCode>2</responseCode>
	<responseMessage>VOIDED</responseMessage>
	<avsResponseCode>YYY</avsResponseCode>
	<cvvResponseCode>M</cvvResponseCode>
	<processorCode>A</processorCode>
	<processorMessage>RPA</processorMessage>
	<processorName>SIMULATOR</processorName>
	<creditCardBin>539079</creditCardBin>
	<creditCardLast4>3442</creditCardLast4>
	<errorMessage/>
	<processorTransactionID>13959233</processorTransactionID>
	<processorReferenceNumber>bc4ca759-8061-4ee5-9795-5ea8229c4910</processorReferenceNumber>
	<fraudScore>0.01999999999999602</fraudScore>
	<creditCardCountry>US</creditCardCountry>
	<creditCardScheme>Mastercard</creditCardScheme>
</transaction-response>

Exemplo de Requisição – Retorno de Transação em Review

<?xml version="1.0" encoding="UTF-8"?>
<transaction-response>
	<authCode>123456</authCode>
	<orderID>0A0104A6:0184E9C1F0D7:679D:6BCE2F54</orderID>
	<referenceNum>maxiteste01</referenceNum>
	<transactionID>13956389</transactionID>
	<transactionTimestamp>1670369112</transactionTimestamp>
	<responseCode>0</responseCode>
	<responseMessage>REVIEW</responseMessage>
	<avsResponseCode>YYY</avsResponseCode>
	<cvvResponseCode>M</cvvResponseCode>
	<processorCode>A</processorCode>
	<processorMessage>APPROVED</processorMessage>
	<processorName>SIMULATOR</processorName>
	<creditCardBin>539079</creditCardBin>
	<creditCardLast4>3442</creditCardLast4>
	<errorMessage/>
	<processorTransactionID>13956390</processorTransactionID>
	<processorReferenceNumber>e44d5f74-0fa0-47ee-9d3c-e8b052cd5fb4</processorReferenceNumber>
	<fraudScore>0.37999999999999545</fraudScore>
	<creditCardCountry>US</creditCardCountry>
	<creditCardScheme>Mastercard</creditCardScheme>
	<brandCode>714444</brandCode>
	<brandMessage>BRAND MESSAGE</brandMessage>
	<brandTransactionID>227816</brandTransactionID>
</transaction-response>

Tabela de Parâmetros

Tabela de Respostas