Payway SDK PHP

Aclaración

El campo amount de todos los pagos y operaciones son de tipo Long, se consideran los 2 ultimos digitos como la parte decimal del importe.

Monto	Ejemplo SDK
$1250,45	125045
$1.500.250,50	150025050
$3000,00	300000

Modulo para conexión con gateway de pago Payway

Introducción
Instalación
Uso
Tablas de referencia
- Códigos de Medios de Pago
  - Divisas Aceptadas
- Provincias
Errores
- Errores de sistema
- Errores de marca

Introducción

El flujo de una transacción a través de las sdks consta de dos pasos, la generación de un token de pago por parte del cliente y el procesamiento de pago por parte del comercio. Existen sdks específicas para realizar estas funciones en distintos lenguajes que se detallan a continuación:

Generación de un token de pago. Se utiliza alguna de las siguentes sdks front-end :
- sdk Javascript
Procesamiento de pago. Se utiliza alguna de las siguentes sdks back-end :
- sdk Java
- sdk PHP
- sdk .Net
- sdk Node

Alcance

La sdk PHP provee soporte para su aplicación back-end, encargandose de la comunicación del comercio con la API Payway utilizando su API Key privada¹ y el token de pago generado por el cliente.

Para generar el token de pago, la aplicación cliente realizará con Payway a través de alguna de las siguentes sdks front-end:

sdk Javascript

Volver al inicio

TimeOut

El tiempo standard de Timeout para una transaccion es de 6 segundos. Puede existir casos excepcionales, mucho flujo de transacciones concurrentes , en el cual el timeout puede variar entre** 20 a 30 segundos**. Si el cliente decide configurar un timeout menor al indicado, deberá anular las transacciones en estado "Autorizadas" de manera manual.

_{Volver a inicio}

Diagrama de secuencia

El flujo de una transacción a través de las sdks consta de dos pasos, a saber:

sdk front-end: Se realiza una solicitud de token de pago con la Llave de Acceso pública (public API Key), enviando los datos sensibles de la tarjeta (PAN, mes y año de expiración, código de seguridad, titular, y tipo y número de documento) y obteniéndose como resultado un token que permitirá realizar la transacción posterior.

sdk back-end: Se ejecuta el pago con la Llave de Acceso privada (private API Key), enviando el token generado en el Paso 1 más el identificador de la transacción a nivel comercio, el monto total, la moneda y la cantidad de cuotas.

A continuación, se presenta un diagrama con el Flujo de un Pago.

Volver al inicio

Instalación

El SDK se encuentra disponible para descargar desde Github o desde composer con el siguiente comando:

  
composer require decidir2/php-sdk

Una vez instalo el SDK dentro del proyecto, es necesario tener descomentada la extension=php_curl.dll en el php.ini, ya que para la conexión al gateway se utiliza la clase curl del API de PHP.

Volver al inicio

Versiones de PHP soportadas

La versión implementada de la SDK, está testeada para las versiones PHP desde 5.3.

Volver al inicio

Manual de Integración

Se encuentra disponible la documentación Manual de Integración Payway para su consulta online, en este se detalla el proceso de integración. En el mismo se explican los servicios y operaciones disponibles, con ejemplos de requerimientos y respuestas, aquí sólo se ejemplificará la forma de llamar a los distintos servicios utilizando la presente SDK.

Ambientes

El sdk PHP permite trabajar con los ambientes de Sandbox y Producción de Payway. El ambiente se debe definir al instanciar el SDK.

	
$ambient = "test";//valores posibles: "test" , "prod" o "qa"
$connector = new \Decidir\Connector($keys_data, $ambient);

Volver al inicio

Uso

Inicializar la clase correspondiente al conector.

El SDK-PHP permite trabajar con los ambientes de desarrollo y de producción de Payway. El ambiente se debe instanciar como se indica a continuación. Instanciación de la clase Decidir\Connector La misma recibe como parámetros la public key o private key provisto por Payway para el comercio y el ambiente en que se trabajara.

$keys_data = array('public_key' => 'e9cdb99fff374b5f91da4480c8dca741',
           'private_key' => '92b71cf711ca41f78362a7134f87ff65');

$ambient = "test";//valores posibles: "test" , "prod" o "qa"
$connector = new \Decidir\Connector($keys_data, $ambient);

Nota: La sdk incluye un ejemplo de prueba completo el cual se debe acceder desde el navegador, allí permitirá configurar las distintas opciones.

_{Volver a inicio}

Operatoria del Gateway

Health Check

Este recurso permite conocer el estado actual de la API RESTful de Payway.

$connector = new \Decidir\Connector($keys_data, $ambient);
$response = $connector->healthcheck()->getStatus();
$response->getName();
$response->getVersion();
$response->getBuildTime();

_{Volver a inicio}

Token

Este recurso permite obtener token de pago.

$connector = new \Decidir\Connector($keys_data, $ambient, "", "", "SDK-PHP");
$data = array(
      "card_number" => "4509790112684851",
      "card_expiration_month" => "12",
      "card_expiration_year" => "30", 
      "card_holder_name" => "Barb",
      "card_holder_birthday" => "24071990",
      "card_holder_door_number" => 505,
      "security_code" => "123",
      "card_holder_identification" => array(
          "type" => "dni",
          "number" => "29123456"));
       
$response = $connector->token()->token($data);
$respuesta = new TokenResponse();

$respuesta->setId($response->get('id',null));
$respuesta->setStatus($response->get('status',null));
$respuesta->setCardNumberLength($response->get('card_number_length', null));
$respuesta->setDateCreated($response->get('date_created', null));
$respuesta->setBin($response->get('bin', null));
$respuesta->setLastFourDigits($response->get('last_four_digits', null));
$respuesta->setSecurityCodeLength($response->get('security_code_length', null));
$respuesta->setExpirationMonth($response->get('expiration_month', null));
$respuesta->setExpirationYear($response->get('expiration_year', null));
$respuesta->setDateDue($response->get('date_due', null));
$cardHolder = $response->get('cardholder', null);
$respuesta->setType($cardHolder['identification']['type']);
$respuesta->setNumber($cardHolder['identification']['number']);
$respuesta->setName($cardHolder['name']);

_{Volver a inicio}

TokenCS

Este recurso permite obtener token de pago.

$connector = new \Decidir\Connector($keys_data, $ambient, "", "", "SDK-PHP");
$data = array(
      "card_number" => "4509790112684851",
      "card_expiration_month" => "12",
      "card_expiration_year" => "30", 
      "card_holder_name" => "Barb",
      "card_holder_birthday" => "24071990",
      "card_holder_door_number" => 505,
      "security_code" => "123",
      "card_holder_identification" => array(
        "type" => "dni",
        "number" => "29123456"
      ),
      "fraud_detection"=> array(
          "device_unique_identifier"=> "12345"
      ),
      "ip_address"=> "192.168.100.1");
       
$response = $connector->token()->tokenCs($data);
$respuesta = new TokenResponse();

$respuesta->setId($response->get('id',null));
$respuesta->setStatus($response->get('status',null));
$respuesta->setCardNumberLength($response->get('card_number_length', null));
$respuesta->setDateCreated($response->get('date_created', null));
$respuesta->setBin($response->get('bin', null));
$respuesta->setLastFourDigits($response->get('last_four_digits', null));
$respuesta->setSecurityCodeLength($response->get('security_code_length', null));
$respuesta->setExpirationMonth($response->get('expiration_month', null));
$respuesta->setExpirationYear($response->get('expiration_year', null));
$respuesta->setDateDue($response->get('date_due', null));
$cardHolder = $response->get('cardholder', null);
$respuesta->setType($cardHolder['identification']['type']);
$respuesta->setNumber($cardHolder['identification']['number']);
$respuesta->setName($cardHolder['name']);

Ejecución del Pago

Una vez generado y almacenado el token de pago, se deberá ejecutar la solicitud de pago más el token previamente generado. Además del token de pago y los parámetros propios de la transacción, el comercio deberá identificar la compra con el site_transaction_id.

Aclaracion : amount es un campo Long, los ultimos dos numeros se considerarán como decimales.

Campo	Descripcion	Oblig	Restricciones	Ejemplo
id	id usuario que esta haciendo uso del sitio, pertenece al campo customer (ver ejemplo)	Condicional, si no se enviar el Merchant este campo no se envia	Sin validacion	user_id: "marcos",
email	email del usuario que esta haciendo uso del sitio (se utiliza para tokenizacion), pertenece al campo customer(ver ejemplo)	Condicional	Sin validacion	email: "user@mail.com",
ip_address	IP del comercio	Condicional	Sin validacion	ip_address: "192.168.100.2",
site_transaction_id	nro de operacion	SI	Alfanumerico de hasta 39 caracteres	"prueba 1"
site_id	Site relacionado a otro site, este mismo no requiere del uso de la apikey ya que para el pago se utiliza la apikey del site al que se encuentra asociado.	NO	Se debe encontrar configurado en la tabla site_merchant como merchant_id del site_id	28464385
token	token generado en el primer paso	SI	Alfanumerico de hasta 36 caracteres. No se podra ingresar un token utilizado para un pago generado anteriormente.	""
payment_method_id	id del medio de pago	SI	El id debe coincidir con el medio de pago de tarjeta ingresada.Se valida que sean los primeros 6 digitos de la tarjeta ingresada al generar el token.	payment_method_id: 1,
bin	primeros 6 numeros de la tarjeta	SI	Importe minimo = 1 ($0.01)	bin: "456578"
amount	importe del pago	SI	Importe Maximo = 9223372036854775807 ($92233720368547758.07)	amount=20000
currency	moneda	SI	Valor permitido: ARS	ARS
installments	cuotas del pago	SI	"Valor minimo = 1 Valor maximo = 99"	installments: 1
payment_type	forma de pago	SI	Valor permitido: single / distributed
"single"
establishment_name	nombre de comercio	Condicional	Alfanumerico de hasta 25 caracteres	"Nombre establecimiento"

Ejemplo

$connector = new \Decidir\Connector($keys_data, $ambient);

$data = array(
      "site_transaction_id" => "12042017_20",
      "token" => "be211413-757b-487e-bb0c-283d21c0fb6f",
      "customer" => array(
                        "id" => "customer", 
                        "email" => "user@mail.com"
                        "ip_address" => "192.168.100.2"
                        ),
      "payment_method_id" => 1,
      "bin" => "450799",
      "amount" => 500,
      "currency" => "ARS",
      "installments" => 1,
      "description" => "",
      "establishment_name" => "Nombre establecimiento",
      "payment_type" => "single",
      "sub_payments" => array()
    );

