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 vendas parceladas, utilize productType como lojista. Para vendas à vista, utilize avista.

Exemplo de requisição
{
  "payment": {
    "transactionType": "debit",
    "amount": 1035,
    "productType": "debito",
    "installments": 1
  },
  "sellerInfo": {
    "codeAntiFraud": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "code3DS": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "urlSite3DS": "https://seu-site.com.br"
  },
  "cardInfo": {
    "numberToken": "88f466c4-d17a-4430-952f-2a44bdb98525",
    "cardholderName": "JOSE SILVA",
    "securityCode": "123",
    "expirationMonth": "01",
    "expirationYear": "30"
  },
  "customer": {
    "documentNumber": "12345678901",
    "firstName": "Jose",
    "lastName": "Silva",
    "email": "[email protected]",
    "ipAddress": "192.168.1.1"
  },
  "deviceInfo": {
    "httpAcceptBrowserValue": "text/html,application/xhtml+xml",
    "httpBrowserLanguage": "pt-BR",
    "httpBrowserJavaEnabled": "N",
    "httpBrowserJavaScriptEnabled": "N",
    "httpBrowserColorDepth": 24,
    "httpBrowserScreenHeight": 900,
    "httpBrowserScreenWidth": 1440,
    "httpBrowserTimeDifference": 180
  }
}
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"
  }
}

Retorno (200)

Erros

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