Skip to main content
POST
/
authentication
/
3ds
Iniciar autenticação 3DS
curl --request POST \
  --url https://api.conta.paybeehive.com.br/v1/authentication/3ds \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cardholderName": "ANA B NUNES",
  "cardNumber": "4111111111111111",
  "cardExpirationMonth": 12,
  "cardExpirationYear": 2030,
  "cardCvv": "123",
  "amount": 10000,
  "currency": "BRL",
  "externalId": "3ds_ext_hb_1001",
  "customer": {
    "name": "Bruce Wayne",
    "email": "[email protected]",
    "document": {
      "number": "12345678909",
      "type": "cpf"
    },
    "externalRef": "cust_ext_001",
    "phone": "+5511999999999",
    "birthdate": "1990-01-01",
    "address": {
      "street": "Av. Brigadeiro Faria Lima",
      "number": "1811",
      "complement": "Conj 1119",
      "neighborhood": "Itaim Bibi",
      "city": "São Paulo",
      "state": "SP",
      "zipcode": "01452001",
      "country": "BR"
    }
  },
  "browserInfo": {
    "userAgent": "Mozilla/5.0 ...",
    "acceptHeader": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
    "language": "pt-BR",
    "javaEnabled": false,
    "timezone": -180,
    "ipAddress": "189.10.20.30"
  }
}
'
{
  "status": "challenge_required",
  "transactionId": 123,
  "authenticationUrl": "https://3ds.paybeehive.com/auth/abc123",
  "eci": "05",
  "cavv": "AAABBBCCC111222333",
  "threeDSVersion": "2.2.0"
}

Authorizations

​
Authorization
string
header
required

Basic Authorization usando SECRET_KEY como usuário e "x" como senha.

Headers

​
Idempotency-Key
string

Chave de idempotência para evitar duplicidade em retries.

Body

application/json
​
cardholderName
string
required
Example:

"ANA B NUNES"

​
cardNumber
string
required
Example:

"4111111111111111"

​
cardExpirationMonth
integer
required
Example:

12

​
cardExpirationYear
integer
required
Example:

2030

​
cardCvv
string
required
Example:

"123"

​
amount
integer
required
Example:

10000

​
currency
string
required
Example:

"BRL"

​
externalId
string
required
Example:

"3ds_ext_hb_1001"

​
customer
object
required
​
browserInfo
object
required

Response

Resultado da autenticação 3DS

​
status
enum<string>
required
Available options:
challenge_required,
frictionless,
failed,
unavailable
Example:

"challenge_required"

​
transactionId
integer
required
Example:

123

​
authenticationUrl
string
Example:

"https://3ds.paybeehive.com/auth/abc123"

​
eci
string
Example:

"05"

​
cavv
string
Example:

"AAABBBCCC111222333"

​
threeDSVersion
string
Example:

"2.2.0"