try {
	$response = $connector->payment()->ExecutePayment($data);
	$response->getId();
	$response->getToken();
	$response->getUser_id();
	$response->getPayment_method_id();
	$response->getBin();
	$response->getAmount();
	$response->getCurrency();
	$response->getInstallments();
	$response->getPayment_type();
	$response->getDate_due();
	$response->getSub_payments();
	$response->getStatus();
	$response->getStatus_details()->ticket
	$response->getStatus_details()->card_authorization_code
	$response->getStatus_details()->address_validation_code
	$response->getStatus_details()->error
	$response->getDate();
	$response->getEstablishment_name();
	$response->getFraud_detection();
	$response->getAggregate_data();
	$response->getSite_id();
} catch( \Exception $e ) {
	var_dump($e->getData());
}

_{Volver a inicio}

Transacción PCI

A continuación se muestra un ejemplo con una transacción pci sin Cybersource.

Aclaracion : amount es un campo long el cual representa el valor en centavos.

Ejemplo

$connector = new \Decidir\Connector($keys_data, $ambient);

$data = array(
      "site_transaction_id" => "12042017_20",
      "token" => "be211413-757b-487e-bb0c-283d21c0fb6f",
      "customer" => array(
                        "id" => "customer", 
                        "email" => "user@mail.com"
                        "ip_address" => "192.168.100.2"
                        ),
      "payment_method_id" => 1,
      "bin" => "450799",
      "amount" => 500,
      "currency" => "ARS",
      "installments" => 1,
      "description" => "",
      "establishment_name" => "Nombre establecimiento",
      "payment_type" => "single",
      "sub_payments" => array(),
      "card_data" => array(
	"card_number" => "4509790112684851",
        "card_expiration_month" => "12",
        "card_expiration_year" => "30", 
        "card_holder_name" => "Barb",
        "security_code" => "123",
        "card_holder_identification" => array(
	        "type" => "dni",
	        "number" => "29123456"
        ),
      ),
      "aggregate_data" => array(
	"name" => ""
      ),
    );

try {
	$response = $connector->payment()->ExecutePayment($data);
	$response->getId();
	$response->getToken();
	$response->getUser_id();
	$response->getPayment_method_id();
	$response->getBin();
	$response->getAmount();
	$response->getCurrency();
	$response->getInstallments();
	$response->getPayment_type();
	$response->getDate_due();
	$response->getSub_payments();
	$response->getStatus();
	$response->getStatus_details()->ticket
	$response->getStatus_details()->card_authorization_code
	$response->getStatus_details()->address_validation_code
	$response->getStatus_details()->error
	$response->getDate();
	$response->getEstablishment_name();
	$response->getFraud_detection();
	$response->getAggregate_data();
	$response->getSite_id();
} catch( \Exception $e ) {
	var_dump($e->getData());
}

Ejecución del pago PCI Tokenizado

$connector = new \Decidir\Connector($keys_data, $ambient, "", "", "SDK-PHP");

$data = array(
    "site_transaction_id" => "tokeniz" . rand(),
    "establishment_name" => "Store",
    "spv" => null,
    "bin" => "4507990",
    "payment_method_id" => 1,
    "amount" => 50000,
    "currency" => "ARS",
    "installments" => 1,
    "description" => "PCI pago tokenizado",
    "payment_type" => "single",
    "sub_payments" => [],
    "fraud_detection" => array(
        "send_to_cs" => false
    ),
    "card_data" => array(
        "card_holder_name" => "Luis Perez",
        "last_four_digits" => "1112",
        "card_holder_birthday" => "01012000",
        "card_holder_door_number" => 666,
        "card_holder_identification" => array(
            "type" => "dni",
            "number" => "41371431"
        ),
        "security_code" => "666",
        "card_expiration_month" => "03",
        "card_expiration_year" => "30"
    ),
    "cardholder_auth_required" => false,
    "is_tokenized_payment" => true,
    "token_card_data" => array(
        "token" => "4507990000004905",
        "eci" => "05",
        "cryptogram" => "cryptogram_123467890"
    ),
    "aggregate_data" => array(
        "indicator" => "1",
        "identification_number" => "30598910045",
        "bill_to_pay" => "Decidir_Test",
        "bill_to_refund" => "Decidir_Test",
        "merchant_name" => "DECIDIR",
        "street" => "Lavarden",
        "number" => "247",
        "postal_code" => "C1437FBE",
        "category" => "05044",
        "channel" => "005",
        "geographic_code" => "C1437",
        "city" => "Ciudad de Buenos Aires",
        "merchant_id" => "decidir_Agregador",
        "province" => "Buenos Aires",
        "country" => "Argentina",
        "merchant_email" => "qa@decidir.com",
        "merchant_phone" => "+541135211111"
    )
);

try {
	$response = $connector->payment()->ExecutePayment($data);
} catch( \Exception $e ) {
	var_dump($e->getData());
}

Ejecución de pago simple con 3ds

En este caso se necesita agregar el flag "cardholder_auth_required" en true y se le debe pasar el objeto "auth_3ds_data".

$connector = new \Decidir\Connector($keys_data, $ambient, "", "", "SDK-PHP");

$data = array(
    "site_transaction_id" => "{{site_transaction_id}}",
    "token" => "{{token}}",
    "payment_method_id" => 1,
    "bin" => 450799,
    "amount" => 100,
    "currency" => "ARS",
    "installments" => 1,
    "payment_type" => "single",
    "sub_payments" => [],
    "cardholder_auth_required" => true,
    "auth_3ds_data" => array(
        "device_type" => "BROWSER",
        "accept_header" => "application/json",
        "user_agent" => "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0)Gecko/20100101",
        "ip" => "1.12.123.255",
        "java_enabled" => true,
        "language" => "es",
        "color_depth" => "32",
        "screen_height" => 28,
        "screen_width" => 4,
        "time_zone_offset" => 570
    )
);

try {
	$response = $connector->payment()->ExecutePayment($data);
} catch( \Exception $e ) {
	var_dump($e->getData());
}

Ejecución de instruction 3ds

Se agrega el objeto con los atributos id e instruction_value.

$data = array(
    "id" => "{{id}}",
    "instruction_value" => "{{instruction_value}}",
);
$connector = new \Decidir\Connector($keys_data, $ambient, "", "", "SDK-PHP");

try{
	$response = $connector->threedsChallenge()->threedsChallenge($data);
} catch( \Exception $e ) {
	var_dump($e->getData());
}

Captura del Pago

Para el caso de la operatoria de transacción en dos pasos, la captura o confirmación del pago puede realizarse de la siguiente manera.

Aclaracion : amount es un campo Long, los ultimos dos numeros se considerarán como decimales.

Campo	Descripcion	Oblig	Restricciones	Ejemplo
amount	importe del pago	SI	Importe Maximo = 9223372036854775807 ($92233720368547758.07)	amount=20000

Ejemplo

$connector = new \Decidir\Connector($keys_data, $ambient);

$data = array(
      "amount" => 500,
    );

try {
	$response = $connector->payment()->CapturePayment($data);
} catch( \Exception $e ) {
	var_dump($e->getData());
}

_{Volver a inicio}

Ejecución de pago offline

Una vez generado y almacenado el token de Pago Offline, se deberá ejecutar la solicitud de pago utilizando el token previamente generado. Además del token de pago y los parámetros propios de la transacción, el comercio deberá identificar la compra con el site_transaction_id.

Aclaracion : amount es un campo Long, los ultimos dos numeros se considerarán como decimales.

Pago Facil

Campo	Descripcion	Oblig	Restricciones	Ejemplo
site_transaction_id	Identificador único para la operación	SI	8 dígitos	site_transaction_id: "170518_35"
token	Token generado en el primer paso	SI	36 dígitos,variable	token: "03508514-1578-4140-ba02-6bdd65e2af95"
payment_method_id	id del tipo de metodo de Pago Offline	SI	Dos dígitos	payment_method_id: "26"
amount	Monto de la operación. 8 números enteros	SI	8 dígitos,variable	amount: "1100"
currency	Son los días que existen entre el 1er y 2do vencimiento	SI	3 letras	currency: "ARS"
payment_type	Tipo de pago	SI	Letras	payment_type: "single"
email	email del usuario que esta haciendo uso del sitio	Condicional	Sin validacion	email: "user@mail.com",
invoice_expiration	Fecha en que vence el cupón	SI	Formato AAMMDD	invoice_expiration: "191123"
cod_p3	Son los dias que existen entre el 1º y 2º vencimiento de la factura.	SI	2,fijo ("00" si la factura tiene no tiene 2° vencimientos)	invoice_expiration: "191123"
cod_p4	Días después del 1º vencimiento y hasta que el cliente pueda abonar	SI	3,fijo	cod_p4: "123"
client	Codigo Cliente	SI	8,fijo	client: "12345678"
surcharge	Recargo por vencimiento del plazo	SI	7,variable (5 digitos enteros y 2 decimales)	surcharge: "10.01"
payment_mode	Tipo de metodo de pago	SI	Strin "offline"	payment_mode: "offline"

Ejemplo

$data = array(
  "site_transaction_id" => "230518_41",
  "token" => "92a95793-3321-447c-8795-8aeb8a8ac067",
  "payment_method_id" => 25,
  "amount" => 1000,
  "currency" => "ARS",
  "payment_type" => "single",
  "email" => "user@mail.com",
  "invoice_expiration" => "191123",
  "cod_p3" => "12",
  "cod_p4" => "134",
  "client" => "12345678",
  "surcharge" => 10.01,
  "payment_mode" => "offline"
);

$response = $connector->payment()->ExecutePaymentOffline($data);

_{Volver a inicio}

Rapipago

Campo	Descripcion	Oblig	Restricciones	Ejemplo
site_transaction_id	Identificador único para la operación	SI	8 dígitos	site_transaction_id: "170518_35"
token	Token generado en el primer paso	SI	36 dígitos,variable	token: "03508514-1578-4140-ba02-6bdd65e2af95"
payment_method_id	id del tipo de metodo de Pago Offline	SI	Dos dígitos	payment_method_id: "26"
amount	Monto de la operación. 8 números enteros	SI	8 dígitos,variable	amount: "1100"
currency	Son los días que existen entre el 1er y 2do vencimiento	SI	3 letras	currency: "ARS"
payment_type	Tipo de pago	SI	Letras	payment_type: "single"
email	email del usuario que esta haciendo uso del sitio	Condicional	Sin validacion	email: "user@mail.com",
invoice_expiration	Fecha en que vence el cupón	SI	Formato AAMMDD	invoice_expiration: "191123"
cod_p3	Son los dias que existen entre el 1º y 2º vencimiento de la factura.	SI	2,fijo ("00" si la factura tiene no tiene 2° vencimientos)	invoice_expiration: "191123"
cod_p4	Días después del 1º vencimiento y hasta que el cliente pueda abonar	SI	3,fijo	cod_p4: "123"
client	Codigo Cliente	SI	8,fijo	client: "12345678"
surcharge	Recargo por vencimiento del plazo	SI	7,variable (5 digitos enteros y 2 decimales)	surcharge: "10.01"
payment_mode	Tipo de metodo de pago	SI	Strin "offline"	payment_mode: "offline"

Ejemplo

