Documentación Collectar

Documentación Collectar

Documentación técnica de integración

Añadir justificante

Estimated reading: 2 minutes 52 views

Añade justificante  de pago tras recibir la notificación de un pago OK de una factura

Parámetros de entrada necesario

El servicio recibe los siguientes parámetros:

El contenido del documento se enviará codificado en Base64

receipt

Parámetros de salida

El servicio devolverá un mensaje JSON con los siguientes campos:

Dónde:

  • Error: Código de resultado de error que devolverá los valores indicados en la siguiente tabla:

El campo firma se compondrá mediante el siguiente proceso. Para ellos se generará una cadena concatenados los siguientes valores:

 idCliente
 tokenFactura
 Clave Privada

Sobre esta cadena, aplicaremos una función SHA 256 y el resultado será codificado en una cadena hexadecimal (en Mayúsculas)

firma = upper(hex(sha256(cadena de firma)))

El resultado de esta función es el valor a enviar en el campo firma

Ejemplo de petición

Ejecutamos el método addReceipt mediante una invocación POST al servicio en el entorno de test:

Con el siguiente cuerpo:

				
					{
 "idCliente": "bb9e34635fb7",
 "tokenFactura": "AD1064935F76441A828A9AA874DB",
 "receipt":
{
"nombreDoc":"test.pdf",
"contenidoDoc":"JVBERi0……",
"mimeType":"application/pdf"
 },
 "firma": "7A4C85BD256A92DEDE5EAECE99F6020150EFBA4124DD978D117BB259968ED963"
}
				
			

El campo firma se ha compuesto de la siguiente manera:

 Creamos la cadena de firma: –

BB9E34635FB7BB9E34635FB7C35C7EE710D3

 Generamos el hash para esa cadena, lo convertimos a una cadena hexadecimal y lo ponemos en mayúsculas: –

7A4C85BD256A92DEDE5EAECE99F6020150EFBA4124DD978D117BB259968ED963

Respuesta a una petición

La petición anterior devolverá una respuesta JSON con el siguiente contenido:

Correcta

				
					{
 "resultado":"OK",
 "error":0,
 "idPago":"5A12721B",
 "tokenFactura":"AD1064935F76441A828A9AA874DB6DBF41C97B2C165C4A65AE9382F857CEFEF9"
}
				
			

Con error 

				
					{ 
 "resultado":"KO", 
 "error":0, 
 "idFactura":"F0125", 
 "tokenFactura":"AD1064935F76441A828A9AA874DB6DBF41C97B2C165C4A65AE9382F857CEFEF9"
}
				
			
CONTENTS
es_ESEspañol