--- id: orders title: "Webhooks for orders" sidebar_label: "Orders" hide_title: true description: "Webhooks related to orders" --- import Ingress from "../../src/components/ingress/ingress.react"; These webhooks are related to the order creation and order management flows. ## Events ### walley:order:created This webhook is triggered whenever an order is created. This can happen because a customer completed a checkout session, or because an authorization using the tokenized flow was successful, or an AddInvoice was done in the Payment API. ```json { "Type": "walley:order:created", "Timestamp": "2024-01-30T11:02:42.5997621+01:00", "Payload": { "OrderId": "45e0832b-0b32-43e4-99b2-b10700a58a04", "Reference": "MX_220921_111434", "Amount": 30, "Currency": "SEK", "Status": "Authorized", "AuthorizationId": "c31e9218-6a19-4b2f-8992-affc9dca1c41", "CustomerToken": "0a96881b-295a-4154-a867-865fc912619c", "CheckoutId": "c4ebf700-db4a-4194-bae6-4c750f6a6291" } } ``` The `Status` property can have the different states - OnHold - Authorized - Captured - RequiresSigning - RequiresIdentityCheck ### walley:order:authorized This webhook is triggered if an order that was previously `OnHold` is now accepted by Walley. As such, this can only occur for orders created with status `OnHold`. ```json { "Type": "walley:order:authorized", "Timestamp": "2024-01-30T11:02:42.5997621+01:00", "Payload": { "OrderId": "45e0832b-0b32-43e4-99b2-b10700a58a04", "Reference": "MX_220921_111434", "Amount": 10, "Currency": "SEK" } } ``` ### walley:order:rejected This webhook is triggered if an order that was previously `OnHold` is now rejected by Walley. As such, this can only occur on orders created with status `OnHold`. ```json { "Type": "walley:order:rejected", "Timestamp": "2024-01-30T11:02:42.5997621+01:00", "Payload": { "OrderId": "45e0832b-0b32-43e4-99b2-b10700a58a04", "Reference": "MX_220921_111434", "Amount": 10, "Currency": "SEK" } } ``` ### walley:order:reauthorized This webhook is triggered whenever items are changed on an order. This can happen because a call has been made to the reauthorize API, or items have been edited in the Merchant Hub, or a ReplaceInvoice was done in the Payment API. ```json { "Type": "walley:order:reauthorized", "Timestamp": "2024-01-30T11:02:42.5997621+01:00", "Payload": { "OrderId": "45e0832b-0b32-43e4-99b2-b10700a58a04", "Reference": "MX_220921_111434", "Amount": 10, "OriginalAmount": 20, "Currency": "SEK" } } ``` _This only affects the uncaptured amount left on an order._ ### walley:order:extended This webhook is triggered whenever an expired order is authorized again. This can happen because an order is extended in the Merchant Hub. ```json { "Type": "walley:order:extended", "Timestamp": "2024-01-30T11:02:42.5997621+01:00", "Payload": { "OrderId": "45e0832b-0b32-43e4-99b2-b10700a58a04", "Reference": "MX_220921_111434", "Amount": 10, "Currency": "SEK" } } ``` The `Amount` property is equal to the previously expired amount on the order. ### walley:order:captured This webhook is triggered whenever a capture is made on an order. This can happen because a call has been made to the capture API, or a capture is made in the Merchant Hub, or a PartActivateInvoice/ActivateInvoice was done in the Payment API. ```json { "Type": "walley:order:captured", "Timestamp": "2024-01-30T11:02:42.5997621+01:00", "Payload": { "OrderId": "45e0832b-0b32-43e4-99b2-b10700a58a04", "Reference": "MX_220921_111434", "CaptureId": "147819779", "Amount": 10, "AmountLeftToCapture": 20, "Currency": "SEK", "CorrelationId": "fcc702a1-f18f-4e24-a54e-7aad1c716494" } } ``` ### walley:order:refunded This webhook is triggered whenever a refund is made on an order. This can happen because a call has been made to the refund API, or a refund is made in the Merchant Hub. ```json { "Type": "walley:order:refunded", "Timestamp": "2024-01-30T11:02:42.5997621+01:00", "Payload": { "OrderId": "45e0832b-0b32-43e4-99b2-b10700a58a04", "Reference": "01478520", "RefundedAmount": 10, "RemainingAmount": 20, "Currency": "SEK", "ActionReference": "MERCHANT_HUB", "CorrelationId": "fcc702a1-f18f-4e24-a54e-7aad1c716494" } } ``` ### walley:order:canceled This webhook is triggered whenever an order is canceled. This can happen because a call has been made to the cancel API, or an order is canceled in the Merchant Hub, or a CancelInvoice was done in the Payment API. ```json { "Type": "walley:order:canceled", "Timestamp": "2024-01-30T11:02:42.5997621+01:00", "Payload": { "OrderId": "45e0832b-0b32-43e4-99b2-b10700a58a04", "Reference": "MX_220921_111434", "Amount": 10, "Currency": "SEK" } } ``` The `Amount` property is equal to the uncaptured amount left on the order when it was canceled. ### walley:order:expired This webhook is triggered when the `expiresAt` date on the order has passed. This only occurs if the order has uncaptured amount left when the `expiresAt` date passed. ```json { "Type": "walley:order:expired", "Timestamp": "2024-01-30T11:02:42.5997621+01:00", "Payload": { "OrderId": "45e0832b-0b32-43e4-99b2-b10700a58a04", "Reference": "MX_220921_111434", "Amount": 10, "Currency": "SEK" } } ``` The `Amount` property is equal to the uncaptured amount left on the order. ### walley:order:service-invoice-paid This webhook is triggered when an order with the payment method service invoice has been fully paid. After this webhook, the order will be settled. ```json { "Type": "walley:order:service-invoice-paid", "Timestamp": "2024-01-30T11:02:42.5997621+01:00", "Payload": { "OrderId": "45e0832b-0b32-43e4-99b2-b10700a58a04", "Reference": "01478520", "Currency": "SEK" } } ``` ### walley:order:advance-invoice-paid This webhook is triggered when an order with the payment method advance invoice has been fully paid. After this webhook, it is possible to capture the order. ```json { "Type": "walley:order:advance-invoice-paid", "Timestamp": "2024-01-30T11:02:42.5997621+01:00", "Payload": { "OrderId": "45e0832b-0b32-43e4-99b2-b10700a58a04", "Reference": "01478520", "Currency": "SEK" } } ``` ### walley:order:sold-debt This webhook is triggered when a service invoice order can be sold to debt collection. ```json { "Type": "walley:order:sold-debt", "Timestamp": "2026-05-12T11:02:42.5997621+01:00", "Payload": { "OrderId": "45e0832b-0b32-43e4-99b2-b10700a58a04", "Reference": "01478520" } } ```