$data = array(
  "site_transaction_id" => "230518_38",
  "token" => "8e190c82-6a63-467e-8a09-9e8fa2ab6215",
  "payment_method_id" => 26,
  "amount" => 1000,
  "currency" => "ARS",
  "payment_type" => "single",
  "email" => "user@mail.com",
  "invoice_expiration" => "191123",
  "cod_p3" => "12",
  "cod_p4" => "134",
  "client" => "12345678",
  "surcharge" => 10.01,
  "payment_mode" => "offline"
);

$response = $connector->payment()->ExecutePaymentOffline($data);

Pago mis Cuentas

Campo	Descripcion	Oblig	Restricciones	Ejemplo
site_transaction_id	Identificador único para la operación	SI	8 dígitos	site_transaction_id: "170518_35"
token	Token generado en el primer paso	SI	36 dígitos,variable	token: "03508514-1578-4140-ba02-6bdd65e2af95"
payment_method_id	id del tipo de metodo de Pago Offline	SI	Dos dígitos	payment_method_id: "26"
amount	Monto de la operación. 8 números enteros	SI	8 dígitos,variable	amount: "1100"
currency	Son los días que existen entre el 1er y 2do vencimiento	SI	3 letras	currency: "ARS"
payment_type	Tipo de pago	SI	Letras	payment_type: "single"
email	email del usuario que esta haciendo uso del sitio	Condicional	Sin validacion	email: "user@mail.com",
invoice_expiration	Fecha en que vence el cupón	SI	Formato AAMMDD	invoice_expiration: "191123"
bank_id	Id de banco de la operacion	SI	String "offline"	bank_id: 1 (refencia)

Ejemplo

$data = array(
  "site_transaction_id" => "220518_39",
  "token" => "9ae1d130-8c89-4c3b-a267-0e97b88fedd0",
  "payment_method_id" => 41,
  "amount" => 1000,
  "currency" => "ARS",
  "payment_type" => "single",
  "email" => "user@mail.com",
  "bank_id" => 1,
  "sub_payments" => 100,
  "invoice_expiration" => "191123"
);

$response = $connector->payment()->ExecutePaymentOffline($data);

_{Volver a inicio}

Cobro Express

Campo	Descripcion	Oblig	Restricciones	Ejemplo
site_transaction_id	Identificador único para la operación	SI	8 dígitos	site_transaction_id: "170518_35"
token	Token generado en el primer paso	SI	36 dígitos,variable	token: "03508514-1578-4140-ba02-6bdd65e2af95"
payment_method_id	id del tipo de metodo de Pago Offline	SI	Dos dígitos	payment_method_id: "26"
amount	Monto de la operación. 8 números enteros	SI	8 dígitos,variable	amount: "1100"
currency	Son los días que existen entre el 1er y 2do vencimiento	SI	3 letras	currency: "ARS"
payment_type	Tipo de pago	SI	Letras	payment_type: "single"
email	email del usuario que esta haciendo uso del sitio	Condicional	Sin validacion	email: "user@mail.com",
invoice_expiration	Fecha en que vence el cupón	SI	Formato AAMMDD	invoice_expiration: "191123"
second_invoice_expiration	Segunda fecha de vencimiento del cupón	SI	Formato AAMMDD	second_invoice_expiration: "191123"
cod_p3	Son los dias que existen entre el 1º y 2º vencimiento de la factura.	SI	2,fijo ("00" si la factura tiene no tiene 2° vencimientos)	invoice_expiration: "191123"
client	Codigo Cliente	SI	8,fijo	client: "12345678"
surcharge	Recargo por vencimiento del plazo	SI	7,variable (5 digitos enteros y 2 decimales)	surcharge: "10.01"
payment_mode	Tipo de metodo de pago	SI	Strin "offline"	payment_mode: "offline"

Ejemplo

$data = array(
  "site_transaction_id" => "160518_42",
  "token" => "3df26771-67ab-4a8e-91e2-f1e0b0c559f7",
  "payment_method_id" => 51,
  "amount" => 1000,
  "currency" => "ARS",
  "payment_type" => "single",
  "email" => "user@mail.com",
  "invoice_expiration" => "191123",
  "second_invoice_expiration" => "191123",
  "cod_p3" => "1",
  "cod_p4" => "134",
  "client" => "12345678",
  "surcharge" => 10.01,
  "payment_mode" => "offline"
);

$response = $connector->payment()->ExecutePaymentOffline($data);

_{Volver a inicio}

Cobro Express

Campo	Descripcion	Oblig	Restricciones	Ejemplo
site_transaction_id	Identificador único para la operación	SI	8 dígitos	site_transaction_id: "170518_35"
token	Token generado en el primer paso	SI	36 dígitos,variable	token: "03508514-1578-4140-ba02-6bdd65e2af95"
payment_method_id	id del tipo de metodo de Pago Offline	SI	Dos dígitos	payment_method_id: "26"
amount	Monto de la operación. 8 números enteros	SI	8 dígitos,variable	amount: "1100"
currency	Son los días que existen entre el 1er y 2do vencimiento	SI	3 letras	currency: "ARS"
payment_type	Tipo de pago	SI	Letras	payment_type: "single"
email	email del usuario que esta haciendo uso del sitio	Condicional	Sin validacion	email: "user@mail.com",
invoice_expiration	Fecha en que vence el cupón	SI	Formato AAMMDD	invoice_expiration: "191123"
second_invoice_expiration	Segunda fecha de vencimiento del cupón	SI	Formato AAMMDD	second_invoice_expiration: "191123"
cod_p3	Son los dias que existen entre el 1º y 2º vencimiento de la factura.	SI	2,fijo ("00" si la factura tiene no tiene 2° vencimientos)	invoice_expiration: "191123"
cod_p4	Días después del 1º vencimiento y hasta que el cliente pueda abonar	SI	3,fijo	cod_p4: "123"
client	Codigo Cliente	SI	8,fijo	client: "12345678"
surcharge	Recargo por vencimiento del plazo	SI	7,variable (5 digitos enteros y 2 decimales)	surcharge: "10.01"
payment_mode	Tipo de metodo de pago	SI	Strin "offline"	payment_mode: "offline"

Ejemplo

$data = array(
  "site_transaction_id" => "160518_42",
  "token" => "3df26771-67ab-4a8e-91e2-f1e0b0c559f7",
  "payment_method_id" => 51,
  "amount" => 1000,
  "currency" => "ARS",
  "payment_type" => "single",
  "email" => "user@mail.com",
  "invoice_expiration" => "191123",
  "second_invoice_expiration" => "191123",
  "cod_p3" => "1",
  "cod_p4" => "134",
  "client" => "12345678",
  "surcharge" => 10.01,
  "payment_mode" => "offline"
);

$response = $connector->payment()->ExecutePaymentOffline($data);

_{Volver a inicio}

Formulario de Pago

Este servicio permite integrar en el comercio un formulario de pago. Utiliza el recurso "validate" para obtener un hash a partir de los datos de la operacion, luego este hash sera utilizado al momento de llamar al recurso "form" el cual devolvera el formulario renderizado propio para cada comercio listo para ser utilizado y completar el flujo de pago.

Campo	Descripcion	Oblig	Restricciones	Ejemplo
site.id	Merchant	Condicional	Numérico de 20 digitos	id: "12365436"
site.template.id	Id de formulario de pago, el id es unico para cada comercio y es generado previamente por Decidir	SI	Numérico de 20 digitos
site.transaction_id	Numero de operación	SI	Alfanumérico de 40 digitos
customer.id	d que identifica al usuario	NO	Alfanumérico de 40 digitos
customer.email	Email del cliente. Se envía información del pago	Es requerido si se desea realizar el envío de mails	Alfanumérico de 40 digitos	email:"user@mail.com"
payment.amount	Monto de la compra	SI	Numérico
payment.currency	Tipo de moneda	NO	Letras
payment.payment_method_id	Id del medio de pago	SI	Númerico
payment.bin	Primeros 6 dígitos de la tarjeta	NO	Númerico
payment.installments	Cantidad de cuotas	SI	Númerico
payment.payment_type	Indica si es simple o distribuida	SI	Valores posibles: "single", "distributed"
payment.sub_payments	Se utiliza para pagos distribuidos. Informa los subpayments	Es requerido si el
pago es distribuido por monto, ya que si es por porcentaje toma los configurados desde Adm Sites (SAC)	NA
success_url	Url a donde se rediccionará una vez que el usuario finalice la operación desde la página de feedback	SI	Númerico
cancel_url	Url donde se rediccionará si el cliente quiere cancelar el formulario	SI	NA
redirect_url	Url en la cual se enviaran los datos de la operación una vez finalizada la misma para que el comercio pueda capturarlos y mostrarlos como lo desee	Es requerido en los casos donde no informe el campo "success_url"	NA

Ejemplo

//Para este servicio es necesario enviar junto al public y private key el "form_apikey" y "form_site".
$keys_data = array(
              'form_apikey' => '5cde7e72ea1e430db94d4312346a3744 ',
              'form_site' => '00021625'
          );

$connector = new \Decidir\Connector($keys_data, $ambient);

$data = array(
  "site" => array(
        "id" => "03101980", //opcional, si no se tiene Merchant no se envía este atributo
        "transaction_id" => "Swatch op",
        "template" => array(
            "id" => 5 
        ),
  ),
  "customer" => array(
        "id" => "001",
        "email" => "user@mail.com",
  ),
  "payment" => array(
        "amount" => 1203,
        "currency" => "ARS",
        "payment_method_id" => 1,
        "bin" => "45979",
        "installments" => 4,
        "payment_type" => "single",
        "sub_payments" => array()
  ),
  "success_url" => "https://shop.swatch.com/es_ar/", //si no se informa el "redirect_url" es requerido
  "cancel_url" => "https://swatch.com/api/result",
  "redirect_url" => "", //si no se informa el "success_url" es requerido
  "fraud_detection" => array() //si no esta activado cybersource no enviar este atributo
);

$response = $connector->payment()->Validate($data);

Respuesta servicio validate

$response = $connector->payment()->Validate($data);

$response->getHash(); //respuesta: 46711cd8-81f8-4228-96cc-ac3e90c75622"

Formulario renderizado

Al obtener el hash se puede generar el formulario a partir de la url: https://api.decidir.com/web/form?hash=46711cd8-81f8-4228-96cc-ac3e90c75622.

_{Volver a inicio}

Listado de Pagos

Mediante este recurso, se genera una solicitud de listado de pagos. Este recurso admite la posibilidad de agregar los filtros adicionales:

(opcional) offset: desplazamiento en los resultados devueltos. Valor por defecto = 0.
(opcional) pageSize: cantidad máxima de resultados retornados. Valor por defecto = 50.
(opcional) siteOperationId: ID único de la transacción a nivel comercio (equivalente al site_transaction_id).
(opcional) merchantId: ID Site del comercio.

$connector = new \Decidir\Connector($keys_data, $ambient);

