Skip to navigation

3. Subir comprobante de pago

Paso 3. Adjunta el comprobante de pago electrónico (boleta o factura) emitido al cliente.

Headers

HeaderValor
AuthorizationBearer <accessToken>
apiKeyapiKey del ambiente

Body (multipart/form-data)

CampoTipoRequeridoDescripción
paymentproofarchivoSíComprobante en pdf, jpg, jpeg, png, docx o xlsx. Máximo 10 MB.

Ejemplo en cURL:

curl --location '<URL del gateway>/seller/seller-api-gateway/v1/payment-proof/upload/{orderId}' \
--header 'apiKey: <apiKey>' \
--header 'Authorization: Bearer <accessToken>' \
--form 'paymentproof=@"/ruta/al/comprobante.pdf"'

Respuestas

CódigoBodyCausa
200{"message": "Se realizo el registro correctamente.", "data": "<archivo>", "status": true}Comprobante registrado.
400El archivo no cumple con los formatos permitidos(...)Extensión no permitida.
413{"fault": {... "errorcode": "protocol.http.TooBigBody"}}El archivo supera 10 MB.
500{"message": "La orden no existe", "status": false}El orderId no existe.

Después de subirlo, el Detalle de orden muestra el archivo en paymentProof, renombrado como <orderId>-<AAAAMMDDHHmm>.<extensión>.

Si el comprobante es incorrecto, se puede generar una controversia CPE (Comprobante de pago errado).

Authentication

AuthorizationBearer

accessToken obtenido en Login. Dura 24 horas.

apiKeystring

apiKey de tu ambiente (QA o PRD). La recibes por correo con tus credenciales.

Path parameters

orderIdstringRequired

Número de orden.

Request

This endpoint expects a multipart form containing a file.
paymentprooffileRequired

Comprobante: pdf, jpg, jpeg, png, docx o xlsx. Máximo 10 MB.

Response

Comprobante registrado
messagestringOptional
datastringOptional
statusbooleanOptional

Errors

400
Bad Request Error
413
Content Too Large Error
500
Internal Server Error