​
3DS DataOnly

O Data Only é um campo opcional no protocolo 3DS que envia dados da transação para a bandeira e o emissor, ajudando a melhorar a autenticação sem precisar de um desafio. Esse processo é sem atrito e o risco de chargeback continua com a loja.

​
Quando usar ?

Use o Data Only para enviar dados da transação ao emissor sem solicitar um desafio. Isso ajuda o emissor a ter mais informações para autenticar futuras transações.

​
Implementação

​
API Transacional

curl --location --request POST 'https://api.malga.io/v1/charges' \
--header 'X-Client-Id: <YOUR_CLIENT_ID>' \
--header 'X-Api-Key: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
	"merchantId": "469ed9e8-97d1-433a-a586-2fd282b7d9a4",
    "amount": 100,
    "statementDescriptor": "Pedido #231 loja joão",
    "capture": true,
    "paymentMethod": {
        "paymentType": "credit",
        "installments": 1
    },
    "paymentSource": {
		"sourceType": "card",
		"card": {
            "cardHolderName": "JOSE DAS NEVES",
            "cardNumber": "4929564637987814",
            "cardCvv": "123",
            "cardExpirationDate": "12/2026"
        }
	},
    "threeDSecure2": {
        "dataOnly": true,
        "redirectURL": "http://your-company/receive",
        "requestorURL": "http://your-company",
        "browser": {
            "acceptHeader": "*/*",
            "colorDepth": 24,
            "javaEnabled": true,
            "javaScriptEnabled": true,
            "language": "pt-BR",
            "screenHeight": 1080,
            "screenWidth": 1920,
            "timeZoneOffset": "180",
            "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36",
            "ip": "0.0.0.0"
        },
        "cardHolder": {
            "email": "cardHolder@email.com",
            "mobilePhone": "11 99329899"
        },
        "billingAddress": {
            "city": "Rio de Janeiro",
            "country": "Brasil",
            "streetNumber": "45",
            "zipCode": "2547896",
            "state": "RJ",
            "street": "Av. Brasil"
        },
        "shippingAddress": {
            "city": "São Paulo",
            "country": "Brasil",
            "streetNumber": "45",
            "zipCode": "2957896",
            "state": "SP",
            "street": "Rua das Flores"
        }
    }
 }'

​
Session API - Finalizar Sessão

curl --location 'https://api.malga.io/v1/sessions/<SESSION_ID>/charge' \
--header 'x-client-id: <YOUR_CLIENT_ID>' \
--header 'x-api-key: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "paymentMethod": {
        "paymentType": "credit",
        "installments": 1
    },
    "paymentSource": {
        "sourceType": "customer",
        "customerId": "<CUSTOMER_ID>"
    },
    "threeDSecure2": {
        "dataOnly": true,
        "redirectURL": "http://localhost",
        "requestorURL": "http://localhost",
        "browser": {
            "acceptHeader": "*/*",
            "colorDepth": 24,
            "javaEnabled": true,
            "javaScriptEnabled": true,
            "language": "pt-BR",
            "screenHeight": 1080,
            "screenWidth": 1920,
            "timeZoneOffset": "180",
            "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36",
            "ip": "127.0.0.1"
        },
        "cardHolder": {
            "email": "email@gmail.com",
            "mobilePhone": "123456789"
        }
    }
}'

​
Provedores Suportados

Atualmente, o 3DS DataOnly está disponível para os seguintes provedores:

  • Zoop
  • Rede

​
Considerações Importantes

  • O modo DataOnly é compatível com os serviços Transacional, Session API e Export Data
  • Todos os campos de dados 3DS continuam sendo obrigatórios mesmo no modo DataOnly
  • Os dados coletados podem ser utilizados para análise de risco e conformidade