Documentación técnica para que incluyas SPEI en tu comercio API

Generalidades

El medio de pago STP-SPEI para México es un medio de pago de tipo electrónico en el cuál el pagador hace una transferencia bancaria desde la sucursal electrónica de su banco hacia a una cuenta CLABE propia de PayU. STP consume un servicio SOAP expuesto por PayU para actualizar la transacción.

 

Modelo de integración soportado

El medio de pago está disponible tanto para comercios vía checkout como comercios API a través del método submit transaction seleccionando como medio de pago “STP-SPEI”.

 

Flujo de la transacción

Cuando el pagador selecciona el medio de pago SPEI en el checkout, o el comercio envía una solicitud de pago vía API con el medio de pago SPEI, PayU crea una orden en estado “en progreso” y una transacción en estado “pendiente”.

Para completar el pago, el pagador deberá ingresar a la sucursal virtual de su banco (su banco debe hacer parte del listado de bancos soportados por  SPEI). Primero que todo el pagador deberá registrar el campo cuenta CLABE de PayU en su sucursal bancaria. Una vez la cuenta CLABE de PayU quede habilitada para realizar transferencias, el pagador debe desde su sucursal virtual ingresar la referencia devuelta por PayU dentro del campo código de trazabilidad igualmente debe ingresar el monto tal cuál como PayU lo retorne.

 

Comercios API

Los comercios API pueden hacer uso de este nuevo medio de pago, mediante el API de pagos de PayU. Para esto el comercio debe realizar un llamado al API de PayU a través del comando SUBMIT_TRANSACTION del tipo AUTHORIZATION_AND_CAPTURE, enviando en la variable el medio de pago “SPEI”. A continuación un ejemplo del request para el medio de pago SPEI:

 

 {
   "language": "es",
   "command": "SUBMIT_TRANSACTION",
   "merchant": {
      "apiKey": "xxxxxxxxxxxxxxxxxxxxxxxxxx",
      "apiLogin": "xxxxxxxxxxxxxxx"
   },
   "transaction": {
      "order": {
         "accountId": "000000",
         "referenceCode": "25",
         "description": "Spei test",
         "language": "es",
         "notifyUrl": "http://www.tes.com/confirmation",
         "additionalValues": {
            "TX_VALUE": {
               "value": 1,
               "currency": "MXN"
            }
         },
         "buyer": {
            "emailAddress": "buyer_test@test.com"
         }
      },
      "type": "AUTHORIZATION_AND_CAPTURE",
      "paymentMethod": "SPEI",
      "expirationDate": "2017-02-20T00:00:00",
      "paymentCountry": "MX",
      "ipAddress": "127.0.0.1"
   },
   "test": false
}

 

Nota: Importante incluir en los parámetros extra las cuotas (1) y la versión de checkout (V2).

 

Response: En la respuesta se devuelven las variables necesarias para que el comercio pueda elaborar su voucher de pago (si así lo desea) o se retornan las url´s con el voucher que genera PayU en formatos HTML y pdf.

 

Variables para elaborar el comprobante de pago:

  • trazabilityCode: Identificador único de máximo 7 digitos Corresponde a la referencia de pago que el pagador debe registrar en su sucursal virtual. Para que el pago sea exitoso es importante que el pagador digite exactamente este valor dentro del campo referencia de su sucursal bancaria (virtual).
  • value: El pagador debe digitar como monto de la transferencia en su sucursal bancaria exactamente el mismo valor al informado por el comercio en el request para que el pago pueda ser exitoso.
  • SPEI_CLABE_ACCOUNT_NUMBER: Corresponde a la CLABE interbancaria de PayU, es decir la cuenta beneficiaria del pago. Para que un pago pueda ser exitoso el pagador debe registrar dicha CLABE como beneficiaria desde su banco y posteriormente realizar la transferencia a esta cuenta.
  • SPEI_BANK_NAME: Nombre del banco asociado a la cuenta CLABE de PayU. La cuenta beneficiaria está asociada al banco STP y para PayU siempre es el mismo banco.

 

Variables con los comprobantes generados por PayU:

  • URL_PAYMENT_RECEIPT_HTML: URL del voucher HTML generado por PayU. Incluye el paso a paso de instrucciones dirigido al pagador.
  • URL_PAYMENT_RECEIPT_PDF: URL del voucher en formato pdf.

 

A continuación un ejemplo de la respuesta API para el medio de pago SPEI:

 


   SUCCESS
   
      840414381
      f53d4100-388e-4cd1-8bbe-5bcfc737e398
      PENDING
      2
      PENDING_TRANSMISSION
      PENDING_TRANSACTION_CONFIRMATION
      
         
            URL_PAYMENT_RECEIPT_HTML
            https://sandbox.checkout.payulatam.com/ppp-web-gateway-payu/
                    app?vid=840414381Yf53d4100388e4cdYdd179da8bf831d9
         
         
            SPEI_CLABE_ACCOUNT_NUMBER
            646180132800000009
         
         
            URL_PAYMENT_RECEIPT_PDF
            https://sandbox.checkout.payulatam.com/ppp-web-gateway-payu/
                    receipt?vid=840414381Yf53d4100388e4cdYdd179da8bf831d9
         
         
            SPEI_BANK_NAME
            STP
         
      
   

468 ad