$data = array("pageSize" => 5);
$response = $connector->payment()->PaymentList($data);
$response->getLimit();
$response->getOffset();
$response->getResults();
$response->getHas_more();

_{Volver a inicio}

Información de un Pago

Mediante este recurso, se genera una solicitud de información de un pago previamente realizado, pasando como parámetro el id del pago.

$connector = new \Decidir\Connector($keys_data, $ambient);

$data = array();

$response = $connector->payment()->PaymentInfo($data, '574421');
$response->getId();
$response->getSiteTransaction_id();
$response->getToken();
$response->getUser_id();
$response->getPayment_method_id();
$response->getCard_brand();
$response->getBin();
$response->getAmount();
$response->getCurrency();
$response->getInstallments();
$response->getPayment_type();
$response->getSub_payments();
$response->getStatus();
$response->getStatus_details();
$response->getDate();
$response->getEstablishment_name();
$response->getFraud_detection();
$response->getAggregate_data();
$response->getSite_id();

Información adicional de tarjeta

Agregando la opcion "card_data" se puede obtener información adicional de la tarjera utilizada para el pago.

$data = array();
$query = array("expand"=>"card_data");

$response = $connector->payment()->PaymentInfo($data, '873836', $query);
$response->getCard_data()

Respuesta

Array (
	[card_number] => 450799XXXXXX4905
	[card_holder] => Array (
		[identification] => Array (
		[type] => dni
		[number] => 27859328
	)
	[name] => Tarjeta Visa
	)
)

_{Volver a inicio}

Anulación / Devolución Total de Pago

Mediante este recurso, se genera una solicitud de anulación / devolución total de un pago puntual, pasando como parámetro el id del pago.

$data = array();
$response = $connector->payment()->Refund($data, '574671'); //574671 es el id de la operacion de compra
$response->getId();
$response->getAmount();
$response->getSub_payments();
$response->getStatus();

_{Volver a inicio}

Anulación de Devolución Total

Mediante este recurso, se genera una solicitud de anulación de devolución total de un pago puntual, pasando como parámetro el id del pago y el id de la devolución.

$data = array();
$response = $connector->payment()->deleteRefund($data, '574671', '164'); //574671 id de la operacion de compra, 164 id de la devolucion
$response->getResponse();
$response->getStatus();

_{Volver a inicio}

Devolución Parcial de un Pago

Mediante este recurso, se genera una solicitud de devolución parcial de un pago puntual, pasando como parámetro el id del pago y el monto de la devolución.

Campo	Descripcion	Oblig	Restricciones	Ejemplo
amount	importe del pago a devolver	NO	Antes del cierre, si se completa el campo por un monto menor al de la compra se toma como devolucion parcial; si se ingresa el monto total o no se envia dicho campo se toma como anulacion.	1000

$data = array(
	"amount" => 100
	);
$response = $connector->payment()->partialRefund($data,'574673'); //574671 id de la operacion de compra
$response->getId();
$response->getAmount();
$response->getSub_payments();
$response->getStatus();

_{Volver a inicio}

Anulación de Devolución Parcial

Mediante este recurso, se genera una solicitud de anulación de devolución parcial de un pago puntual, pasando como parámetro el id del pago y el id de la devolución.

$data = array();
$response = $connector->payment()->deleteRefund($data, '574671', '164'); //574671 id de la operacion de compra, 164 id de la devolucion parcial
$response->getResponse());
$response->getStatus());

Tokenizacion de tarjetas de crédito

Esta funcionalidad permite que luego de realizar una compra con una tarjeta, se genere un token alfanumerico unico en el backend de Decidir, esto permite que a la hora de comprar nuevamente con esta tarjeta solo requerira el token de la tarjeta y el codigo de seguridad. Como primer paso se debe realizar una un pago normal, el token generado estara en el campo "token" de la respuesta.

Listado de tarjetas tokenizadas

Este metodo permite conocer el listado de tarjetas tokenizadas que posee un usuario determinado. Esto requerira el nombre de usuario (user_id) al momento de llamar al metodo tokensList.

$data = array();
$response = $connector->token()->tokensList($data, 'prueba'); //prueba, es el usuario dueño de la tarjeta de credito
var_dump($response);
var_dump($response->getTokens());

_{Volver a inicio}

Ejecucion de pago tokenizado

Una vez que se obtiene el token a partir de la tarjeta tokenizada, se deberá ejecutar la solicitud de pago. Además del token de pago y los parámetros propios de la transacción, el comercio deberá identificar la compra con el "site_transaction_id" y "user_id".

$connector = new \Decidir\Connector($keys_data, $ambient);

$data = array(
      "site_transaction_id" => "12042017_20",
      "token" => "be211413-757b-487e-bb0c-283d21c0fb6f",
      "user_id" => "pepe",
      "payment_method_id" => 1,
      "bin" => "450799",
      "amount" => 1000,
      "currency" => "ARS",
      "installments" => 1,
      "description" => "",
      "payment_type" => "single",
      "sub_payments" => array()
    );

$response = $connector->payment()->ExecutePayment($data);
$response->getId();
$response->getToken();
$response->getUser_id();
$response->getPayment_method_id();
$response->getBin();
$response->getAmount();
$response->getCurrency();
$response->getInstallments();
$response->getPayment_type();
$response->getDate_due();
$response->getSub_payments();
$response->getStatus();
$response->getStatus_details();
$response->getDate();
$response->getEstablishment_name();
$response->getFraud_detection();
$response->getAggregate_data();
$response->getSite_id();

_{Volver a inicio}

Eliminacion de tarjeta tokenizada

El servicio da la posibilidad de eliminar un token de tarjeta generada, esto se logra instanciando token y utilizando el metodo tokenDelete() y enviando la tarjeta tokenizada.

$data = array();
$response = $connector->token()->tokenDelete($data, 'af49025a-f1b7-4363-a1cb-1ed38c3d4d75');

_{Volver a inicio}

Integración con Cybersource

Para utilizar el Servicio de Control de Fraude Cybersource, en la ejecución del pago, deben enviarse datos adicionales sobre la operación de compra que se quiere realizar. Se han definido cinco verticales de negocio que requieren parámetros específicos, así como también parámetros comunes a todas las verticales.

Volver al inicio

Retail

Los siguientes parámetros se deben enviar específicamente para la vertical Retail. Además se deben enviar datos específicos de cada producto involucrado en la transacción.

Descripcion (Data set)	API Fields	Required/Optional	Data Type	Origen del dato	Campo referente en ApiRest	Comentarios
fraud_detection	send_to_cs(Boolean)	Required	Boolean	MDD40 - Fraud Update	"send_to_cs": true/false
fraud_detection	Channel(String)	Required	String	MDD6 - Sales Channel	"channel": "Web"
fraud_detection	device_unique_id(String)	Required	String	Unique identifier for the device	"device_unique_id": "1234-1234"
billTo	city(string)	Required	String (50)	Payments	"city": "Buenos Aires","	Ciudad / Debe comenzar con una letra
billTo	country(string)	Required	String (2)	Payments	"country": "AR","	Código ISO
billTo	customerID(string)	Required	String (50)	Payments	"customer_id": "leilaid","	Identificador del usuario unico logueado al portal (No puede ser una direccion de email)
billTo	email(string)	Required	String (100)	Payments	"email": "accept@decidir.com.ar","	correo electronico del comprador
billTo	firstName(string)	Required	String (60)	Payments	"first_name": "leila","	Nombre del tarjeta habiente / Sin caracteres especiales como acentos invertidos, sólo letras, números y espacios
billTo	lastName(string)	Required	String (60)	Payments	"last_name": "leila","	Apellido del tarjetahabiente / Sin caracteres especiales como acentos invertidos, sólo letras, números y espacios
billTo	phoneNumber(string)	Required	String (15)	Payments	"phone_number": "1548866329","	Número de telefono
billTo	postalCode(string)	Required	String (10)	Payments	"postal_code": "1427","	Codigo Postal
billTo	state(string)	Required	String (2)	Payments	"state": "BA","	Estado (Si el country = US, el campo se valida para un estado valido en USA)
billTo	street1(string)	Required	String (60)	Payments	"street1": "LAVALLE 4041","	Calle Numero interior Numero Exterior
billTo	street2(string)	Optional	String (60)	Payments	"street2": "LAVALLE 4041","	Barrio
shipTo	city(string)	Required	String (50)	Payments	"city": "Buenos Aires","	Ciudad / Debe comenzar con una letra
shipTo	country(string)	Required	String (2)	Payments	"country": "AR","	[Código ISO] (http://apps.cybersource.com/library/documentation/sbc/quickref/countries_alpha_list.pdf )
shipTo	email(string)	Required	String (100)	Payments	"email": "accept@decidir.com.ar","	correo electronico del comprador
shipTo	firstName(string)	Required	String (60)	Payments	"first_name": "leila","	Nombre del tarjeta habiente / Sin caracteres especiales como acentos invertidos, sólo letras, números y espacios
shipTo	lastName(string)	Required	String (60)	Payments	"last_name": "sosa","	Apellido del tarjetahabiente / Sin caracteres especiales como acentos invertidos, sólo letras, números y espacios
shipTo	phoneNumber(string)	Required	String (15)	Payments	"phone_number": "1549066329","	Número de telefono
shipTo	postalCode(string)	Required	String (10)	Payments	"postal_code": "1427","	Codigo Postal
shipTo	state(string)	Required	String (2)	Payments	"state": "BA","	Estado (Si el country = US, el campo se valida para un estado valido en USA)
shipTo	street1(string)	Required	String (60)	Payments	"street1": "LAVALLE 4041"	Calle Numero interior Numero Exterior / Para los casos que no son de envío a domicilio, jamás enviar la dirección propia del comercio o correo donde se retire la mercadería, en ese caso replicar los datos de facturación.
shipTo	street2(string)	Optional	String (60)	Payments	"street2": "LAVALLE 4041"	Barrio
purchaseTotals	currency(string)	Required	String (5)	Payments	"currency": "ARS"	http://apps.cybersource.com/library/documentation/sbc/quickref/currencies.pdf
purchaseTotals	grandTotalAmount(amount)	Required	Long (15)	Payments	"amount": 2000	"Cantidad total de la transaccion./"999999CC" sin decimales"
customer_in_site (General for all Verticals)	MDD7- Fecha Registro Comprador (num Dias)	Optional	String (255)	Payments	"days_in_site": 243,"	Numero de dias que tiene registrado un cliente en el portal del comercio.
customer_in_site (General for all Verticals)	MDD8- Usuario Guest? (S/N)	Optional	String (255)	Payments	"is_guest": false,"	Valor Boleano para indicar si el usuario esta comprando como invitado en la pagina del comercio. Valores posibles (S/N)
customer_in_site (General for all Verticals)	MDD9- Customer password Hash	Optional	String (255)	Payments	"password": "abracadabra","	Valor del password del usuario registrado en el portal del comercio. Incluir el valor en hash
customer_in_site (General for all Verticals)	MDD10- Historico de compras del comprador (Num transacciones)	Optional	String (255)	Payments	"num_of_transactions": 1,"	Conteo de transacciones realizadas por el mismo usuario registrado en el portal del comercio
customer_in_site (General for all Verticals)	MDD11- Customer Cell Phone	Optional	String (255)	Payments	"cellphone_number": "12121"	Incluir numero de telefono adicional del comprador
customer_in_site (General for all Verticals)	MDD39 - Visa Validation	Optional	String (255)	Payments	"street": "Av. Corrientes 1234"	Incluir Domicilio de cliente
campos Adicionales Vertical Retail	MDD12- Shipping DeadLine (Num Dias)	Optional	String (255)	Payments	"days_to_delivery": "55","	Numero de dias que tiene el comercio para hacer la entrega
campos Adicionales Vertical Retail	MDD13- Metodo de Despacho	Optional (Catalogo)	String (255)	Payments	"dispatch_method": "storepickup","	Valores ejemplo: (domicilio, click and collect, carrier) Es recomendable que el API de decidir fije opciones seleccionables y no sean de captura libre para el comercio.
campos Adicionales Vertical Retail	MDD14- Customer requires Tax Bill ?	Optional	String (255)	Payments	"tax_voucher_required": true,"	Valor booleano para identificar si el cliente requiere un comprobante fiscal o no S / N
campos Adicionales Vertical Retail	MDD15- Customer Loyality Number	Optional	String (255)	Payments	"customer_loyality_number": "123232","	Incluir numero de cliente frecuente
campos Adicionales Vertical Retail	MDD16- Promotional / Coupon Code	Optional	String (255)	Payments	"coupon_code": "cupon22","	Incluir numero de cupon de descuento
item	productCode(string)	Conditional	String (255)	Payments	"code": "popblacksabbat2016","	adult_content , coupon, gift_certificate , handling_only , shipping_and_handling , shipping_only, electronics, Apparel, Housewares, Sports, Toys, Books, Music, Video, Drugs/HBA
item	productDescription(string)	Conditional	String (255)	Payments	"description": "Popular Black Sabbath 2016","	Descripcion general del producto
item	productName(string)	Conditional	String (255)	Payments	"name": "popblacksabbat2016ss","	Nombre en catalogo del producto
item	productSKU(string)	Conditional	String (255)	Payments	"sku": "asas","	SKU en catalogo
item	quantity(integer)	Conditional	Integer (10)	Payments	"total_amount": 20,"	Cantidad productos del mismo tipo agregados al carrito
item	totalAmount(amount)	Conditional		Payments	"quantity": 1,"	"Precio total = Precio unitario * quantity / CSITTOTALAMOUNT = CSITUNITPRICE * CSITQUANTITY "999999.CC" Es mandatorio informar los decimales, usando el punto como separador de decimales. No se permiten comas, ni como separador de miles ni como separador de decimales."
item	unitPrice(amount)	Conditional	String (15)	Payments	"unit_price": 20"	"Precio Unitaro del producto / "999999.CC" Es mandatorio informar los decimales, usando el punto como separador de decimales. No se permiten comas, ni como separador de miles ni como separador de decimales."

