Inicio
Documentação
Recursos
Parcerias
Comunidade

Parcerias

Conheça nosso programa para agências ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratá-los.

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Recomendações para melhorar a aprovação de pagamentos - Como melhorar a aprovação dos pagamentos - Mercado Pago Developers
Qual documentação você quer buscar?

Não sabe como começar a integrar? 

Acesse os primeiros passos

Recomendações para melhorar sua aprovação

Para evitar que um pagamento legítimo seja recusado por não atender as validações de segurança, é necessário incluir o máximo de informações possíveis na hora de realizar a operação e também que seu checkout esteja com uma interface otimizada.

Você pode ver em detalhes nossas recomendações para melhorar sua aprovação abaixo.

Coleta e envío de Device ID

O Device ID é uma informação importante para garantir uma melhor segurança e, consequentemente, uma melhor taxa de aprovação de pagamentos. Ele representa um identificador único para cada dispositivo do comprador no momento da compra. Caso um comprador frequente faça uma compra a partir de um dispositivo diferente do habitual, isso pode representar um comportamento atípico. Embora possa não ser necessariamente fraude, o ID do dispositivo nos ajuda a refinar a avaliação e nos impede de rejeitar pagamentos legítimos.

Atenção
Caso já esteja utilizando o SDK JS do Mercado Pago , não será necessário adicionar o código de segurança, pois o Device ID será obtido por padrão.

Você pode adicionar o código de segurança do Mercado Pago na sua página substituindo o valor de view pelo nome da seção na qual deseja adicioná-lo. O mais importante é adicioná-lo na página do checkout, porém adicionar em outras páginas, como home, search ou item, também ajuda a enriquecer as informações coletadas.

html

<script src="https://www.mercadopago.com/v2/security.js" view="home"></script>
Importante
Caso não tenha um valor disponível para a seção, você pode deixá-la vazia.

Utilizar informações do Device ID na web

Para usar o Device ID na web e evitar possíveis compras fraudulentas, é preciso seguir os passos abaixo:

1. Adicione o script de segurança do Mercado Pago

Para implementar a geração do device ID em seu site, adicione o seguinte código na sua página de Checkout:

html

<script src="https://www.mercadopago.com/v2/security.js" view="checkout"></script>

2.Obtendo o Device ID

Uma vez que você tenha adicionado o código de segurança do Mercado Pago em seu site, uma variável global de javascript é criada automaticamente com o nome MP_DEVICE_SESSION_ID, cujo valor é o Device ID.

Se você preferir atribuí-lo a outra variável, indique o nome adicionando o atributo output ao script de segurança, como no exemplo a seguir:

html

  <script src="https://www.mercadopago.com/v2/security.js" view="checkout" output="deviceId"></script>

Você também pode criar sua própria variável. Para isso, adicione uma tag HTML no seu site com o identificador id="deviceID", como no exemplo abaixo.

html

  <input type="hidden" id="deviceId">

3. Utilizando o Device ID

Uma vez que você tenha o valor de Device ID, é preciso que você o envie aos nossos servidores ao criar um pagamento. Para isso, basta acrescentar o seguinte cabeçalho (header) à requisição:

http

X-meli-session-id: device_id
Atenção
Lembre-se de substituir device_id pelo nome da variável que contém o seu valor de Device ID.

Utilizar Device ID em aplicações móveis

Se você possui uma aplicação móvel nativa, pode capturar a informação do dispositivo com nosso SDK e enviar no momento de criar o token. Siga estas etapas:

1. Adicione a dependência

Adicionar o seguinte código no arquivo Podfile.

          
use_frameworks!
pod ‘MercadoPagoDevicesSDK’

        

Você precisa adicionar o repositório e a dependência no arquivo build.gradle.

          
repositories {
    maven {
        url "https://artifacts.mercadolibre.com/repository/android-releases"
    }
}
dependencies {
   implementation 'com.mercadolibre.android.device:sdk:3.0.5'
}

        

2. Inicialize o módulo

Recomendamos realizar a inicialização no envento didFinishLaunchingWithOptions do AppDelegate.

          
import MercadoPagoDevicesSDK
...
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        ...        
        MercadoPagoDevicesSDK.shared.execute()
        ...
}

        

Recomendamos realizar a inicialização no envento didFinishLaunchingWithOptions do AppDelegate.

          
@import ‘MercadoPagoDevicesSDK’;
...
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    ...
    [[MercadoPagoDevicesSDK shared] execute];
    ...
}

        

