API Reference

Pagos Sin Tarjeta Presente

Realice transacciones sin el uso de tarjeta física

Los pagos Sin Tarjeta Presente son aquellos que pueden generarse a través de un Comercio electrónico, Cargo Recurrente, Liga de Pago, Código QR, Transferencia Electrónica o Wallets, lo cual permite al comercio recibir pagos a distancia o programados, mediante una configuración previa para aplicarlos en determinados periodos y por distintos medios que OEL pone a tu disposición; para ello, empecemos primeramente como haremos un llamado en formato SOAP.

Variables de envío

Ejemplo de una llamada VENTA de eccomerce

POST /gateway/opGateway.asmx HTTP/1.1
Host: servertest.operacionesenlinea.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://servidorseguro.operacionesenlinea.com/ecommerceVenta"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <OpHeader xmlns="https://servidorseguro.operacionesenlinea.com/">
        <!-------Valores para conexion de nuestro gateway----->
      <OpKey1>string</OpKey1>
      <OpKey2>string</OpKey2>
    </OpHeader>
  </soap:Header>
  <soap:Body>
    <ecommerceVenta xmlns="https://servidorseguro.operacionesenlinea.com/">
      <request>
        <!-------Valores para conexion de nuestro gateway----->
        <comercioId>int</comercioId>
        <contrasena>string</contrasena>
        
        <modo>string</modo>
        <monto>decimal</monto>
        <propina>decimal</propina>
        <transaccionId>string</transaccionId>
        <referencia>string</referencia>
        <tarjeta>string</tarjeta>
        <tipo>string</tipo>
        <mes>string</mes>
        <anio>string</anio>
        <digitos>string</digitos>
        <titular>string</titular>
        <dirIp>string</dirIp>
        <diferimiento>string</diferimiento>
        <numeroPagos>string</numeroPagos>
        <plan>string</plan>
        <xid>string</xid>
        <cavv>string</cavv>
        <eci>string</eci>
        <status_3d>string</status_3d>
        <subcomercio>string</subcomercio>
      </request>
    </ecommerceVenta>
  </soap:Body>
</soap:Envelope>

Variables de retorno

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ecommerceVentaResponse xmlns="https://servidorseguro.operacionesenlinea.com/">
      <ecommerceVentaResult>
        <comercioId>int</comercioId>
        <transaccionId>string</transaccionId>
        <fechaTransaccion>string</fechaTransaccion>
        <horaTransaccion>string</horaTransaccion>
        <monto>decimal</monto>
        <codigoRespuesta>int</codigoRespuesta>
        <procReturnMsg>string</procReturnMsg>
        <!-------En caso de error revisar estas variables----->
        <ccErrorCode>int</ccErrorCode>
        <ccReturnMsg>string</ccReturnMsg>
        
        <codigoAprobacion>string</codigoAprobacion>
        <referenciaTransaccionBancaria>string</referenciaTransaccionBancaria>
      </ecommerceVentaResult>
    </ecommerceVentaResponse>
  </soap:Body>
</soap:Envelope>

Lista de métodos

Los métodos que tenemos disponibles para tarjeta no presentes son:

Para hacer los llamados desde diferentes lenguajes de Programación, únicamente se necesita adaptar la llamada SOAP de acorde a las reglas del lenguaje en la que este montado su sitio.

Definición de códigos de respuesta

Es posible que si alguna parte del mensaje o variables en el envío no hayan sido configuradas correctamente recibas códigos de rechazo dentro de las variables de retorno, pero no hay porque alarmarse, ya que a la vez que despliega un número de error, muestra un mensaje que explica que tipo de error está regresando.

En caso de querer conocer más de los errores más comunes que se puedan tener, en este enlace se puede encontrar nuestro anexo con la lista de errores que podrían regresar y a la explicación de cada uno.

Venta con 3D Secure

Para realizar una venta utilizando 3D Secure, el cual te permitirá o al comercio recibir pagos de manera segura, dejando de lado del emisor de cada tarjeta, el asegurar que la persona que paga realmente es quien dice ser, mediante una autenticación a la cuenta con la que se realiza el pago, será necesario que cumpla con las siguientes condiciones que se detallan en esta sección.

Asegúrate que todos los datos que se detallan como Obligatorios sean enviados en el script del mensaje, de lo contrario, la operación no será procesada por el Banco Emisor de la tarjeta del tarjetahabiente y responderá con un rechazo.