Upcoming changes to SAM User permissions for viewing Billing & Payment History
We would like to inform customers of the following upcoming changes to the User Console Billing & Payment History screen.
New permissions required
In order to improve the details displayed on the Billing & Payment History screen, the User Console will be updated to retrieve additional information using the Order:listOrders API. Accordingly, SAM Users will be required to have permission to access this API (in addition to existing permissions) in order to continue viewing this section of the User Console.
Once this change has been applied, any SAM User that does not have permission to access the Order:listOrders API will not be able to view any billing and payment details, and will instead see the following error message when viewing the Billing & Payment History screen:
To allow a SAM User to continue viewing the Billing & Payment History screen, you will need to update the SAM User's permission statement to add access to the Order:listOrders API, such as in the following permission statement:
{
"statements": [
{
"effect": "allow",
"api": [
"Order:listOrders"
]
}
]
}Please note:
- The above example only demonstrates permission for a single API. The
Order:listOrdersAPI should be added to a SAM User's existing permissions. - Besides allowing access to the
Order:listOrdersAPI specifically, you can also allow access using wildcards, such asOrder:list*(allow access to all Order APIs that begin withlist),Order:*(allow access to all Order APIs), or*(allow access to all APIs), depending on the level of granularity required. - In addition to updating an individual SAM User's permission statement, you can also provide access to multiple SAM Users by updating the permission statements for a Role, or updating the Default SAM User Permissions.
Please refer to the Access Levels documentation for more details on configuring permission statements.
For users accessing accounts using their root account email address and password, no changes are necessary as root accounts have full permission to access all APIs by default.
Improved payment status information
For business customers located in Japan using payment by invoice, the payment status details displayed in the Payment History section of the Billing & Payment History screen will be updated to reflect the following statuses:
- Delegating to 3rd Party: When Soracom is in the process of transferring the invoice payment to a 3rd party payment provider
- Delegated to 3rd Party: When Soracom has transferred the invoice payment to a 3rd party payment provider
These statuses will be valid for both Usage Charges (payments for monthly services) and Orders (payments for products purchased).
For additional information regarding invoice payments and payment history, please refer to the Checking past usage fees and Downloading usage fee files (CSV, PDF) documentation (Japanese).
Effective date
These updates are scheduled to take effect on November 8, 2023.
Please note that the effective date may change without prior notice.
If you or members of your organization currently use SAM Users to view the Billing & Payment History screen, we recommend updating your SAM User permission statements (or requesting the owner of your Soracom account to do so) according to the details above as needed, in order to avoid unexpected errors.
If you have any questions or concerns, please don't hesitate to contact the Soracom Support team.
