Metadata
- – El metadata se utiliza en el análisis de fraude eCommerce, por lo que es una función de carácter obligatorio, ya que se alimenta de la información que registra el tarjetahabiente, validando el comportamiento y parámetros del mismo.
- – Mientras más datos se añadan a la metadata, el análisis de fraude será mas eficiente y por ende la prevención de generación de contracargos.
- – Recuerda que el metadata debe enviarse en cada transacción, puedes leer más en la documentación de la API: Crear Pago con Tarjeta.
- – Puedes Recolectarla cuando tu cliente se registre en tu plataforma, y enviarla con el proceso de cobro, alternativamente puedes crear una interfaz gráfica que solicite la recolección de los datos requeridos.
Datos Requeridos
Ejemplo PHP
$metadata = array(
"billing" => array(
"billingEmailAddress" => "[email protected]",
"billingFirstName-D"=> "Nombre",
"billingMiddleName-D"=> "Segundo Nombre",
"billingLastName-D"=> "Apellidos",
"billingAddress-D" => "Calle 1",
"billingAddress2-D"=> "Colonia",
"billingCity-D"=> "Ciudad",
"billingState-D"=> "CX",
"billingPostalCode-D"=> "00000",
"billingCountry-D"=> "MX",
"billingPhoneNumber-D"=> "0000000000",
),
"member"=> array(
"memberFullName"=> "Nombre Appellidos",
"memberFirstName"=> "Nombre",
"memberMiddleName"=> "Segundo Nombre",
"memberLastName"=> "Apellidos",
"memberEmailAddress"=> "[email protected]",
"memberAddressLine1"=> "Calle 1",
"memberAddressLine2"=> "Colonia",
"memberCity"=> "Ciudad",
"memberState"=> "CX",
"memberCountry"=> "MX",
"memberPostalCode"=> "00000",
"memberPhone"=>"0000000000"
),
"items"=> array (
"item"=> array (
array(
"itemNumber"=> "01",
"itemDescription" => "TEST",
"itemPrice"=>"100",
"itemQuantity" => "1",
"itemMeasurementUnit"=> "PZ",
"itemBrandName"=>"SR.Pago",
"itemCategory"=> "TI",
"itemTax"=> "0.00",
),
),
),
Si en tu E-commerce realizas envíos a domicilio debes agregar las siguientes líneas en el apartado Shipping:
"shipping"=> array(
"shippingCharges"=> "100.50",
"shippingFirstName"=> "Juan",
"shippingMiddleName"=> "Pablo",
"shippingLastName"=> "Perez",
"shippingEmailAddress"=> "[email protected]",
"shippingAddress"=> "a",
"shippingAddress2"=> "b",
"shippingCity"=> "s",
"shippingState"=> "Chicago",
"shippingPostalCode"=> "12345",
"shippingCountry"=> "MX",
"shippingPhoneNumber"=> "",
"shippingMethod"=> "mail",
"shippingDeadline"=> "2015-08-01",),
);
Ejemplo JSON
Este ejemplo tiene todos los campos que se pueden enviar:
{
"salesTax": "160.00",
"browserCookie": "session=743663;",
"orderMessage": "No tocar el timbre, esperare afuera",
"billing": {
"billingEmailAddress": "[email protected]",
"billingFirstName-D": "Juan",
"billingMiddleName-D": "Antonio",
"billingLastName-D": "Perez",
"billingAddress-D": "Arkansas 16",
"billingAddress2-D": "Insurgentes",
"billingCity-D": "CDMX",
"billingState-D": "DF",
"billingPostalCode-D": "03810",
"billingCountry-D": "MEX",
"billingPhoneNumber-D": "87654321",
"creditCardAuthorizedAmount-D": "2000.00"
},
"giftCards": {
"giftCard": [
{
"giftCardNumber": "ABC1234567890",
"giftCardAmount": "10.95"
},
{
"giftCardNumber": "JKL09876543231",
"giftCardAmount": "15.30"
}
]
},
"coupons": {
"coupon": [
{
"couponCode": "011293674310",
"couponAmount": "50.00"
},
{
"couponCode": "704757305096",
"couponAmount": "70.00"
}
]
},
"promotions": {
"promotion": [
{
"promotionCode": "P0001",
"promotionAmount": "100.00"
},
{
"promotionCode": "P0002",
"promotionAmount": "50.00"
}
]
},
"certificates": {
"certificate": [
{
"certificateUsedValue": "76",
"certificatePromoCode": "07689",
"certificatePinCode": "65588",
"certificateLoyaltyMemberId": "88766445",
"certificateLoyaltyProgramCode": "867e548",
"certificateIssueReasonCode": "asdfg",
"certificateIssueLocation": "web",
"certificateIssueDate": "2015-07-03",
"certificateInitialValue": "100",
"certificateExpirationDate": "2016-01-01",
"certificateId": "66769",
"certificateCurrentValue": "24"
}
]
},
"member": {
"memberLoggedIn": "Si/No",
"memberId": "TBI23457",
"membershipDate": "2010-02-12",
"memberFullName": "Berenice Garcia Toral",
"memberFirstName": "Berenice",
"memberMiddleName": "Garcia",
"memberLastName": "Toral",
"memberEmailAddress": "[email protected]",
"memberAddressLine1": "123 Main St",
"memberAddressLine2": "main",
"memberCity": "Chicago",
"memberState": "IL",
"memberCountry": "US",
"memberPostalCode": "60601",
"membershipLevel": "3",
"membershipStatus": "activo",
"latitude": "19",
"longitude": "19",
"memberPhone": "312-555-5555"
},
"shipping": {
"shippingCharges": "100.50",
"shippingFirstName": "Juan",
"shippingMiddleName": "Pablo",
"shippingLastName": "Perez",
"shippingEmailAddress": "[email protected]",
"shippingAddress": "a",
"shippingAddress2": "b",
"shippingCity": "s",
"shippingState": "Chicago",
"shippingPostalCode": "12345",
"shippingCountry": "MEX",
"shippingPhoneNumber": "87654321",
"shippingMethod": "mail",
"shippingDeadline": "2015-08-01"
},
"items": {
"item": [
{
"itemNumber": "193487654",
"itemDescription": "iPhone 6 32gb",
"itemPrice": "599.00",
"itemQuantity": "1",
"itemMeasurementUnit": "Pza",
"itemBrandName": "Apple",
"itemCategory": "Electronics",
"itemTax": "12.95"
},
{
"itemNumber": "193487654",
"itemDescription": "iPhone 6 64gb",
"itemPrice": "599.00",
"itemQuantity": "2",
"itemMeasurementUnit": "Pza",
"itemBrandName": "Samsung",
"itemCategory": "Electronics",
"itemTax": "12.95"
}
]
},
"dispatchers": {
"dispatcher": [
{
"dispatcherId": "193487654",
"dispatcherName": "Jose",
"dispatcherLastName": "Mtz"
}
]
},
"retail": {
"initialSalesRep": "Jaime Mtz",
"initialSalesRepDeviceId": "43r2e02dkewf2",
"initialSalesRepId": "1314",
"finalSalesRep": "Jaime Mtz",
"finalSalesRepDeviceId": "43r2e02dkewf2",
"finalSalesRepId": "1314",
"salesChannel": "Abarrotes, Vinos, Licores, ",
"referralCode": "CFB2010"
}
}