Ejemplo

  $csmdd = array(
            array(
                "csmdd17" => "17"
            ),
            array(
                "csmdd18" => "18"
            ),
            array(
                "csmdd19" => "19.999"
            )
        );
  $cs_data = array(
        "send_to_cs" => true,
        "channel" => "Web",
        "device_unique_id" => "1234-1234",
        "bill_to" => array(
          "city" => "Buenos Aires",
          "country" => "AR",
          "customer_id" => "martinid",
          "email" => "accept@decidir.com.ar",
          "first_name" => "martin",
          "last_name" => "perez",
          "phone_number" => "1547766111",
          "postal_code" => "1768",
          "state" => "BA",
          "street1" => "GARCIA DEL RIO 3333",
          "street2" => "GARCIA DEL RIO 3333",
        ),
        "ship_to" => array(
          "city" => "Buenos Aires",
          "country" => "AR",
          "customer_id" => "martinid",
          "email" => "accept@decidir.com.ar",
          "first_name" => "martin",
          "last_name" => "perez",
          "phone_number" => "1547766111",
          "postal_code" => "1768",
          "state" => "BA",
          "street1" => "GARCIA DEL RIO 3333",
          "street2" => "GARCIA DEL RIO 3333",
        ),
        "currency" => "ARS",
        "amount" => 1200,
        "days_in_site" => 243,
        "is_guest" => false,
        "password" => "password",
        "num_of_transactions" => 1,
        "cellphone_number" => "12121",
        "date_of_birth" => "129412",
        "street" => "RIO 4041",
        "days_to_delivery" => "55",
        "dispatch_method" => "storepickup",
        "tax_voucher_required" => true,
        "customer_loyality_number" => "123232",
        "coupon_code" => "cupon22",
        "csmdds" => $csmdd
      );

  //Datos de productos, array con los diferentes productos involucrados.
  $cs_products = array(
        array(
          "csitproductcode" => "electronic_product", //Código de producto. MANDATORIO.
          "csitproductdescription" => "NOTEBOOK L845 SP4304LA DF TOSHIBA", //Descripción del producto. MANDATORIO.
          "csitproductname" => "NOTEBOOK L845 SP4304LA DF TOSHIBA",  //Nombre del producto. MANDATORIO.
          "csitproductsku" => "LEVJNSL36GN", //Código identificador del producto. MANDATORIO.
          "csittotalamount" => 600, 
          "csitquantity" => 1,//Cantidad del producto. MANDATORIO.
          "csitunitprice" => 600 //Formato Idem CSITTOTALAMOUNT. MANDATORIO 
          ),
        array(
          "csitproductcode" => "default", //Código de producto. MANDATORIO.
          "csitproductdescription" => "PENDRIVE 2GB KINGSTON", //Descripción del producto. MANDATORIO.
          "csitproductname" => "PENDRIVE 2GB", //Nombre del producto. MANDATORIO.
          "csitproductsku" => "KSPDRV2g", //Código identificador del producto. MANDATORIO.
          "csittotalamount" => 600, //MANDATORIO
          "csitquantity" => 1, //Cantidad del producto. MANDATORIO.
          "csitunitprice" => 600 //Formato Idem CSITTOTALAMOUNT. MANDATORIO 
        )
      );

Para incorporar estos datos en el requerimiento inicial, se debe instanciar un objeto de la clase Decidir\Data\Cybersource\Retail de la siguiente manera.

$cybersource = new Decidir\Cybersource\Retail(
                    $datos_cs,  // Datos de la operación
                    $cs_productos, // Datos de los productos
  );

$connector->payment()->setCybersource($cybersource->getData());

$data = array(
      "site_transaction_id" => "12042017_20",
      "token" => "be211413-757b-487e-bb0c-283d21c0fb6f",
      "user_id" => "usuario",
      "payment_method_id" => 1,
      "bin" => "450799",
      "amount" => 1200,
      "currency" => "ARS",
      "installments" => 1,
      "description" => "",
      "payment_type" => "single",
      "sub_payments" => array()
    );

    $response = $connector->payment()->ExecutePayment($data);

Volver al inicio

Ticketing

Los siguientes parámetros se deben enviar específicamente para la vertical Ticketing. Además se deben enviar datos específicos de cada producto involucrado en la transacción.

Descripcion (Data set)	API Fields	Required/Optional	Data Type	Origen del dato	Campo referente en ApiRest	Comentarios
fraud_detection	send_to_cs(Boolean)	Required	Boolean	MDD40 - Fraud Update	"send_to_cs": true/false
fraud_detection	Channel(String)	Required	String	MDD6 - Sales Channel	"channel": "Web"
fraud_detection	device_unique_id(String)	Required	String	Unique identifier for the device	"device_unique_id": "1234-1234"
billTo	city(string)	Required	String (50)	Payments	"city": "Buenos Aires","	Ciudad / Debe comenzar con una letra
billTo	country(string)	Required	String (2)	Payments	"country": "AR","	Código ISO
billTo	customerID(string)	Required	String (50)	Payments	"customer_id": "leilaid","	Identificador del usuario unico logueado al portal (No puede ser una direccion de email)
billTo	email(string)	Required	String (100)	Payments	"email": "accept@decidir.com.ar","	correo electronico del comprador
billTo	firstName(string)	Required	String (60)	Payments	"first_name": "leila","	Nombre del tarjeta habiente / Sin caracteres especiales como acentos invertidos, sólo letras, números y espacios
billTo	lastName(string)	Required	String (60)	Payments	"last_name": "leila","	Apellido del tarjetahabiente / Sin caracteres especiales como acentos invertidos, sólo letras, números y espacios
billTo	phoneNumber(string)	Required	String (15)	Payments	"phone_number": "1548866329","	Número de telefono
billTo	postalCode(string)	Required	String (10)	Payments	"postal_code": "1427","	Codigo Postal
billTo	state(string)	Required	String (2)	Payments	"state": "BA","	Estado (Si el country = US, el campo se valida para un estado valido en USA)
billTo	street1(string)	Required	String (60)	Payments	"street1": "LAVALLE 4041","	Calle Numero interior Numero Exterior
billTo	street2(string)	Optional	String (60)	Payments	"street2": "LAVALLE 4041","	Barrio
purchaseTotals	currency(string)	Required	String (5)	Payments	"currency": "ARS"	http://apps.cybersource.com/library/documentation/sbc/quickref/currencies.pdf
purchaseTotals	grandTotalAmount(amount)	Required	Long (15)	Payments	"amount": 2000
customer_in_site (General for all Verticals)	MDD7- Fecha Registro Comprador (num Dias)	Optional	String (255)	Payments	"days_in_site": 243,"	Numero de dias que tiene registrado un cliente en el portal del comercio.
customer_in_site (General for all Verticals)	MDD8- Usuario Guest? (S/N)	Optional	String (255)	Payments	"is_guest": false,"	Valor Boleano para indicar si el usuario esta comprando como invitado en la pagina del comercio. Valores posibles (S/N)
customer_in_site (General for all Verticals)	MDD9- Customer password Hash	Optional	String (255)	Payments	"password": "abracadabra","	Valor del password del usuario registrado en el portal del comercio. Incluir el valor en hash
customer_in_site (General for all Verticals)	MDD10- Historico de compras del comprador (Num transacciones)	Optional	String (255)	Payments	"num_of_transactions": 1,"	Conteo de transacciones realizadas por el mismo usuario registrado en el portal del comercio
customer_in_site (General for all Verticals)	MDD11- Customer Cell Phone	Optional	String (255)	Payments	"cellphone_number": "12121"	Incluir numero de telefono adicional del comprador
customer_in_site (General for all Verticals)	MDD39- Visa Validation	Optional	String (255)	Payments	"street": "Av. Corrientes 1234"	Incluir Domicilio de cliente
customer_in_site (General for all Verticals)	MDD10- TXs Quantity	Optional	String (255)	Payments	"num_of_transactions": 1	Incluir numero de transaccion
ticketing_transaction_data	MDD33 - Days to Event	Requerido	Integer	Payments	"days_to_event": 55	Incluir dias para el evento
ticketing_transaction_data	MDD34 - Delivery Type	Requerido	Integer	Payments	"delivery_type": "Pick Up"	Incluir tipo de entrega
item	productCode(string)	Conditional	String (255)	Payments	"code": "popblacksabbat2016","	adult_content , coupon, gift_certificate , handling_only , shipping_and_handling , shipping_only, electronics, Apparel, Housewares, Sports, Toys, Books, Music, Video, Drugs/HBA
item	productDescription(string)	Conditional	String (255)	Payments	"description": "Popular Black Sabbath 2016","	Descripcion general del producto
item	productName(string)	Conditional	String (255)	Payments	"name": "popblacksabbat2016ss","	Nombre en catalogo del producto
item	productSKU(string)	Conditional	String (255)	Payments	"sku": "asas","	SKU en catalogo
item	quantity(integer)	Conditional	Integer (10)	Payments	"total_amount": 20,"	Cantidad productos del mismo tipo agregados al carrito
item	totalAmount(amount)	Conditional		Payments	"quantity": 1,"	"Precio total = Precio unitario * quantity / CSITTOTALAMOUNT = CSITUNITPRICE * CSITQUANTITY "999999.CC" Es mandatorio informar los decimales, usando el punto como separador de decimales. No se permiten comas, ni como separador de miles ni como separador de decimales."
item	unitPrice(amount)	Conditional	String (15)	Payments	"unit_price": 20"	"Precio Unitaro del producto / "999999.CC" Es mandatorio informar los decimales, usando el punto como separador de decimales. No se permiten comas, ni como separador de miles ni como separador de decimales."

