Summa icon

Summa

Consume Summa API (v.0.1.7)

Actions182

Overview

The "Cancel Sim Swap" operation in the Summa node allows users to cancel an ongoing or pending SIM swap process identified by a specific ICC ID. This is useful in scenarios where a SIM swap was initiated but needs to be aborted due to errors, changes in user request, or security concerns.

Practical examples include:

  • A telecom operator reversing a SIM swap request after detecting suspicious activity.
  • Customer support cancelling a SIM swap when the customer changes their mind.
  • Automated workflows that validate conditions before allowing a SIM swap to proceed and cancel if conditions are not met.

Properties

Name Meaning
From Icc Id The ICC ID (Integrated Circuit Card Identifier) of the SIM card from which the SIM swap cancellation should be performed. This is a required string input.

Output

The output JSON structure is not explicitly detailed in the provided code snippet. However, based on typical API interaction patterns and the context of this node:

  • The json output likely contains the response from the Summa API regarding the cancellation request status.
  • It may include fields such as success confirmation, error messages, or details about the cancelled SIM swap.
  • There is no indication that binary data is returned by this operation.

Dependencies

  • Requires an active connection to the Summa API via an API key credential (referred generically as "an API key credential").
  • The node depends on internal helper classes for HTTP requests, state management, and operation resolution.
  • Proper configuration of the Summa API credentials within n8n is necessary for successful execution.

Troubleshooting

  • Common Issues:

    • Invalid or missing ICC ID: Ensure the "From Icc Id" property is correctly set and corresponds to an existing SIM card.
    • Authentication failures: Verify that the API key credential is valid and has the necessary permissions.
    • Network or connectivity issues with the Summa API endpoint.
  • Error Messages:

    • Errors related to invalid ICC ID or non-existent SIM swap requests typically indicate incorrect input or state.
    • Authentication errors suggest problems with the API key or credential setup.
    • Timeout or network errors require checking connectivity and API availability.

Resolving these usually involves verifying input parameters, reconfiguring credentials, and ensuring stable network access.

Links and References

  • Summa API official documentation (refer to your organization's API docs for detailed endpoint behavior).
  • n8n documentation on creating and managing API credentials.
  • General information on SIM swap processes in telecommunications.

Discussion