POST/api/v1/validate
Validar transacción
Este endpoint validará una transacción de acuerdo con las reglas que se definieron previamente.
Cabecera
- Name
Content-Type- Type
- Content-Type
- is optional
- Description
- Ejemplo:
application/json;charset=UTF-8
- Name
Api-Key- Type
- Api-Key
- is optional
- Description
Este parámetro contiene la clave de api proporcionada por Evertec
Ejemplo:H0zMsPiLzegkYMFJxAuKJhUsyEimYstc
Solicitud
- Name
locale- Type
- string
- is optional
- Description
2 letras idioma y 2 letras país (es_CO)
Ejemplo:es_COPatrón:^[a-z]{2}_[A-Z]{2}$
- Name
payer- Type
- Payer
- is Required
- REQUIRED
- Description
Estructura que define los campos para una persona de tipo 'payer'
- Name
buyer- Type
- Person
- is optional
- Description
Estructura que define los campos para una persona de tipo 'buyer y shipping'
- Name
shipping- Type
- Person
- is optional
- Description
Estructura que define los campos para una persona de tipo 'buyer y shipping'
- Name
payment- Type
- Payment
- is Required
- REQUIRED
- Description
Estructura que describe la referencia de pago y su monto
- Name
instrument- Type
- Instrument
- is optional
- Description
Intrumento de pago
- Name
ip_address- Type
- string
- is optional
- Description
Dirección IP del cliente
- Name
user_agent- Type
- string
- is optional
- Description
Agente de usuario del cliente
Longitud máxima:255Longitud mínima:1
- Name
additional- Type
- object
- is optional
- Description
Es un objeto que permite enviar datos adicionalmes en formato JSON.
Nullable:Sí
- Name
fingerprints- Type
- object
- is optional
- Description
Objeto que agrupa los diferentes 'fingerprints' que se pueden validar
Nullable:Sí
Solicitud
POST
/api/v1/validate curl --request POST \
--url https://scudo-uat.placetopay.net/api/v1/validate \
--header 'Accept: application/json' \
--header 'Api-Key: ' \
--header 'Content-Type: application/json' \
--data '{
"locale": "es_CO",
"payer": {
"document": "555777888",
"document_type": "CC",
"first_name": "jhon",
"last_name": "doe",
"email": "[email protected]",
"mobile": "5557788",
"phone": "2223344",
"address": {
"address": "199-129 E 43rd St",
"state": "New York",
"city": "New York",
"postal_code": "10017",
"country": "US"
}
},
"buyer": {
"document": "555777888",
"document_type": "CC",
"first_name": "jhon",
"last_name": "doe",
"email": "[email protected]",
"mobile": "5557788",
"phone": "2223344",
"address": {
"address": "199-129 E 43rd St",
"city": "New York",
"state": "New York",
"postal_code": "10017",
"country": "US"
}
},
"shipping": {
"document": "555777888",
"document_type": "CC",
"first_name": "jane",
"last_name": "doe",
"email": "[email protected]",
"mobile": "4445566",
"phone": "9990011",
"address": {
"address": "199-129 E 43rd St",
"city": "New York",
"state": "New York",
"postal_code": "10017",
"country": "US"
}
},
"payment": {
"reference": "1567e989-86a1-41ca-b208-ca1acd694856",
"amount": {
"currency": "USD",
"total": 355
}
},
"instrument": {
"card": {
"pan_hash": "9bbef19476623ca56c17da75fd57734dbf82530686043a6e491c6d71befe8f6e",
"expiration_date": "12/22",
"bin": "411111",
"last_4": "1111"
},
"kount": {
"session": "1567e98986a141cab208ca1acd694856"
},
"merchant_code": "8888"
},
"ip_address": "127.0.0.1",
"user_agent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.3",
"additional": {
"key": "first value ",
"second_key": "second value ",
"array_object": [
{
"first_value": "first value "
},
{
"second_value": "first value "
}
],
"single_array": [
"one",
"two"
],
"object": {
"key": "value",
"second_key": "second value "
}
},
"fingerprints": {
"placetopay": "16aa112b4ebb8bf7152421c1a0ae7dc5c2a4c8046877b9c9264bceec24a4d3da",
"kount": "26aa112b4ebb8bf7152421c1a0ae7dc5c2a4c8046877b9c9264bceec24a4d3da",
"RSA": "36aa112b4ebb8bf7152421c1a0ae7dc5c2a4c8046877b9c9264bceec24a4d3da",
"lexis_nexis": "46aa112b4ebb8bf7152421c1a0ae7dc5c2a4c8046877b9c9264bceec24a4d3da",
"device_2": "56aa112b4ebb8bf7152421c1a0ae7dc5c2a4c8046877b9c9264bceec24a4d3da",
"device_1": "66aa112b4ebb8bf7152421c1a0ae7dc5c2a4c8046877b9c9264bceec24a4d3da",
"device_app": "76aa112b4ebb8bf7152421c1a0ae7dc5c2a4c8046877b9c9264bceec24a4d3da"
}
}'
Respuesta
OK
- Name
status- Type
- Status
- is optional
- Description
Estructura para definir estados de respuestas
- Name
data- Type
- object
- is optional
- Description
Objeto que agrupa los resultados de la validación
Nullable:Sí
Respuesta
{
"status": {
"code": 1200,
"name": "successful",
"message": "La transacción se valida con éxito"
},
"data": {
"id": "5da0c6a0-bc88-4482-821f-13428d1d8bac",
"transaction": {
"reference": "75c7bcc7-93ab-41a9-9bc9-2cf18f4d5003"
},
"action": {
"name": "process_transaction",
"performed_by": "Transunion",
"performed_by_code": "transunion"
},
"rules": [
{
"action": "continue_with_next_rule",
"name": "Paises permitidos según banco emisor",
"rule_code": "allowed_countries_for_issuer_bank",
"type": "filter",
"response": {
"match": null,
"failed": true
}
},
{
"action": "continue_with_next_rule",
"name": "Excluir coincidencia de pais para emisores",
"rule_code": "exclude_country_match_for_issuers",
"type": "filter",
"response": {
"match": null,
"failed": true
}
},
{
"action": "continue_with_next_rule",
"name": "Kount",
"rule_code": "kount",
"type": "score",
"response": {
"match": false,
"failed": false,
"score": "10",
"service_response": {
"isExecuted": true,
"score": "30",
"omniscore": "67",
"system": {
"version": "0720",
"mode": "Q",
"merchantId": "201000",
"sessonId": "40",
"orderReference": "7e53ebb0-ae84-4f4d-9d98-36c3d74a0136"
},
"decision": {
"code": "A",
"description": "APPROVE",
"shouldApprove": true,
"shouldDecline": false,
"shouldReview": false
},
"verification": {
"geolocationCountry": "CO",
"geolocationRegion": "CO_02",
"cardBrand": "VISA",
"cardIsBlacklisted": false,
"aCatchVerificationHasBeenPerformed": false,
"threeDsMerchantResponse": "",
"denialReasonCode": ""
},
"transaction": {
"id": "KNZ501674051",
"usedCardsCount": 1,
"usedDevicesCount": 1,
"deviceLayers": "DF651ACF30..99CF09F417.E3D16F2CB7.061826EF2B",
"usedEmailsCount": 1,
"velocity": 0,
"maxAllowedVelocity": 0,
"site": "DEFAULT",
"fingerprint": "4C2410BA22A64E21BF0C73EA88E48D7E",
"timezone": "300",
"localtime": "2017-05-31 00:19",
"region": "CO_02",
"country": "CO",
"httpCountry": "US",
"hasProxy": false,
"hasJavascript": true,
"hasFlash": false,
"hasCookies": true,
"language": "en",
"processedFromMobileDevice": false,
"mobileType": "",
"mobileIsThroughMobileForwarder": false,
"processedFromVoiceDevice": false,
"processedFromRemotePC": false
},
"ip": {
"address": "181.128.85.221",
"latitude": "6.2518",
"longitude": "-75.5636",
"country": "CO",
"state": "Antioquia",
"city": "Medellin",
"provider": "UNE"
},
"additional": {
"dateSinceFirstMadeTransaction": "",
"screenResolution": "1050x1680",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML like Gecko) Chrome/76.0.3809.100 Safari/537.36",
"operativeSystem": "Mac OS X 10.14.6",
"browser": "",
"wasPreviouslyWhitelisted": false
},
"triggeredRules": {
"693746": "GEOX Lower Risk Review Countries"
},
"triggeredCounters": {
"PAISESPARAREVISION": "1"
},
"warnings": [
"401 EXTRA_DATA in request. Please see RIS spec for valid fields and ensure RIS input is URL encoded."
],
"errorsBag": {
"isErrorResponse": false,
"code": null,
"key": null,
"errors": []
}
}
}
},
{
"action": "continue_with_next_rule",
"name": "Monto por cliente",
"rule_code": "amount_by_client",
"type": "filter",
"response": {
"match": false,
"failed": false
}
},
{
"action": "continue_with_next_rule",
"name": "Número de correos electrónicos por Ip",
"rule_code": "number_of_emails_by_ip",
"type": "filter",
"response": {
"match": false,
"failed": false
}
},
{
"action": "continue_with_next_rule",
"name": "Número de correos electrónicos por tarjeta",
"rule_code": "number_of_emails_by_card",
"type": "filter",
"response": {
"match": false,
"failed": false
}
},
{
"action": "continue_with_next_rule",
"name": "Número de transacciones por tarjeta",
"rule_code": "number_of_transactions_by_card",
"type": "filter",
"response": {
"match": false,
"failed": false
}
},
{
"action": "continue_with_next_rule",
"name": "Paises permitidos para compradores",
"rule_code": "allowed_countries_for_buyers",
"type": "filter",
"response": {
"match": false,
"failed": false
}
},
{
"action": "continue_with_next_rule",
"name": "Número de tarjetas",
"rule_code": "number_of_cards_by_client",
"type": "filter",
"response": {
"match": false,
"failed": false
}
},
{
"action": "continue_with_next_rule",
"name": "Número de transacciones",
"rule_code": "number_of_transactions_by_client",
"type": "filter",
"response": {
"match": false,
"failed": false
}
},
{
"action": "continue_with_next_rule",
"name": "Forzar coincidencia de IP país y banco emisor",
"rule_code": "match_country_ip_and_issuer_bank",
"type": "filter",
"response": {
"match": null,
"failed": true
}
},
{
"action": "continue_with_next_rule",
"name": "Número de tarjetas por entidad",
"rule_code": "number_of_transactions_by_card",
"type": "filter",
"response": {
"match": false,
"failed": false
}
},
{
"action": "continue_with_next_rule",
"name": "Monto por entidad",
"rule_code": "amount_by_client",
"type": "filter",
"response": {
"match": false,
"failed": false
}
},
{
"action": "continue_with_next_rule",
"name": "La tarjeta proviene del usuario",
"rule_code": "card_belongs_to_user",
"type": "filter",
"response": {
"match": false,
"failed": false
}
},
{
"action": "continue_with_next_rule",
"name": "Histórico de transacciones",
"rule_code": "historical",
"type": "score",
"response": {
"match": false,
"failed": false,
"score": "320",
"service_response": {
"risk": "high",
"score": "1000",
"reason": "high",
"email": "[email protected]",
"panHash": "02C3C62FB7C7EB153F16219E44CDFAA85C41814D",
"document": "CC 1040035000",
"mobile": "3152807334",
"phone": "2261751",
"ipAddress": "132.248.0.1",
"date": null
}
}
},
{
"action": "continue_with_next_rule",
"name": "Emailage",
"rule_code": "emailage",
"type": "score",
"response": {
"match": false,
"failed": false,
"score": "0",
"service_response": {
"emailInformation": {
"email": "[email protected]",
"age": "",
"country": "US",
"company": "",
"exists": "Yes",
"status": "Verified",
"firstSeen": "2010-07-17T07:00:00Z",
"firstSeenDays": "3617",
"lastSeen": "2020-06-12T03:37:56Z",
"imageUrl": "",
"hits": "2",
"uniqueHits": "1",
"creationDays": "",
"domain": {
"name": "gmail.com",
"age": "1995-08-13T04:00:00Z",
"category": "Webmail",
"corporate": "No",
"exists": "Yes",
"company": "Google",
"countryName": "United States",
"riskLevel": "3",
"riskCountry": "No",
"riskLevelMessage": "Moderate",
"relevantInfo": "508",
"relevantInfoMessage": "Valid Webmail Domain from United States",
"creationDays": "9069",
"fraudRisk": "071 Very Low"
}
},
"addressInformation": {
"billRiskCountry": "No",
"cityPostalMatch": "Yes",
"domainCountryMatch": "Yes",
"shippingCityPostalMatch": "No",
"shippingForward": ""
},
"ipInformation": {
"ip": "132.248.0.1",
"anonymousDetected": null,
"autonomousSystemNumber": null,
"city": "fairbanks",
"corporateProxy": null,
"country": "CO",
"countryMatch": null,
"domain": null,
"isp": null,
"region": "latinamerica",
"latitude": "64.8363",
"longitude": "-147.715",
"netSpeed": null,
"organization": null,
"reputation": null,
"userType": null
},
"digitalIdentityScoreInformation": {
"description": "High Confidence",
"overallScore": 87,
"billAddressToFullNameConfidence": 66,
"billAddressToLastNameConfidence": 55,
"emailToIpConfidence": 80,
"emailToBillAddressConfidence": 78,
"emailToFullNameConfidence": 88,
"emailToLastNameConfidence": 89,
"emailToPhoneConfidence": 44,
"emailToShipAddressConfidence": 78,
"ipToBillAddressConfidence": 90,
"ipToFullNameConfidence": 45,
"ipToLastNameConfidence": 56,
"ipToPhoneConfidence": 71,
"ipToShipAddressConfidence": 100,
"phoneToBillAddressConfidence": 100,
"phoneToFullNameConfidence": 97,
"phoneToLastNameConfidence": 34,
"phoneToShipAddressConfidence": 87,
"shipAddressToBillAddressConfidence": 77,
"shipAddressToFullNameConfidence": 78,
"shipAddressToLastNameConfidence": 34
},
"ipRiskInformation": {
"level": "3",
"levelMessage": "Moderate",
"reasonId": "311",
"reason": "Moderate By Proxy Reputation And Country Code",
"riskCountry": ""
},
"ipLocationInformation": {
"callingCode": "907",
"city": "fairbanks",
"cityConfidence": "95",
"continentCode": "na",
"country": "Colombia",
"countryCode": "CO",
"countryConfidence": "99",
"distanceMil": "5366",
"distanceKm": "8637",
"latitude": "64.8363",
"longitude": "-147.715",
"map": "https://app.emailage.com/query/GoogleMaps?latLng=64.8363,-147.715",
"metroCode": "745",
"region": "latinamerica",
"regionConfidence": "99",
"postalCode": "99701",
"postalConfidence": "50",
"timeZone": "-500"
},
"emailOwnerInformation": {
"eName": "Test EA",
"location": "",
"title": ""
},
"phoneInformation": {
"carrierName": "Verizon Wireless",
"carrierType": "mobile",
"inBillingLocation": "Not Found",
"owner": "Test EA",
"ownerMatch": "Y",
"ownerType": "CONSUMER",
"status": "VALID"
},
"socialMediaInformation": {
"smFriends": "53",
"smLinks": [
{
"source": "GoogleSearch",
"link": "https://plus.google.com/115619223171371600000"
},
{
"source": "Facebook",
"link": "https://www.facebook.com/user"
}
]
},
"score": "0",
"riskReason": "14",
"riskReasonMessage": "Email Created at least 9.9 Years Ago",
"riskStatus": "2",
"riskAdvice": "3",
"riskAdviceMessage": "Lower Fraud Risk",
"riskBand": "1",
"sourceIndustry": "",
"fraudType": "",
"lastFlaggedOn": "",
"returnCode": "0",
"returnMessage": "",
"isExecuted": true
}
}
},
{
"action": "continue_with_next_rule",
"name": "Transunion",
"rule_code": "transunion",
"type": "score",
"response": {
"match": false,
"failed": false,
"score": "995",
"service_response": {
"document": "123456789",
"documentType": "CC",
"fullName": "Foo",
"documentStatus": 1,
"documentStatusText": "Vigente",
"ageRange": "",
"sheetCode": "05521509999999999999",
"sheetDateTime": "2021-02-25T08:50:16-05:00",
"returnCode": 1,
"returnText": "Consulta exitosa",
"score": "995",
"match": true,
"errorMessage": null,
"failed": false,
"isExecuted": true
}
}
},
{
"action": "reject_transaction",
"name": "Red de comportamiento",
"rule_code": "behavioral_network",
"type": "score",
"response": {
"match": true,
"failed": false,
"score": "0.99",
"service_response": {
"fraudScore": 0.99,
"fraudConcept": [
{
"code": "F22",
"description": "Empresas fachada - Frecuencia inusual de país emisor tarjeta en comercio"
},
{
"code": "F23",
"description": "Calidad de datos en el navegador"
},
{
"code": "F24",
"description": "Calidad de datos en sistema operativo"
}
],
"legalScore": 0.01,
"legalConcept": [
{
"code": "L11",
"description": "Calidad de datos de sección de comercio"
},
{
"code": "L10",
"description": "Calidad de datos en tarjeta"
},
{
"code": "L1",
"description": "Similitud con historial de pago"
}
],
"reliable": true,
"errorMessage": null
}
}
}
]
}
}