PaperCut Integration
Papercut is connected with 3DPrinterOS via API by these fields:
3DPrinterOS user email = Papercut account owner username/email
User’s state of balance - updated in 3DPrinterOS every 10 minutes and right before processing the transaction
Private 3DPrinterOS key, which confirms the right to send PaperCut API calls
When the user does the transaction in the 3DPrinterOS cloud, a separate request is sent to Papercut. Request includes:
User email
Transaction Amount
Comment - 3DPrinterOS transaction comment
The transaction is done when the user sends a job to the queue.
[getUserAccountBalance] The current state of balance is checked to see if there are enough funds to pay for the job. The API call is sent to PaperCut to get the user’s balance
[adjustUserAccountBalanceIfAvailable] Balance is reduced for the job price if there are enough funds
If the job was canceled/aborted/failed, the user would be refunded.
The amount is determined like this:
Refund amount = [Job cost] x [100% - % of job completion]
For example, If a $100 job was completed for 99% and then canceled, the user receives a $1 refund.
The organization admins can change the cost of the job. A new transaction takes place, and the user's balance is reduced by the determined amount.
It is possible to disable automatic refunds for the organization. Then, the admin can determine the refund amount themselves.
A link to Papercut is added to the top-right menu to provide fast access to the student's account.
If you're looking for other 3rd party payment provider integration –> contact sales@3dprinteros.com
If the PaperCut balance does not show in 3DPrinterOS
3DPrinterOS finds the PaperCut account by email, so the user's 3DPrinterOS email has to match the PaperCut account owner's username or email. The balance refreshes every 10 minutes and again right before a print job is charged.
If the balance never updates for anyone in your organization, the 3DPrinterOS Cloud usually cannot reach your PaperCut server. Your IT team needs to allow our server through the firewall to the PaperCut server's port (9192 in a recent case). Contact 3DPrinterOS support for the server address to allow.
Students. You cannot fix a PaperCut connection from your account. Ask your 3D printing lab administrator to check the PaperCut setup for your organization.