Registrar

Permite registrar una transacción en PSE

Registrar

POST https://api.payvalida.com/pse/transactions

URL Sandbox: https://api-test.payvalida.com/pse/transactions Al crear una transacción, se envían los datos necesarios para completar el pago y se obtienen el URL del banco y el ticketid. Para completar la transacción se debe redireccionar al cliente al URL del banco para que éste complete la operación. Con el ticketid se consulta el resultado de la operación. Es prudente esperar de 5 a 10 minutos entre la creación de la transacción y la consulta, tiempo suficiente para que el cliente complete la operación con su entidad bancaria.

Request Body

Name	Type	Description
merchant	string	Identificación del comercio en Payvalida. Máx. 50 caracteres.
serviceCode	string	Código de servicio del comercio en PSE. Máx. 10 caracteres.
checksum	string	Cadena de comprobación con SHA512(reference + amount + di + bank + FIXED_HASH)
bank	string	Código del banco en PSE. 4 caracteres
amount	string	Monto de la orden de compra.
reference	string	Número de referencia en Payvalida. Máx. 16 caracteres.
di	string	Número de documento del comprador. Máx 15 caracteres
typeDI	string	Tipo de documento de identidad del comprador. Máx. 3 caracteres.
name	string	Nombres del comprador. Máx. 25 caracteres.
email	string	Correo electrónico del comprador. Máx. 50 caracteres.
phone	string	Número de teléfono del comprador. Máx. 10 números.
address	string	Dirección de residencia del comprador. Máx. 64 caracteres.
urlReturn	string	URL de retorno después de finalizada transacción en PSE. Máx. 300 caracteres.
personType	string	Tipo de persona que realiza la compra. "N" natural o "J" jurídica
lastName	string	Apellidos del comprador. Máx. 25 caracteres.

200 La ejecución retorna un JSON estructurado de la siguiente manera:

{  
   "CODE":"0000",
   "DESC":"Consulta Exitosa",
   "DATA":[  
      {  
         "URL_BANK":"desarrollo.bancolombia.com",
         "TICKET_ID":"00946981"
      }
   ]
}

Detalles

• serviceCode: código de servicio de Payvalida o del comercio en PSE.

• bank: se consigue de la lista de bancos.

• reference: se genera utilizando el API de recaudos.

• amount: monto de la operación. El monto de la orden en Payvalida debe de coincidir con este.

• urlReturn: esta url es donde va a redireccionar el cliente cuando termine su operación en PSE.

• name: nombre del cliente en el documento de identidad (no acepta caracteres especiales ni acentos).

• typeDI: los valores válidos son "CC", "CE", "NIT", "TI", "PP", "TE", "RC", "DIE"

• personType: se permite tanto personas naturales como jurídicas.

• token: Es el token JWT con la orden completa encriptada

La identificación del comercio (merchant) y FIXED_HASH, es generada al momento de crear una cuenta en nuestra plataforma y se envía por correo electrónico. El service code y el entity code son entregados luego de configurar el comercio para utilizar PSE.

Para registrar una nueva transacción en PSE sobre la misma referencia se debe de esperar que el estado de la transacción pase de PENDIENTE a FALLIDA o RECHAZADA.

Si ya utilizabas anteriormente el API PSE, ten en cuenta que para esta nueva versión se agregaron tres datos del comprador, requeridos en la petición: email, phone y address.