Referencia de Mirakl

Configuración predeterminada para los eventos del conector de Miraki.

Trabajos programados

Onboarding

Command Line
php bin/console connector:sync:onboarding -q 2>&1

Configuración predeterminada: cada minuto.
Configuración recomendada: todo lo posible.
Descripción: recupera las tiendas de Mirakl creadas recientemente y añade el enlace de onboarding a su back office de Mirakl.
Documentación: flujo de trabajo del onboarding.

Validación de pagos

Command Line
php bin/console connector:validate:pending-debit -q 2>&1

Configuración predeterminada: cada 5 minutos.
Configuración recomendada: < 1 hora.
Descripción: recupera los pedidos de Mirakl aceptados recientemente, valida el pago en Mirakl y lo captura en Stripe.
Documentación: flujo de trabajo de validación de pagos.

Desglose de pagos

Command Line
php bin/console connector:dispatch:process-transfer -q 2>&1

Configuración predeterminada: cada 5 minutos.
Configuración recomendada: < 1 hora.
Descripción: recupera los pedidos de Mirakl adeudados recientemente y crea transferencias de Stripe del operador al vendedor.
Documentación: flujo de trabajo de fraccionamiento de pagos.

Reembolso de pagos

Command Line
php bin/console connector:dispatch:process-refund -q 2>&1

Configuración predeterminada: cada 5 minutos.
Configuración recomendada: < 1 hora.
Descripción: recupera los reembolsos pendientes de Mirakl, crea el reembolso en Stripe, lo valida en Mirakl y anula la transferencia inicial.
Documentación: flujo de trabajo de reembolso de pagos.

Transferencia

Command Line
php bin/console connector:dispatch:process-payout -q 2>&1

Configuración predeterminada: cada día a las 13:00 h.
Configuración recomendada: sincronizado con tus ciclos de facturación de Mirakl.
Descripción: recuperar las facturas de Mirakl greadas recientemente y crear los envíos de fondos y transferencias de Stripe.
Documentación: flujo de trabajo de transferencias.

Alertas

Command Line
php bin/console connector:notify:failed-operation -q 2>&1

Configuración predeterminada: cada día a las 8:00 h.
Configuración recomendada: según tus preferencias.
Descripción: si está habilitado, envía un correo electrónico con todos los envíos de fondos, reembolsos y transferencias que han fallado.

Notificación

Si está habilitado, el conector envía notificaciones de servidor a servidor en los siguientes eventos.

Nota

Si tu punto de conexión es inaccesible o devuelve un error, se enviar un correo electrónico a tu TECHNICAL_ALERT_EMAIL.

Cuenta actualizada

Una cuenta conectada de Stripe fue actualizada por el vendedor o por Stripe.

{
  "type": "account.updated",
  "payload": {
    "miraklShopId": 2000,
    "stripeUserId": "acct_1032D82eZvKYlo2C"
  }
}

Envío de fondos fallido

Se ha producido un error con un envío de fondos durante el trabajo de desglose de pagos o el trabajo de transferencia.

{
  "type": "transfer.failed",
  "payload": {
    "internalId": 5,
    "miraklId": 123,
    "type": "TRANSFER_ORDER",
    "stripeAccountId": "acct_1032D82eZvKYlo2C",
    "miraklShopId": 2003,
    "transferId": null,
    "transactionId": null,
    "amount": 3400,
    "status": "TRANSFER_FAILED",
    "failedReason": "Reason message",
    "currency": "EUR"
  }
}

Error en reembolso

Se ha producido un error al hacer un reembolso durante el trabajo de reembolso de pagos.

{
  "type": "refund.failed",
  "payload": {
    "internalId": 5,
    "miraklOrderId": "order_refunded_5",
    "miraklRefundId": "1100",
    "stripeRefundId": null,
    "stripeReversalId": "trr_10",
    "amount": 3400,
    "status": "REFUND_FAILED",
    "failedReason": "Reason message",
    "currency": "EUR"
  }
}

Transferencia fallida

Se ha producido un error en una transferencia durante el trabajo de transferencias.

{
  "type": "payout.failed",
  "payload": {
    "internalId": 12,
    "amount": 2300,
    "currency": "EUR",
    "miraklInvoiceId": 2000,
    "stripePayoutId": null,
    "status": "PAYOUT_FAILED",
    "failedReason": "Reason message",
  }
}