Ejemplo

  $csmdd = array(
            array(
                "csmdd17" => "17"
            ),
            array(
                "csmdd18" => "18"
            ),
            array(
                "csmdd19" => "19.999"
            )
        );
  $cs_data = array(
        "send_to_cs" => true,
        "channel" => "Web",
        "device_unique_id" => "1234-1234",
        "bill_to" => array(
          "city" => "Buenos Aires",
          "country" => "AR",
          "customer_id" => "martinid",
          "email" => "accept@decidir.com.ar",
          "first_name" => "martin",
          "last_name" => "perez",
          "phone_number" => "1547766111",
          "postal_code" => "1427",
          "state" => "BA",
          "street1" => "GARCIA DEL RIO 4000",
          "street2" => "GARCIA DEL RIO 4000",
        ),
        "currency" => "ARS",
        "amount" => 1200,
        "days_in_site" => 243,
        "is_guest" => false,
        "password" => "abracadabra",
        "num_of_transactions" => 1,
        "cellphone_number" => "12121",
        "date_of_birth" => "129412",
        "street" => "RIO 4041",
        "delivery_type"=> "Pick up",
        "days_to_event"=> 55,
        "csmdds" => $csmdd
      );

  //Datos de productos, array con los diferentes productos involucrados.
  $cs_products = array(
        array(
          "csitproductcode" => "concierto2016",
                  "csitproductdescription" => "Popular Concierto 2016",
                  "csitproductname" => "concierto2016",
                  "csitproductsku" => "BS01",
                  "csittotalamount" => 600,
                  "csitquantity" => 1,
                  "csitunitprice" => 6.00
          ),
        array(
          "csitproductcode" => "concierto2017",
                  "csitproductdescription" => "Popular Concierto 2017",
                  "csitproductname" => "concierto2017",
                  "csitproductsku" => "BS01",
                  "csittotalamount" => 600,
                  "csitquantity" => 1,
                  "csitunitprice" => 600
        )
      );

Para incorporar estos datos en el requerimiento inicial, se debe instanciar un objeto de la clase Decidir\Data\Cybersource\Ticketing de la siguiente manera.

$cybersource = new Decidir\Cybersource\Ticketing(
                    $datos_cs,  // Datos de la operación
                    $cs_productos, // Datos de los productos
  );

$connector->payment()->setCybersource($cybersource->getData());

$data = array(
      "site_transaction_id" => "12042017_20",
      "token" => "be211413-757b-487e-bb0c-283d21c0fb6f",
      "user_id" => "usuario",
      "payment_method_id" => 1,
      "bin" => "450799",
      "amount" => 1200,
      "currency" => "ARS",
      "installments" => 1,
      "description" => "",
      "payment_type" => "single",
      "sub_payments" => array()
    );

$response = $connector->payment()->ExecutePayment($data);

Volver al inicio

Digital Goods

Los siguientes parámetros se deben enviar específicamente para la vertical Digital Goods. Además se deben enviar datos específicos de cada producto involucrado en la transacción.

Descripcion (Data set)	API Fields	Required/Optional	Data Type	Origen del dato	Campo referente en ApiRest	Comentarios
fraud_detection	send_to_cs(Boolean)	Required	Boolean	MDD40 - Fraud Update	"send_to_cs": true/false
fraud_detection	Channel(String)	Required	String	MDD6 - Sales Channel	"channel": "Web"
fraud_detection	device_unique_id(String)	Required	String	Unique identifier for the device	"device_unique_id": "1234-1234"
billTo	city(string)	Required	String (50)	Payments	"city": "Buenos Aires","	Ciudad / Debe comenzar con una letra
billTo	country(string)	Required	String (2)	Payments	"country": "AR","	Código ISO
billTo	customerID(string)	Required	String (50)	Payments	"customer_id": "leilaid","	Identificador del usuario unico logueado al portal (No puede ser una direccion de email)
billTo	email(string)	Required	String (100)	Payments	"email": "accept@decidir.com.ar","	correo electronico del comprador
billTo	firstName(string)	Required	String (60)	Payments	"first_name": "leila","	Nombre del tarjeta habiente / Sin caracteres especiales como acentos invertidos, sólo letras, números y espacios
billTo	lastName(string)	Required	String (60)	Payments	"last_name": "leila","	Apellido del tarjetahabiente / Sin caracteres especiales como acentos invertidos, sólo letras, números y espacios
billTo	phoneNumber(string)	Required	String (15)	Payments	"phone_number": "1548866329","	Número de telefono
billTo	postalCode(string)	Required	String (10)	Payments	"postal_code": "1427","	Codigo Postal
billTo	state(string)	Required	String (2)	Payments	"state": "BA","	Estado (Si el country = US, el campo se valida para un estado valido en USA)
billTo	street1(string)	Required	String (60)	Payments	"street1": "LAVALLE 4041","	Calle Numero interior Numero Exterior
billTo	street2(string)	Optional	String (60)	Payments	"street2": "LAVALLE 4041","	Barrio
purchaseTotals	currency(string)	Required	String (5)	Payments	"currency": "ARS"	http://apps.cybersource.com/library/documentation/sbc/quickref/currencies.pdf
purchaseTotals	grandTotalAmount(amount)	Required	Long (15)	Payments	"amount": 2000
customer_in_site (General for all Verticals)	MDD7- Fecha Registro Comprador (num Dias)	Optional	String (255)	Payments	"days_in_site": 243,"	Numero de dias que tiene registrado un cliente en el portal del comercio.
customer_in_site (General for all Verticals)	MDD8- Usuario Guest? (S/N)	Optional	String (255)	Payments	"is_guest": false,"	Valor Boleano para indicar si el usuario esta comprando como invitado en la pagina del comercio. Valores posibles (S/N)
customer_in_site (General for all Verticals)	MDD9- Customer password Hash	Optional	String (255)	Payments	"password": "abracadabra","	Valor del password del usuario registrado en el portal del comercio. Incluir el valor en hash
customer_in_site (General for all Verticals)	MDD10- Historico de compras del comprador (Num transacciones)	Optional	String (255)	Payments	"num_of_transactions": 1,"	Conteo de transacciones realizadas por el mismo usuario registrado en el portal del comercio
customer_in_site (General for all Verticals)	MDD11- Customer Cell Phone	Optional	String (255)	Payments	"cellphone_number": "12121"	Incluir numero de telefono adicional del comprador
customer_in_site (General for all Verticals)	MDD39- Visa Validation	Optional	String (255)	Payments	"street": "Av. Corrientes 1234"	Incluir Domicilio de cliente
customer_in_site (General for all Verticals)	MDD10- TXs Quantity	Optional	String (255)	Payments	"num_of_transactions": 1	Incluir numero de transaccion
digital_goods_transaction_data	MDD32 - Delivery Type	Requerido	Integer	Payments	"delivery_type": "Pick Up"	Incluir tipo de entrega
item	productCode(string)	Conditional	String (255)	Payments	"code": "popblacksabbat2016","	adult_content , coupon, gift_certificate , handling_only , shipping_and_handling , shipping_only, electronics, Apparel, Housewares, Sports, Toys, Books, Music, Video, Drugs/HBA
item	productDescription(string)	Conditional	String (255)	Payments	"description": "Popular Black Sabbath 2016","	Descripcion general del producto
item	productName(string)	Conditional	String (255)	Payments	"name": "popblacksabbat2016ss","	Nombre en catalogo del producto
item	productSKU(string)	Conditional	String (255)	Payments	"sku": "asas","	SKU en catalogo
item	quantity(integer)	Conditional	Integer (10)	Payments	"total_amount": 20,"	Cantidad productos del mismo tipo agregados al carrito

Ejemplo

$csmdd = array(
            array(
                "csmdd17" => "17"
            ),
            array(
                "csmdd18" => "18"
            ),
            array(
                "csmdd19" => "19.999"
            )
        );
$cs_data = array(
      "send_to_cs" => true,
      "channel" => "Web",
      "device_unique_id" => "1234-1234",
      "bill_to" => array(
        "city" => "Buenos Aires",
        "country" => "AR",
        "customer_id" => "martinid",
        "email" => "accept@decidir.com.ar",
        "first_name" => "martin",
        "last_name" => "perez",
        "phone_number" => "1547766111",
        "postal_code" => "1427",
        "state" => "BA",
        "street1" => "GARCIA DEL RIO 4000",
        "street2" => "GARCIA DEL RIO 4000",
      ),
      "currency" => "ARS",
      "amount" => 1200,
      "days_in_site" => 243,
      "is_guest" => false,
      "password" => "abracadabra",
      "num_of_transactions" => 1,
      "cellphone_number" => "12121",
      "date_of_birth" => "129412",
      "street" => "RIO 4041",
      "delivery_type"=> "Pick up",
      "csmdds" => $csmdd
    );

//lista de productos cybersource
$cs_products = array(
      array(
        "csitproductcode" => "software2016",
                "csitproductdescription" => "Software 2016",
                "csitproductname" => "soft2016",
                "csitproductsku" => "ST01",
                "csittotalamount" => 600,
                "csitquantity" => 1,
                "csitunitprice" => 6.00
      ),
      array(
        "csitproductcode" => "software2017",
                "csitproductdescription" => "Software 2017",
                "csitproductname" => "soft2017",
                "csitproductsku" => "ST01",
                "csittotalamount" => 600,
                "csitquantity" => 1,
                "csitunitprice" => 6.00
      )
    );

