Kadmos, the seafarer payment solution, is integrated with Martide’s Payroll feature. Here’s how to use it.
How to Configure Kadmos
Before you start using Kadmos, you need to make sure the integration is configured.
Click on Settings under your profile icon > Kadmos
When you click on Kadmos, you will go to this page:
Enter your Client ID and the Secret Key provided by Kadmos and toggle the Enabled switch to turn on the integration. A grey switch is off, a blue switch is on.
Click the Test Connection button to check the credentials are correct and then click Save.
How to Enable Kadmos Coupon Packages
Coupon Packages are currently created on Kadmos’s side. You can control whether Martide is allowed to attach Coupon Packages when it pushes a payment to Kadmos.
Click on Settings > Payroll Settings. You will go to this page:
Toggle the Enable Kadmos Coupon Packages switch to On. A grey switch is off, a blue switch is on.
On: Martide attaches Coupon Packages to the payment.
Off: The payment is pushed without coupons. Note: coupons cannot be added later.
Click Save when you’re done.
Note: You must turn this on before running payroll if you want Coupon Packages to be applied to the disbursement.
How to Check Seafarers Have a Kadmos Account
Before running a payroll, you must confirm that every seafarer who should be paid via Kadmos has an active Kadmos wallet. Seafarers without a wallet (or who have a Rejected status) cannot receive Kadmos payouts.
Go to the Seafarers page by clicking Seafarers in the menu on the left-hand side.
Click the funnel icon in the top right corner to open the filters > go to Kadmos Wallet > open the Kadmos Status dropdown menu and choose one or more filters:
Filters are:
Missing Wallet: these are seafarers who don’t have a linked Kadmos wallet.
Has Kadmos Wallet: these are all seafarers (Active, Rejected, Pending, etc.) who have a linked Kadmos wallet.
Active / Rejected / Pending Seafarer Data / Pending Seafarer Approval / Failed: these are individual seafarer statuses.
When a filter is selected, a Kadmos Wallet column appears on the main page showing each seafarer's status:
How to Link a Kadmos Wallet for Seafarers Showing it’s Missing
For seafarers without a wallet, click Link Wallet in the Kadmos Wallet column. A pop-up box will open and Martide will check against Kadmos to see if a matching account already exists.
There are three possible outcomes:
Matched by Martide Reference ID: Kadmos has a user with the same Martide ID. This is the strongest match and means the wallet was previously created from the seafarer's profile:
Matched by Email: Kadmos has no user with the same reference ID but does have one with the same email address. Check the name on Kadmos and the contract currency before clicking Link this Account. You will be linking to whatever account Kadmos returns for that email:
No Match Found: Kadmos has no user matching by reference ID or email. Paste the Kadmos User ID manually (ID is available in the Kadmos portal). If the seafarer has no Kadmos account, contact Kadmos to create one before continuing:
Once linked, the Kadmos Wallet column updates to reflect the wallet's status (Active, Pending, etc.).
How to Configure Kadmos Allotments on a Payslip
To navigate to a seafarer’s payslip click: Payroll in the main menu on the left > vessel name > seafarer name
Go to the payslip’s Allotments section. Kadmos allotments are next to Bank Transfer allotments.
Kadmos allotments are sent to the Kadmos payment system for processing.
Resolving Kadmos Errors
There can be a few errors that affect Kadmos allotments.
To see them navigate to: Payroll page > vessel name > click the Select All Payslips button > hover your mouse at the top of the screen so the blue bar appears and click the Review Allotments button:
The Review Allotments page shows errors in one view. Filter by the Kadmos tab to see them clearly:
Status | Meaning | Action |
Ready | Allotment is queued and ready to push | Click Push to Kadmos |
Push Failed | The push to Kadmos failed (e.g., insufficient funds in the sender wallet) | Use the resync icon to re-push, or click the row to inspect the error message |
Payout Not Linked | A payout exists in Kadmos but is not yet linked in Martide | Click the link icon to associate the existing payout, or use the cloud icon to replace it with the Martide amount |
Multiple Payouts | Kadmos has more than one payout for this seafarer in this period. Manual resolution required | Open the Kadmos portal, delete duplicates, then resync |
Payout Deleted | The payout was deleted in Kadmos | Re-push to recreate it, or remove the allotment from the batch with the trash icon |
Clicking any Kadmos allotment row opens its details. This shows the allottee, wallet status, and the error message returned by Kadmos:
Kadmos Troubleshooting checklist
Push Failed → Insufficient Funds: top up the sender wallet in Kadmos, then re-push.
Push Failed → KYC Issues: confirm the seafarer’s wallet status on the Seafarers page is Active.
Test Connection Fails in Settings: re-check Client ID and Secret Key in Settings > Kadmos Integration.
Once all allotments are pushed and any Kadmos errors are resolved, move the payslips from Draft to Final. There are two ways to do this:
Finalize a Single Payslip
Open the payslip.
Confirm every allotment in the Allotments section is marked Paid. Finalize is only allowed once all allotments on the payslip are paid
Scroll to the bottom and click Finalize. The payslip status changes from Draft to Final
Finalize in Bulk
If you need to finalize many payslips at once, do it from the payrun detail page:
On the payrun detail page, check the payslip checkboxes or click Select All Payslips.
A bar appears at the top showing the selection count alongside Review Allotments, Add Earnings, Add Deductions, Finalize, and Delete
Click Finalize. All selected payslips will move from Draft to Final.
Once every payslip in a payrun is Final, the payrun is considered complete.