Crear nuevo comprobante

Productos en los que aplica:

WALLET / PSP

Descripción

Crea un nuevo comprobante de ajuste de saldo en una cuenta.

Antes deben crearse tipos de comprobantes propios a utilizar por la entidad. No está permitido utilizar los tipos de comprobante reservados para operaciones internas del sistema (IdTipoComprobante: 1, 2, 3, 4, 5 y 6) ya que puede resultar en dificultades para el proceso de conciliación.

Endpoint

POST

/walletentidad-comprobante/v1/api/v1.201/Comprobante

Request

idTipoComprobante string
— REQUIRED
Identificador del tipo de comprobante. La entidad puede crear y gestionar sus propios tipos de comprobante.
No está permitido utilizar los tipos de comprobante reservados para operaciones internas del sistema (IdTipoComprobante: 1, 2, 3, 4, 5 y 6).

idCuenta string
— REQUIRED
Identificador de la cuenta sobre la cual quiere realizarse el ajuste de saldo.

importe string
— REQUIRED
Valor del importe del ajuste de saldo.

referencia string
— OPTIONAL
Descripción o referencia del comprobante a aplicar.

idComprobanteRelacionado string
— OPTIONAL
Identificador de otro comprobante relacionado a este, si lo hubiera o si se quisiera relacionar.

idExterno string
— OPTIONAL
Identificador o código externo de la entidad que quiera relacionar a este comprobante. Sirve para luego utilizarlo en consultas o para verlo en archivos batch.
Longitud máxima: 50 caracteres.

fechaExterna string
— OPTIONAL
Fecha (sólo informativa) externa de la entidad que quiera relacionar a este comprobante. Sirve para luego para verla en archivos batch.
Longitud máxima: 50 caracteres.

Ejemplo de request

Copy code

curl --location 'https://gw-staging-qrbind.epays.services/walletentidad-comprobante/v1/api/v1.201/Comprobante' \
--header 'Authorization: Bearer 12345XAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6Ikg5bmo1QU9Tc3dNcGhnMVNGeDdqYVYtbEI5dyJ9.eyJhdWQiOiJiNmQ1OTEyYi00ZTM0LTRmYjItOWYzMS0yNzEzZTEwYWY3NDUiLCJpc3MiOiJodHRwczovL2xvZ2luLm1pY3Jvc29mdG9ubGluZS5jb20vNjFlZjViODktOGRmMy00OTlkLThjMTMtMzhmZWQ1ZDA5YzcyL3YyLjAiLCJpYXQiOjE3MjU0MDI0MzAsIm5iZiI6MTcyNTQwMjQzMCwiZXhwIjoxNzI1NDA2MzMwLCJhaW8iOiJBU1FBMi84WEFBQUE3eiszSGdzQ2s2K1MzOGZKMnZJUGt5R1FONFJJc2svSjNCZDR2ckZwK1B3PSIsImF6cCI6IjA0OTI4Mjk4LTRjN2YtNDkxMi1hYmE4LWU4YThmNTZmYWQ1ZCIsImF6cGFjciI6IjEiLCJvaWQiOiJhYTZiMjExYi01ZmQzLTQ1M2ItYjMwZC0wODMzYTMxODA1OWIiLCJyaCI6IjAuQVgwQWlWdnZZZk9OblVtTUV6ai0xZENjY2l1UjFiWTBUckpQbnpFbkUtRUs5MFdhQUFBLiIsInJvbGVzIjpbIkdyb3VwLkFkbWluIiwiWC1FbnRpZGFkLjEiLCJYLUNsaWVudE5hbWUud2FsbGV0QWRtaW4iXSwic3ViIjoiYWE2YjIxMWItNWZkMy00NTNiLWIzMGQtMDgzM2EzMTgwNTliIiwidGlkIjoiNjFlZjViODktOGRmMy00OTlkLThjMTMtMzhmZWQ1ZDA5YzcyIiwidXRpIjoiTHF4WEx3ZGtmMDZVTmJTMmRLaGRBQSIsInZlciI6IjIuMCJ9.YB4sru_Ek5ZfCPMtoJkDJd3WuiNLB0Z5UK_24EE7nriBCR6SZ6GAjqHehPoJKskQnasEtbn98gkw8DLp7RXk7jO3JH3kloNYSL_1e6CGslOc-2lruTD3EPw9wBkryYqHqwPXzkIsxRCLfsc-ZWbZb3jTcmofYq9B1anbUqbFUHX8JRy3O67X45iqF9tnIsjfvFW2AtBIT5QhSnQCW0nr8IeFL9pvW9emmx3UARJ8zccxN09PNANehp40Rd_aTR_IjfiZhNSc2x9YreO-nWO4_OinE75Zt1At-Slql3ISLfa_BvGoLcS4-XtrNe7VNzmOGaSe3_YjKBRKMvWIgApCTg' \
--header 'Content-Type: application/json' \
--data '{
    "idTipoComprobante": 357,
    "idCuenta": 274931,
    "importe": 100,
    "referencia": "Recarga",
    "idComprobanteRelacionado": null,
    "idExterno": "123",
    "fechaExterna": "2024-09-03"
}'

Response

id int
Identificador del comprobante creado.

Ejemplo de response

HTTP 201

Creación exitosa

Copy code

HTTP 201

Creación exitosa

Copy code

HTTP 201

Creación exitosa

Copy code

HTTP 422

Tipo de comprobante inválido

Copy code

HTTP 422

Tipo de comprobante inválido

Copy code

HTTP 422

Tipo de comprobante inválido

Copy code

HTTP 422

Cuenta inválida

Copy code

HTTP 422

Cuenta inválida

Copy code

HTTP 422

Cuenta inválida

Copy code

HTTP 422

idExterno inválido

Copy code

HTTP 422

idExterno inválido

Copy code

HTTP 422

idExterno inválido

Copy code

Descripción

Endpoint

Request

Ejemplo de request

Response

Ejemplo de response

API REFERENCE

Filtrar por producto:

QR ESTÁTICO

QR DINÁMICO

REC. X TRANSFERENCIA

BOTÓN SIMPLE

DISPOSITIVO POS

WALLET / PSP

Autenticación

Cobrar con QR estático

Cobrar con QR dinámico

Cobrar con botón de pagos

Cobrar con transferencia

Comercio

Comprobantes

Operaciones

Webhooks

Archivos batch

API REFERENCE