SopagueDocs
v3

Criar Pagamento 3DS

POST/v1/payments/3ds

Cria uma transação de pagamento com autenticação 3DS. Certifique-se de que as bibliotecas de Antifraude e 3DS estejam corretamente implementadas antes de realizar operações.

Parâmetros

Para transações de débito, utilize productType como debito. Para vendas no crédito parceladas, utilize lojista. Para vendas no crédito à vista, utilize avista.

Exemplo de requisição
{
  "cardInfo": {
    "cardholderName": "JOAO DA SILVA",
    "expirationMonth": "12",
    "expirationYear": "28",
    "numberToken": "98a76b5c-4321-fedc-ba98-76543210fedc",
    "securityCode": "123"
  },
  "payment": {
    "amount": 15050,
    "installments": 1,
    "productType": "debito",
    "transactionType": "debit"
  },
  "sellerInfo": {
    "CodeAntiFraud": "123456",
    "Code3DS": "3DSv2",
    "UrlSite3DS": "https://pagamentos.sanepar.com.br/retorno-3ds"
  },
  "customer": {
    "documentNumber": "12345678901",
    "email": "[email protected]",
    "ipAddress": "177.18.200.50",
    "firstName": "JOAO",
    "lastName": "DA SILVA",
    "phoneNumber": "41999998888",
    "mobilePhoneNumber": "41999998888",
    "address": "Rua Exemplo, 123",
    "city": "Curitiba",
    "state": "PR",
    "zipCode": "80000000",
    "country": "BRA"
  },
  "deviceInfo": {
    "httpAcceptBrowserValue": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
    "httpAcceptContent": "*/*",
    "httpBrowserLanguage": "pt-BR",
    "httpBrowserJavaEnabled": false,
    "httpBrowserJavaScriptEnabled": true,
    "httpBrowserColorDepth": "24",
    "httpBrowserScreenHeight": "1080",
    "httpBrowserScreenWidth": "1920",
    "httpBrowserTimeDifference": "-180",
    "userAgentBrowserValue": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36",
    "ipAddress": "177.18.200.50"
  }
}

Retorno (200)

Exemplo de resposta
{
  "paymentAuthorization": {
    "amount": 10,
    "authorizationCode": "727874",
    "description": "Sucesso",
    "orderNumber": "956a3013-c9a7",
    "paymentId": "020062004408221314340001417728510000000000",
    "releaseAt": "2024-08-22T10:14:34.077",
    "returnCode": "0"
  },
  "threeDs": {
    "eci": "05",
    "paresStatus": "Y",
    "status": "Silent",
    "threeDsStatus": "AUTHENTICATION_SUCCESSFUL",
    "threeDsVersion": "2.1.0",
    "veresEnrolled": "Y"
  }
}

Erros

[{
  "tag": "3DS Fail",
  "description": "eci: 00 - threeDsVersion: 2.1.0 - threeDsStatus: AUTHENTICATION_SUCCESSFUL - veresEnrolled: U"
}]