Para incorporar estos datos en el requerimiento inicial, se debe instanciar un objeto de la clase Decidir\Data\Cybersource\DigitalGoods de la siguiente manera.

$cybersource = new Decidir\Cybersource\DigitalGoods(
                    $datos_cs,  // Datos de la operación
                    $cs_productos, // Datos de los productos
  );

$connector->payment()->setCybersource($cybersource->getData());

$data = array(
      "site_transaction_id" => "12042017_20",
      "token" => "be211413-757b-487e-bb0c-283d21c0fb6f",
      "user_id" => "usuario",
      "payment_method_id" => 1,
      "bin" => "450799",
      "amount" => 1200,
      "currency" => "ARS",
      "installments" => 1,
      "description" => "",
      "payment_type" => "single",
      "sub_payments" => array()
    );

$response = $connector->payment()->ExecutePayment($data);

Services

Los siguientes parámetros se deben enviar específicamente para la vertical Digital Goods. Además se deben enviar datos específicos de cada producto involucrado en la transacción.

Descripcion (Data set)	API Fields	Required/Optional	Data Type	Origen del dato	Campo referente en ApiRest	Comentarios
fraud_detection	send_to_cs(Boolean)	Required	Boolean	MDD40 - Fraud Update	"send_to_cs": true/false
fraud_detection	Channel(String)	Required	String	MDD6 - Sales Channel	"channel": "Web"
fraud_detection	device_unique_id(String)	Required	String	Unique identifier for the device	"device_unique_id": "1234-1234"
billTo	city(string)	Required	String (50)	Payments	"city": "Buenos Aires","	Ciudad / Debe comenzar con una letra
billTo	country(string)	Required	String (2)	Payments	"country": "AR","	Código ISO
billTo	customerID(string)	Required	String (50)	Payments	"customer_id": "leilaid","	Identificador del usuario unico logueado al portal (No puede ser una direccion de email)
billTo	email(string)	Required	String (100)	Payments	"email": "accept@decidir.com.ar","	correo electronico del comprador
billTo	firstName(string)	Required	String (60)	Payments	"first_name": "leila","	Nombre del tarjeta habiente / Sin caracteres especiales como acentos invertidos, sólo letras, números y espacios
billTo	lastName(string)	Required	String (60)	Payments	"last_name": "leila","	Apellido del tarjetahabiente / Sin caracteres especiales como acentos invertidos, sólo letras, números y espacios
billTo	phoneNumber(string)	Required	String (15)	Payments	"phone_number": "1548866329","	Número de telefono
billTo	postalCode(string)	Required	String (10)	Payments	"postal_code": "1427","	Codigo Postal
billTo	state(string)	Required	String (2)	Payments	"state": "BA","	Estado (Si el country = US, el campo se valida para un estado valido en USA)
billTo	street1(string)	Required	String (60)	Payments	"street1": "LAVALLE 4041","	Calle Numero interior Numero Exterior
billTo	street2(string)	Optional	String (60)	Payments	"street2": "LAVALLE 4041","	Barrio
purchaseTotals	currency(string)	Required	String (5)	Payments	"currency": "ARS"	http://apps.cybersource.com/library/documentation/sbc/quickref/currencies.pdf
purchaseTotals	grandTotalAmount(amount)	Required	Long (15)	Payments	"amount": 2000
customer_in_site (General for all Verticals)	MDD7- Fecha Registro Comprador (num Dias)	Optional	String (255)	Payments	"days_in_site": 243,"	Numero de dias que tiene registrado un cliente en el portal del comercio.
customer_in_site (General for all Verticals)	MDD8- Usuario Guest? (S/N)	Optional	String (255)	Payments	"is_guest": false,"	Valor Boleano para indicar si el usuario esta comprando como invitado en la pagina del comercio. Valores posibles (S/N)
customer_in_site (General for all Verticals)	MDD9- Customer password Hash	Optional	String (255)	Payments	"password": "abracadabra","	Valor del password del usuario registrado en el portal del comercio. Incluir el valor en hash
customer_in_site (General for all Verticals)	MDD10- Historico de compras del comprador (Num transacciones)	Optional	String (255)	Payments	"num_of_transactions": 1,"	Conteo de transacciones realizadas por el mismo usuario registrado en el portal del comercio
customer_in_site (General for all Verticals)	MDD11- Customer Cell Phone	Optional	String (255)	Payments	"cellphone_number": "12121"	Incluir numero de telefono adicional del comprador
customer_in_site (General for all Verticals)	MDD39- Visa Validation	Optional	String (255)	Payments	"street": "Av. Corrientes 1234"	Incluir Domicilio de cliente
customer_in_site (General for all Verticals)	MDD10- TXs Quantity	Optional	String (255)	Payments	"num_of_transactions": 1	Incluir numero de transaccion
services_transaction_data	Service Type	Requerido	String (255)	"service_type": "eltipodelservicio"	Incluir el tipo de servicio
services_transaction_data	Reference payment	Requerido	String (255)	"reference_payment_service1": "reference1"	Incluir una referencia de pago
services_transaction_data	Reference payment	Requerido	String (255)	"reference_payment_service2": "reference1"	Incluir una referencia de pago
services_transaction_data	Reference payment	Requerido	String (255)	"reference_payment_service3": "reference1"	Incluir una referencia de pago
item	productCode(string)	Conditional	String (255)	Payments	"code": "popblacksabbat2016","	adult_content , coupon, gift_certificate , handling_only , shipping_and_handling , shipping_only, electronics, Apparel, Housewares, Sports, Toys, Books, Music, Video, Drugs/HBA
item	productDescription(string)	Conditional	String (255)	Payments	"description": "Popular Black Sabbath 2016","	Descripcion general del producto
item	productName(string)	Conditional	String (255)	Payments	"name": "popblacksabbat2016ss","	Nombre en catalogo del producto
item	productSKU(string)	Conditional	String (255)	Payments	"sku": "asas","	SKU en catalogo
item	quantity(integer)	Conditional	Integer (10)	Payments	"total_amount": 20,"	Cantidad productos del mismo tipo agregados al carrito

Ejemplo

$csmdd = array(
            array(
                "csmdd17" => "17"
            ),
            array(
                "csmdd18" => "18"
            ),
            array(
                "csmdd19" => "19.999"
            )
        );
$cs_data = array(
    "send_to_cs" => true,
    "channel" => "Web",
    "device_unique_id" => "1234-1234",
    "bill_to" => array(
        "city" => "Buenos Aires",
        "country" => "AR",
        "customer_id" => "martinid",
        "email" => "accept@decidir.com.ar",
        "first_name" => "martin",
        "last_name" => "perez",
        "phone_number" => "1547766111",
        "postal_code" => "1768",
        "state" => "BA",
        "street1" => "GARCIA DEL RIO 3333",
        "street2" => "GARCIA DEL RIO 3333",
    ),
    "currency" => "ARS",
    "amount" => 1200,
    "days_in_site" => 243,
    "is_guest" => false,
    "password" => "password",
    "num_of_transactions" => 1,
    "cellphone_number" => "12121",
    "date_of_birth" => "129412",
    "street" => "RIO 4041",
    "service_type" => "tiposervicio",
    "reference_payment_service1" => "reference1",
    "reference_payment_service2" => "reference2",
    "reference_payment_service3" => "reference3",
    "csmdds" => $csmdd
);

//lista de productos cybersource
$cs_products = array(
    array(
        "csitproductcode" => "popblacksabbat2016",
        "csitproductdescription" => "Popular Black Sabbath 2016",
        "csitproductname" => "popblacksabbat2016ss",
        "csitproductsku" => "asas",
        "csittotalamount" => 600,
        "csitquantity" => 1,
        "csitunitprice" => 600
    ),
    array(
        "csitproductcode" => "popblacksabbat2017",
        "csitproductdescription" => "Popular Black Sabbath 2017",
        "csitproductname" => "popblacksabbat2017ss",
        "csitproductsku" => "asas",
        "csittotalamount" => 600,
        "csitquantity" => 1,
        "csitunitprice" => 600
    )
);

Para incorporar estos datos en el requerimiento inicial, se debe instanciar un objeto de la clase Decidir\Data\Cybersource\Service de la siguiente manera.

$cybersource = new Decidir\Cybersource\Service(
                    $datos_cs,  // Datos de la operación
                    $cs_productos, // Datos de los productos
  );

$connector->payment()->setCybersource($cybersource->getData());

$data = array(
      "site_transaction_id" => "12042017_20",
      "token" => "be211413-757b-487e-bb0c-283d21c0fb6f",
      "user_id" => "usuario",
      "payment_method_id" => 1,
      "bin" => "450799",
      "amount" => 1200,
      "currency" => "ARS",
      "installments" => 1,
      "description" => "",
      "payment_type" => "single",
      "sub_payments" => array()
    );

$response = $connector->payment()->ExecutePayment($data);

Travel

Los siguientes parámetros se deben enviar específicamente para la vertical Travel. Además se deben enviar datos específicos de cada pasajero involucrado en la transacción.

