Download the PHP package decidir2/php-sdk without Composer

On this page you can find all versions of the php package decidir2/php-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of decidir2/php-sdk

Informations about the package php-sdk

Payway SDK PHP

Aclaración

A partir de la version 2.0 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

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:

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 privada1 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:


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:

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.

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.

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.

Volver a inicio

Token

Este recurso permite obtener token de pago.

Volver a inicio

TokenCS

Este recurso permite obtener token de pago.

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: "[email protected]",
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

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

Ejecución del pago PCI Tokenizado

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".

Ejecución de instruction 3ds

Se agrega el objeto con los atributos id e instruction_value.

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

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: "[email protected]",
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

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: "[email protected]",
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

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: "[email protected]",
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

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: "[email protected]",
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

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: "[email protected]",
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

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:"[email protected]"
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

Respuesta servicio validate

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:

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.

Información adicional de tarjeta

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

Respuesta

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.

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.

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

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.

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.

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".

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.

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"
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": "[email protected]"," 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": "[email protected]"," 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

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

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"
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": "[email protected]"," 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

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

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"
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": "[email protected]"," 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

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

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"
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": "[email protected]"," 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

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

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"
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": "[email protected]"," 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": "[email protected]" 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

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

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

  1. 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

All versions of php-sdk with dependencies

PHP Build Version
Package Version
Requires php Version >=5.3
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package decidir2/php-sdk contains the following files

Loading the files please wait ....