# API Reference El API de ZRU utiliza métodos HTTP y una estructura RESTful de endpoint. - La autenticación del API se realiza vía Header Authorization. - Todas las peticiones se deben realizar en formato JSON, y las respuestas del API son en dicho formato. Version: 1.0 ## Servers v1 ``` https://api.zrupay.com/v1 ``` ## Security ### AppKeys El header Authorization debe tener como valor AppKeys PUBLIC:SECRET. Los valores PUBLIC y SECRET se obtienen accediendo al panel de ZRU Type: apiKey In: header Name: Authorization ## Download OpenAPI description [API Reference](https://docs.zrupay.com/_spec/apis/index.yaml) ## Transaction ### Listar Transacciones - [GET /transaction/](https://docs.zrupay.com/apis/transaction/get-transactions.md): Devuelve todas las transacciones creadas en el entorno. ### Crear Transacción - [POST /transaction/](https://docs.zrupay.com/apis/transaction/post-transaction.md): Crea una transacción en el entorno. ### Obtener Transacción - [GET /transaction/{transaction-id}/](https://docs.zrupay.com/apis/transaction/get-transaction.md): Devuelve la transacción solicitada. ## Subscription ### Listar Suscripciones - [GET /subscription/](https://docs.zrupay.com/apis/subscription/get-subscriptions.md): Devuelve todas las suscripciones creadas en el entorno. ### Crear Suscripción - [POST /subscription/](https://docs.zrupay.com/apis/subscription/post-subscription.md): Crea una suscripción en el entorno. ### Obtener Suscripción - [GET /subscription/{subscription-id}/](https://docs.zrupay.com/apis/subscription/get-subscription.md): Devuelve la suscripción solicitada. ### Iniciar Suscripción - [POST /subscription/{subscription-id}/start/](https://docs.zrupay.com/apis/subscription/post-subscription-start.md): Inicia la suscripción solicitada, debe estar en espera. ### Pausar Suscripción - [POST /subscription/{subscription-id}/pause/](https://docs.zrupay.com/apis/subscription/post-subscription-pause.md): Pausa la suscripción solicitada, debe estar activa. ### Activar Suscripción - [POST /subscription/{subscription-id}/active/](https://docs.zrupay.com/apis/subscription/post-subscription-active.md): Activa la suscripción solicitada, debe estar en pausa. ### Parar Suscripción - [POST /subscription/{subscription-id}/stop/](https://docs.zrupay.com/apis/subscription/post-subscription-stop.md): Para la suscripción solicitada, después de ejecutar esta acción la suscripción no podrá ser reactivada ni se realizarán cobros. ## Authorization ### Listar Autorizaciones - [GET /authorization/](https://docs.zrupay.com/apis/authorization/get-authorizations.md): Devuelve todas las autorizaciones creadas en el entorno. ### Crear Autorización - [POST /authorization/](https://docs.zrupay.com/apis/authorization/post-authorization.md): Crea una autorización en el entorno. ### Obtener Autorización - [GET /authorization/{authorization-id}/](https://docs.zrupay.com/apis/authorization/get-authorization.md): Devuelve la autorización solicitada. ### Cobrar una Autorización - [POST /authorization/{authorization-id}/charge/](https://docs.zrupay.com/apis/authorization/post-authorization-charge.md): Realiza un cobro utilizando el método de pago autorizado. ### Eliminar una Autorización - [POST /authorization/{authorization-id}/remove/](https://docs.zrupay.com/apis/authorization/post-authorization-remove.md): Elimina una autorización, después de realizar esta acción no se podrá utilizar de nuevo. ## Sale ### Listar Pagos - [GET /sale/](https://docs.zrupay.com/apis/sale/get-sales.md): Devuelve todos los pagos creados en el entorno. ### Obtener Pago - [GET /sale/{sale-id}/](https://docs.zrupay.com/apis/sale/get-sale.md): Devuelve el pago solicitado. ### Capturar Pago - [POST /sale/{sale-id}/capture/](https://docs.zrupay.com/apis/sale/post-sale-capture.md): Captura la parte del pago en espera, total o parcialmente. ### Devolver Pago - [POST /sale/{sale-id}/refund/](https://docs.zrupay.com/apis/sale/post-sale-refund.md): Devuelve la parte del pago capturada, total o parcialmente. ### Liberar Pago - [POST /sale/{sale-id}/void/](https://docs.zrupay.com/apis/sale/post-sale-void.md): Libera la parte del pago en espera, total o parcialmente. ## Product ### Listar Productos - [GET /product/](https://docs.zrupay.com/apis/product/get-products.md): Devuelve todos los productos creados en el entorno. ### Crear Producto - [POST /product/](https://docs.zrupay.com/apis/product/post-product.md): Crea un producto en el entorno. ### Obtener Producto - [GET /product/{product-id}/](https://docs.zrupay.com/apis/product/get-product.md): Devuelve el producto solicitado. ### Editar Producto - [PATCH /product/{product-id}/](https://docs.zrupay.com/apis/product/patch-product.md): Edita el producto solicitado. ### Eliminar Producto - [DELETE /product/{product-id}/](https://docs.zrupay.com/apis/product/delete-product.md): Elimina el producto solicitado. ## Plan ### Listar Planes - [GET /plan/](https://docs.zrupay.com/apis/plan/get-plans.md): Devuelve todos los planes creados en el entorno. ### Crear Plan - [POST /plan/](https://docs.zrupay.com/apis/plan/post-plan.md): Crea un plan en el entorno. ### Obtener Plan - [GET /plan/{plan-id}/](https://docs.zrupay.com/apis/plan/get-plan.md): Devuelve el plan solicitado. ### Editar Plan - [PATCH /plan/{plan-id}/](https://docs.zrupay.com/apis/plan/patch-plan.md): Edita el plan solicitado. ### Eliminar Plan - [DELETE /plan/{plan-id}/](https://docs.zrupay.com/apis/plan/delete-plan.md): Elimina el plan solicitado. ## Tax ### Listar Impuestos - [GET /tax/](https://docs.zrupay.com/apis/tax/get-taxes.md): Devuelve todos los impuestos creados en el entorno. ### Crear Impuesto - [POST /tax/](https://docs.zrupay.com/apis/tax/post-tax.md): Crea un impuesto en el entorno. ### Obtener Impuesto - [GET /tax/{tax-id}/](https://docs.zrupay.com/apis/tax/get-tax.md): Devuelve el impuesto solicitado. ### Editar Impuesto - [PATCH /tax/{tax-id}/](https://docs.zrupay.com/apis/tax/patch-tax.md): Edita el impuesto solicitado. ### Eliminar Impuesto - [DELETE /tax/{tax-id}/](https://docs.zrupay.com/apis/tax/delete-tax.md): Elimina el impuesto solicitado. ## Shipping ### Listar Envíos - [GET /shipping/](https://docs.zrupay.com/apis/shipping/get-shippings.md): Devuelve todos los envíos creados en el entorno. ### Crear Envío - [POST /shipping/](https://docs.zrupay.com/apis/shipping/post-shipping.md): Crea un envío en el entorno. ### Obtener Envío - [GET /shipping/{shipping-id}/](https://docs.zrupay.com/apis/shipping/get-shipping.md): Devuelve el envío solicitado. ### Editar Envío - [PATCH /shipping/{shipping-id}/](https://docs.zrupay.com/apis/shipping/patch-shipping.md): Edita el envío solicitado. ### Eliminar Envío - [DELETE /shipping/{shipping-id}/](https://docs.zrupay.com/apis/shipping/delete-shipping.md): Elimina el envío solicitado. ## Coupon ### Listar Cupones - [GET /coupon/](https://docs.zrupay.com/apis/coupon/get-coupons.md): Devuelve todos los cupones creados en el entorno. ### Crear Cupón - [POST /coupon/](https://docs.zrupay.com/apis/coupon/post-coupon.md): Crea un cupón en el entorno. ### Obtener Cupón - [GET /coupon/{coupon-id}/](https://docs.zrupay.com/apis/coupon/get-coupon.md): Devuelve el cupón solicitado. ### Editar Cupón - [PATCH /coupon/{coupon-id}/](https://docs.zrupay.com/apis/coupon/patch-coupon.md): Edita el cupón solicitado. ### Eliminar Cupón - [DELETE /coupon/{coupon-id}/](https://docs.zrupay.com/apis/coupon/delete-coupon.md): Elimina el cupón solicitado. ## Client ### Listar Clientes - [GET /client/](https://docs.zrupay.com/apis/client/get-clients.md): Devuelve todos los clientes creados en el entorno. ### Crear Cliente - [POST /client/](https://docs.zrupay.com/apis/client/post-client.md): Crea un cliente en el entorno. ### Obtener Cliente - [GET /client/{client-id}/](https://docs.zrupay.com/apis/client/get-client.md): Devuelve el cliente solicitado. ### Editar Cliente - [PATCH /client/{client-id}/](https://docs.zrupay.com/apis/client/patch-client.md): Edita el cliente solicitado. ### Listar IBANs del Cliente - [GET /client/{client-id}/iban/](https://docs.zrupay.com/apis/client/get-client-ibans.md): Devuelve todos los IBANs del Cliente creados en el entorno. ### Crear IBAN del Cliente - [POST /client/{client-id}/iban/](https://docs.zrupay.com/apis/client/post-client-iban.md): Crea un IBAN del Cliente en el entorno. ### Obtener IBAN del Cliente - [GET /client/{client-id}/iban/{iban-id}/](https://docs.zrupay.com/apis/client/get-client-iban.md): Devuelve el IBAN solicitado del Cliente. ### Editar IBAN del Cliente - [PATCH /client/{client-id}/iban/{iban-id}/](https://docs.zrupay.com/apis/client/patch-client-iban.md): Editar el IBAN solicitado del Cliente. ### Listar Documentos del Cliente - [GET /client/{client-id}/document/](https://docs.zrupay.com/apis/client/get-client-documents.md): Devuelve todos los Documentos del Cliente creados en el entorno. ### Crear Documento del Cliente - [POST /client/{client-id}/document/](https://docs.zrupay.com/apis/client/post-client-document.md): Crea un Documento del Cliente en el entorno. ### Obtener Documento del Cliente - [GET /client/{client-id}/document/{document-id}/](https://docs.zrupay.com/apis/client/get-client-document.md): Devuelve el Documento solicitado del Cliente. ## Wallet ### Listar Cuentas de Pago - [GET /wallet/](https://docs.zrupay.com/apis/wallet/get-wallets.md): Devuelve todos las cuentas de pago creadas en el entorno. ### Crear Cuenta de Pago - [POST /wallet/](https://docs.zrupay.com/apis/wallet/post-wallet.md): Crea una cuenta de pago en el entorno. ### Obtener Cuenta de Pago - [GET /wallet/{wallet-id}/](https://docs.zrupay.com/apis/wallet/get-wallet.md): Devuelve la cuenta de pago solicitada. ### Editar Cuenta de Pago - [PATCH /wallet/{wallet-id}/](https://docs.zrupay.com/apis/wallet/patch-wallet.md): Edita la cuenta de pago solicitada. ### Listar Movimientos de la Cuenta de Pago - [GET /wallet/{wallet-id}/entry/](https://docs.zrupay.com/apis/wallet/get-wallet-entries.md): Devuelve todos los movimientos de la cuentas de pago existentes en el entorno. ### Obtener Movimiento de la Cuenta de Pago - [GET /wallet/{wallet-id}/entry/{entry-id}/](https://docs.zrupay.com/apis/wallet/get-wallet-entry.md): Devuelve el movimiento solicitado de la cuenta de pago. ## Transfer ### Listar Transferencias - [GET /transfer/](https://docs.zrupay.com/apis/transfer/get-transfers.md): Devuelve todas las transferencias creadas en el entorno. ### Crear Transferencia - [POST /transfer/](https://docs.zrupay.com/apis/transfer/post-transfer.md): Crea una transferencia en el entorno. ### Obtener Transferencia - [GET /transfer/{transfer-id}/](https://docs.zrupay.com/apis/transfer/get-transfer.md): Devuelve la transferencia solicitada. ## Gateway ### Listar Pasarelas de Pago - [GET /gateway/](https://docs.zrupay.com/apis/gateway/get-gateways.md): Devuelve todas las pasarelas de pago de el entorno. ### Obtener Pasarela de Pago - [GET /gateway/{gateway-id}/](https://docs.zrupay.com/apis/gateway/get-gateway.md): Devuelve la pasarela de pago solicitada. ## Currency Currency ### Listar Monedas - [GET /currency/](https://docs.zrupay.com/apis/currency/get-currencies.md): Devuelve todas las monedas. ### Obtener Moneda - [GET /currency/{currency-id}/](https://docs.zrupay.com/apis/currency/get-currency.md): Devuelve la moneda solicitada.