Webhooks

💡 Receive subscription events at your webhook endpoint. Listen for events from your n1co business account at your webhook endpoint so your integration can trigger automatic reactions as events occur in your account.

Event Types:

• From a subscription confirmation event, this information is saved in the billing lite subscription table. A detail of what should be received is provided, and it returns that the record was successfully created.
  • Request:

{
  "subscriptionId": "242",
  "description": "New subscription confirmation",
  "metadata": {
    "SubscriptionLinkId": "352",
    "SubscriptionId": "242",
    "SubscriptionName": "6-80 DTE's Monthly",
    "SubscriptionPrice": "15.00",
    "CancellationReason": "",
    "BuyerName": "Gabriela Guevara",
    "BuyerPhone": "+50372008059",
    "BuyerEmail": "[email protected]",
    "StoreId": "400",
    "SubscriptionStartDate": "2024-12-27T18:03:05.1390139",
    "SubscriptionEndDate": "2025-01-27T18:03:05.1390139",
    "OrderId": "42932",
    "OrderReference": "2222"
  },
  "level": "Info",
  "type": "SubscriptionConfirmation"
}

• From a subscription payment event, this information is saved in the billing lite subscription table, but first, a copy of the previous subscription record is made and saved in a history. A detail of what should be received is provided, and it returns a message of modification/insertion of the subscription record.
• Request:

{
  "subscriptionId": "242",
  "description": "New subscription confirmation",
  "metadata": {
    "SubscriptionLinkId": "352",
    "SubscriptionId": "242",
    "SubscriptionName": "6-80 DTE's Monthly",
    "SubscriptionPrice": "15.00",
    "CancellationReason": "",
    "BuyerName": "Gabriela Guevara",
    "BuyerPhone": "+50372008059",
    "BuyerEmail": "[email protected]",
    "StoreId": "400",
    "SubscriptionStartDate": "2024-12-27T18:03:05.1390139",
    "SubscriptionEndDate": "2025-01-27T18:03:05.1390139",
    "OrderId": "42932",
    "OrderReference":"2222"
  },
  "level": "Info",
    "type": "SubscriptionPayment"
}

• From a subscription cancellation event, an update is made to the status in the billing lite subscription table. A detail of what should be received is provided, and it returns a message of modification of the subscription status.
• Request:

{
  "subscriptionId": "242",
  "description": "New subscription confirmation",
  "metadata": {
    "SubscriptionLinkId": "352",
    "SubscriptionId": "242",
    "SubscriptionName": "6-80 DTE's Monthly",
    "SubscriptionPrice": "15.00",
    "CancellationReason": "",
    "BuyerName": "Gabriela Guevara",
    "BuyerPhone": "+50372008059",
    "BuyerEmail": "[email protected]",
    "StoreId": "400",
    "SubscriptionStartDate": "2024-12-27T18:03:05.1390139",
    "SubscriptionEndDate": "2025-01-27T18:03:05.1390139",
    "OrderId": "42932",
    "OrderReference": "2222"
  },
  "level": "Info",
  "type": "SubscriptionCancelled"
}

• From a successful payment event, this information is saved in the billing lite one-time payments table. A detail of what should be received is provided, and it returns that the record was successfully created.
• Request:

{
  "orderId": "44493",
  "orderReference": "2017",
  "description": "The order was paid successfully authorization: 190714",
  "metadata": {
    "PaymentId": "679ed263-a3ca-4d38-92d5-ccdb4152056c",
    "ChargeId": "e9099ebf-e983-4239-9a93-0a747803ea9c",
    "Status": "SUCCEEDED",
    "AuthorizationCode": "190714",
    "SequentialNumber": "502016000140",
    "AccountId": "hugoapp.h4b",
    "PaymentProcessor": "serfinsa",
    "PaymentProcessorReference": "502016000140",
    "TransactionDate": "2025-01-20T22:00:37.3759051Z",
    "PaidAmount": "25.00",
    "BuyerName": "Gabriela Guevara",
    "BuyerPhone": "+50372008059",
    "BuyerEmail": "[email protected]",
    "CheckoutNote": "N/A",
    "OrderReference": "2017",
    "OrderTotalDetails": {
      "subtotal": "25.0000",
      "shippingAmount": "0.0000",
      "discountAmount": "0",
      "surchargeAmount": "0",
      "total": "25.00"
    },
    "IsManagedPaymentMethod": false,
    "InvoiceName": "",
    "InvoiceAddress": "",
    "InvoiceTaxCode": "C/F",
    "StoreId": "350",
    "BillingPlanId": "4031"
  },
  "level": "Info",
  "type": "SuccessPayment"
}