Guidelines for handling the pending status for Walley invoices

These instructions apply specifically to Walley’s payment method, especially the Walley B2B invoice.
A Pending status means the final status of the payment has not yet been confirmed — it is awaiting approval or rejection after additional processing. This status can occur in situations such as:

  • Fraud prevention check is in progress – either automatic or manual, this can take anywhere from a few seconds up to 24 hours.
  • Invoice requires manual activation – occurs if the manualInvoiceActivation parameter is used. This can also apply to Walley’s standard consumer invoices.

Actions required by the online store

  • Correctly identify the pending status – the order should remain open until the final status is confirmed.
The online store must recognize the pending status and keep the orders open

The payer should receive clear instructions stating that the payment has been provisionally accepted, but is still awaiting final confirmation.

When a pending case occurs, the payer is redirected to the success redirect URL, which includes a status parameter with the value "pending". Based on this, the online store should display a message to the payer explaining that the payment was initially successful but is still under review.

The final approval or rejection is handled by the invoicer, and neither the online store nor the payment service provider has control over the outcome. The fraud prevention check may take from a few minutes to 24 hours.

  • Use callbacks to automatically update the final payment status.
Callback system and status updates

Implementing callbacks is essential if the online store wants to automatically receive updates when the pending status changes.

Once the pending status is processed, Paytrail sends a callback to the online store with the final status of the payment. This enables the store to update order status and automate customer communication.
  • OK (paid) → Callback to online store → Order marked as successful → Order confirmation sent to customer.
  • FAIL (failed) → Callback to online store → Order marked as failed → Customer is notified the order did not go through and is encouraged to try another payment method..

Best Practices

  • Redirect the buyer to a page in the online store that explains the payment is under review and confirmation will be sent once it’s processed.
  • Update the order system to match the final payment status, enabling automated communication with the customer.
  • Automatically send an order confirmation once the status updates to successful (if callback URL is used). Alternatively, notify the customer of a failed order if the payment fails and a FAIL-callback is received.
Was this article helpful?
0 out of 0 found this helpful