Descripcion (Data set)	API Fields	Required/Optional	Data Type	Origen del dato	Campo referente en ApiRest	Comentarios
fraud_detection	send_to_cs(Boolean)	Required	Boolean	MDD40 - Fraud Update	"send_to_cs": true/false
fraud_detection	Channel(String)	Required	String	MDD6 - Sales Channel	"channel": "Web"
fraud_detection	device_unique_id(String)	Required	String	Unique identifier for the device	"device_unique_id": "1234-1234"
billTo	city(string)	Required	String (50)	Payments	"city": "Buenos Aires","	Ciudad / Debe comenzar con una letra
billTo	country(string)	Required	String (2)	Payments	"country": "AR","	Código ISO
billTo	customerID(string)	Required	String (50)	Payments	"customer_id": "leilaid","	Identificador del usuario unico logueado al portal (No puede ser una direccion de email)
billTo	email(string)	Required	String (100)	Payments	"email": "accept@decidir.com.ar","	correo electronico del comprador
billTo	firstName(string)	Required	String (60)	Payments	"first_name": "leila","	Nombre del tarjeta habiente / Sin caracteres especiales como acentos invertidos, sólo letras, números y espacios
billTo	lastName(string)	Required	String (60)	Payments	"last_name": "leila","	Apellido del tarjetahabiente / Sin caracteres especiales como acentos invertidos, sólo letras, números y espacios
billTo	phoneNumber(string)	Required	String (15)	Payments	"phone_number": "1548866329","	Número de telefono
billTo	postalCode(string)	Required	String (10)	Payments	"postal_code": "1427","	Codigo Postal
billTo	state(string)	Required	String (2)	Payments	"state": "BA","	Estado (Si el country = US, el campo se valida para un estado valido en USA)
billTo	street1(string)	Required	String (60)	Payments	"street1": "LAVALLE 4041","	Calle Numero interior Numero Exterior
billTo	street2(string)	Optional	String (60)	Payments	"street2": "LAVALLE 4041","	Barrio
purchaseTotals	currency(string)	Required	String (5)	Payments	"currency": "ARS"	http://apps.cybersource.com/library/documentation/sbc/quickref/currencies.pdf
customer_in_site (General for all Verticals)	MDD8- Usuario Guest? (S/N)	Optional	String (255)	Payments	"is_guest": false,"	Valor Boleano para indicar si el usuario esta comprando como invitado en la pagina del comercio. Valores posibles (S/N)
customer_in_site (General for all Verticals)	MDD9- Customer password Hash	Optional	String (255)	Payments	"password": "abracadabra","	Valor del password del usuario registrado en el portal del comercio. Incluir el valor en hash
customer_in_site (General for all Verticals)	MDD10- Historico de compras del comprador (Num transacciones)	Optional	String (255)	Payments	"num_of_transactions": 1,"	Conteo de transacciones realizadas por el mismo usuario registrado en el portal del comercio
customer_in_site (General for all Verticals)	MDD11- Customer Cell Phone	Optional	String (255)	Payments	"cellphone_number": "12121"	Incluir numero de telefono adicional del comprador
customer_in_site (General for all Verticals)	MDD39- Visa Validation	Optional	String (255)	Payments	"street": "Av. Corrientes 1234"	Incluir Domicilio de cliente
customer_in_site (General for all Verticals)	MDD10- TXs Quantity	Optional	String (255)	Payments	"num_of_transactions": 1	Incluir numero de transaccion
travel_transaction_data	reservation_code	Requerido	String (255)	"reservation_code": "GJH784"	Incluir el codigo de servicio
travel_transaction_data	third_party_booking	Requerido	String (255)	"third_party_booking": false	Incluir "true" si es booking por terceros
travel_transaction_data	departure_city	Requerido	String (255)	"departure_city": "EZE"	Incluir codigo de ciudad de salida
travel_transaction_data	final_destination_city	Requerido	String (255)	"final_destination_city": "HND"	Incluir codigo de ciudad de llegada
travel_transaction_data	international_flight	Requerido	String (255)	"international_flight": false	Incluir "true" si es vuelo internacional
travel_transaction_data	frequent_flier_number	Requerido	String (255)	"frequent_flier_number": "00000123"	Incluir el numero de viajero frecuente
travel_transaction_data	class_of_service	Requerido	String (255)	"class_of_service": "class"	Incluir la clase de servicio
travel_transaction_data	day_of_week_of_flight	Requerido	String (255)	"day_of_week_of_flight": 2	Incluir el día de la semana de vuelo
travel_transaction_data	week_of_year_of_flight	Requerido	String (255)	"week_of_year_of_flight": 5	Incluir la semana del año de vuelo
travel_transaction_data	airline_code	Requerido	String (255)	"airline_code": "AA"	Incluir el código de la aerolínea
travel_transaction_data	code_share	Requerido	String (255)	"code_share": "SKYTEAM"	Incluir el código de compartido
travel_transaction_data	code_share	Requerido	String (255)	"code_share": "SKYTEAM"	Incluir el código de compartido
travel_transaction_data decision_manager_travel	complete_route	Requerido	String (255)	"complete_route": "EZE-LAX:LAX-HND"	Incluir código de ruta completa
travel_transaction_data decision_manager_travel	journey_type	Requerido	String (255)	"journey_type": "one way"	Incluir tipo de viaje
travel_transaction_data decision_manager_travel	departure_date departure_time	Requerido	String (255)	"departure_time": "2017-05-30T09:00Z"	Incluir el tiempo de partida
travel_transaction_data decision_manager_travel	departure_date departure_zone	Requerido	String (255)	"departure_zone": "2017-05-30T09:00Z"	Incluir la zona de partida
passengers	email(string)	Conditional	String (255)	Payments	"email": "juan@mail.com"	Email del pasajero
passengers	first_name(string)	Conditional	String (255)	Payments	"first_name": "Juan"	Primer nombre del pasajero
passengers	last_name(string)	Conditional	String (255)	Payments	"last_name": "Perez"	Apellido del pasajero
passengers	passport_id(string)	Conditional	String (255)	Payments	"passport_id": "412314851231"	Id del pasaporte del pasajero
passengers	phone(string)	Conditional	String (255)	Payments	"phone": "541134356768"	Teléfono del pasajero
passengers	passenger_status(string)	Conditional	String (255)	Payments	"passenger_status": "gold"	Status del pasajero
passengers	passenger_type(string)	Conditional	String (255)	Payments	"passenger_type": "ADT"	Tipo de pasajero

Ejemplo

$cs_data = array(
    "send_to_cs" => true,
    "channel" => "Web",
    "device_unique_id" => "1234-1234",
    "bill_to" => array(
        "city" => "Buenos Aires",
        "country" => "AR",
        "customer_id" => "martinid",
        "email" => "accept@decidir.com.ar",
        "first_name" => "martin",
        "last_name" => "perez",
        "phone_number" => "1547766111",
        "postal_code" => "1768",
        "state" => "BA",
        "street1" => "GARCIA DEL RIO 3333",
        "street2" => "GARCIA DEL RIO 3333",
    ),
    "currency" => "ARS",
    "amount" => 1200,
    "days_in_site" => 243,
    "is_guest" => false,
    "password" => "password",
    "num_of_transactions" => 1,
    "cellphone_number" => "12121",
    "date_of_birth" => "129412",
    "street" => "RIO 4041",
    "reservation_code" => "GJH784",
    "third_party_booking" => false,
    "departure_city" => "EZE",
    "final_destination_city" => "HND",
    "international_flight" => true,
    "frequent_flier_number" => "00000123",
    "class_of_service" => "class",
    "day_of_week_of_flight" => 2,
    "week_of_year_of_flight" => 5,
    "airline_code" => "AA",
    "code_share" => "SKYTEAM",
    "decision_manager_travel" => array(
            "complete_route" => "EZE-LAX:LAX-HND",
            "journey_type" => "one way",
            "departure_date" => array(
                    "departure_time" =>  "2017-05-30T09:00Z",
                    "departure_zone "=> "GMT-0300"
            )
    ),
    "airline_number_of_passengers" => 1
);

$cs_passenger = array(
    array(
        "email" => "juan@mail.com",
        "first_name" => "Juan",
        "last_name" => "Perez",
        "passport_id" => "412314851231",
        "phone" => "541134356768",
        "passenger_status" => "gol",
        "passenger_type" => "ADT"
    )
);

Para incorporar estos datos en el requerimiento inicial, se debe instanciar un objeto de la clase Decidir\Data\Cybersource\Travel de la siguiente manera.

$cybersource = new Decidir\Cybersource\Travel(
                    $datos_cs,  // Datos de la operación
                    $cs_passenger, // Datos de los pasajeros
  );

$connector->payment()->setCybersource($cybersource->getData());

$data = array(
      "site_transaction_id" => "12042017_20",
      "token" => "be211413-757b-487e-bb0c-283d21c0fb6f",
      "user_id" => "usuario",
      "payment_method_id" => 1,
      "bin" => "450799",
      "amount" => 1200,
      "currency" => "ARS",
      "installments" => 1,
      "description" => "",
      "payment_type" => "single",
      "sub_payments" => array()
    );

$response = $connector->payment()->ExecutePayment($data);

Volver al inicio

Tablas de Referencia

Códigos de Medios de pago

https://decidirv2.api-docs.io/1.0/tablas-de-referencia-e-informacion-para-el-implementador/medios-de-pago-disponibles

Visa Debito no acepta devoluciones parciales en e-commerce.

Volver al inicio

Divisas Aceptadas

Divisa	Descripción	Código API
AR$	Pesos Argentinos	ARS
U$S	Dólares Americanos	USD

NOTA Si bien la API RESTful de DECIDIR admite compras en Dólares Americanos, la legislación argentina sólo permite transacciones en Pesos Argentinos. Es por esto que DECIDIR recomienda que todas las transacciones se cursen en dicha moneda.

Volver al inicio

Provincias

Provincia	Código
CABA	C
Buenos Aires	B
Catamarca	K
Chaco	H
Chubut	U
Córdoba	X
Corrientes	W
Entre Ríos	R
Formosa	P
Jujuy	Y
La Pampa	L
La Rioja	F
Mendoza	M
Misiones	N
Neuquén	Q
Río Negro	R
Salta	A
San Juan	J
San Luis	D
Santa Cruz	Z
Santa Fe	S
Santiago del Estero	G
Tierra del Fuego	V
Tucumán	T

Volver al inicio

Erorres

Erorres de Sistema

Listado de Códigos de Errores

Erorres de Marca

Listado de Códigos de Errores de Medios de Pago

Volver al inicio

Name		Name	Last commit message	Last commit date
Latest commit History 158 Commits
Decidir/lib		Decidir/lib
docs/img		docs/img
resources		resources
vendor		vendor
LICENSE		LICENSE
README.md		README.md
composer.json		composer.json

License

payway-ar/sdk-php-ventaonline

Folders and files

Latest commit

History

Repository files navigation

Payway SDK PHP

Aclaración

El campo amount de todos los pagos y operaciones son de tipo Long, se consideran los 2 ultimos digitos como la parte decimal del importe.

Introducción

Alcance

TimeOut

Diagrama de secuencia

Instalación

Versiones de PHP soportadas

Manual de Integración

Ambientes

Uso

Inicializar la clase correspondiente al conector.

Operatoria del Gateway

Health Check

Token

TokenCS

Ejecución del Pago

Ejemplo

Transacción PCI

Ejemplo

Ejecución del pago PCI Tokenizado

Ejecución de pago simple con 3ds

Ejecución de instruction 3ds

Captura del Pago

Ejemplo

Ejecución de pago offline

Pago Facil

Ejemplo

Rapipago

Ejemplo

Pago mis Cuentas

Ejemplo

Cobro Express

Ejemplo

Cobro Express

Ejemplo

Formulario de Pago

Ejemplo

Respuesta servicio validate

Formulario renderizado

Listado de Pagos

Información de un Pago

Información adicional de tarjeta

Respuesta

Anulación / Devolución Total de Pago

Anulación de Devolución Total

Devolución Parcial de un Pago

Anulación de Devolución Parcial

Tokenizacion de tarjetas de crédito

Listado de tarjetas tokenizadas

Ejecucion de pago tokenizado

Eliminacion de tarjeta tokenizada

Integración con Cybersource

Retail

Ejemplo

Ticketing

Ejemplo

Digital Goods

Ejemplo

Services

Ejemplo

Travel

Ejemplo

Tablas de Referencia

Códigos de Medios de pago

Divisas Aceptadas

Provincias

Erorres

Erorres de Sistema

Erorres de Marca

About

Topics

Resources

Packages