Recomendamos realizar a inicialização na classe MainApplication.

          
import com.mercadolibre.android.device.sdk.DeviceSDK;
DeviceSDK.getInstance().execute(this);

        

3. Capture a informação

Execute alguma das funções abaixo para obter a informação no formato que precisar.

          
MercadoPagoDevicesSDK.shared.getInfo() // Devolve um objeto Device que é Codificável
MercadoPagoDevicesSDK.shared.getInfoAsJson() // Devolve um objeto em JSON
MercadoPagoDevicesSDK.shared.getInfoAsJsonString() // Devolve o JSON em formato de String
MercadoPagoDevicesSDK.shared.getInfoAsDictionary() // Devolve um objeto Dictionary<String,Any>

        
          
[[[MercadoPagoDevicesSDK] shared] getInfoAsJson] // Devolve um objeto em JSON
[[[MercadoPagoDevicesSDK] shared] getInfoAsJsonString] // Devolve o JSON em formato de String
[[[MercadoPagoDevicesSDK] shared] getInfoAsDictionary] // Deolve um objeto Dictionary<String,Any>

        
          
Device device = DeviceSDK.getInstance().getInfo() // Devolve um objeto Device, que é serializável
Map deviceMap = DeviceSDK.getInstance().getInfoAsMap()  // Devolve um Map<String, Object>
String jsonString = DeviceSDK.getInstance().getInfoAsJsonString() // Devolve uma String no formato JSON

        

4. Envie a informação

Por último, envie a informação obtida no campo device ao criar o card_token.

plain

{
	...,
	 "device":{
	  "fingerprint":{
	     "os":"iOS",
	     "system_version":"8.3",
	     "ram":18446744071562067968,
	     "disk_space":498876809216,
	     "model":"MacBookPro9,2",
	     "free_disk_space":328918237184,
	     "vendor_ids":[
	        {
	           "name":"vendor_id",
	           "value":"C2508642-79CF-44E4-A205-284A4F4DE04C"
	        },
	        {
	           "name":"uuid",
	           "value":"AB28738B-8DC2-4EC2-B514-3ACF330482B6"
	        }
	     ],
	     "vendor_specific_attributes":{
	        "feature_flash":false,
	        "can_make_phone_calls":false,
	        "can_send_sms":false,
	        "video_camera_available":true,
	        "cpu_count":4,
	        "simulator":true,
	        "device_languaje":"en",
	        "device_idiom":"Phone",
	        "platform":"x86_64",
	        "device_name":"iPhone Simulator",
	        "device_family":4,
	        "retina_display_capable":true,
	        "feature_camera":false,
	        "device_model":"iPhone Simulator",
	        "feature_front_camera":false
	     },
	     "resolution":"375x667"
	  }
}

Detalhar todas as informações sobre o pagamento

Para otimizar a validação de segurança dos pagamentos e melhorar as aprovações, é importante fazer o envio do máximo de dados sobre o comprador e o produto.

Se atente a todos os atributos disponíveis ao criar um pagamento usando o método Criar pagamento. Preste atenção especialmente aos atributos em “adicional_inf”, como:

  • Dados do comprador,
  • Dados do produto,
  • Dados do envio.

Existem também campos extras que podem ser enviados de acordo com o ramo de atividade. Você pode encontrar mais detalhes sobre cada setor e os dados do comprador e do shipping que recomendamos incluir em cada um deles aqui.

Melhorar a experiência do usuário

Muitas vezes o comprador pode errar na hora de preencher seus dados no checkout. Por isso, vale a pena revisar cada passo, interações e até design, para checar se tudo está claro como deveria. Caso opte por criar seu front do zero, você encontra dicas de como fazê-lo de forma eficiente aqui. Se um pagamento for negado, é importante também que você explique aos seus clientes o motivo da recusa e o que eles poderão fazer para resolver o problema. Assim, seus clientes terão todas as informações necessárias para pagar sem problemas. Você encontra recomendações de mensagens para os principais motivos de recusa aqui.

Se, em vez disso, você quiser garantir uma interface otimizada, pode utilizar os componentes visuais de Checkout Bricks e também aproveitar um componente visual já pronto com as melhores mensagens com o Status Screen Brick.

Importante
Recomendamos verificar os resultados da medição da qualidade da sua integração antes de entrar em produção, seja ela realizada de maneira manual ou automática. Isso permitirá validar o cumprimento dos padrões de qualidade e segurança do Mercado Pago, além de fornecer ações para melhorar sua taxa de aprovação de pagamentos.