{"_id":"@boncos.io/sentoo-directus-extension","_rev":"2-3f1f7a5dfa7c9c66ef1d62c441b91691","name":"@boncos.io/sentoo-directus-extension","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@boncos.io/sentoo-directus-extension","version":"1.0.0","keywords":["directus","directus-extension","directus-extension-bundle","sentoo","payment","payment extension","boncos","boncos aruba"],"author":{"name":"Boncos.io"},"license":"MIT","_id":"@boncos.io/sentoo-directus-extension@1.0.0","maintainers":[{"name":"boncos_software","email":"israelposner@boncos.io"}],"homepage":"https://github.com/boncos-io/sentoo_directus_extension#readme","bugs":{"url":"https://github.com/boncos-io/sentoo_directus_extension/issues"},"dist":{"shasum":"cab76f35c75a68366c4ba871bd4873170f202471","tarball":"https://registry.npmjs.org/@boncos.io/sentoo-directus-extension/-/sentoo-directus-extension-1.0.0.tgz","fileCount":4,"integrity":"sha512-Lv1D5muqM4Sg8NTkNbXbXx3qKccq73wStpqucSTScgUKbnrp2qb4aCdoqUdMiMQUoUBLjvCU6Rw93R+0l1C8qw==","signatures":[{"sig":"MEQCIDVgfO0UjB7/yyOiJidCwhLg+EO6lM290oyVvrOsbNK2AiAtWAbS3JCAmJh7gFpuujQf+zuk6zc7bO0p9bKt7hhaWQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1570005},"icon":"extension","type":"module","gitHead":"8f9119d916a4d7a890b5e7bede339ad1df0238a3","private":false,"scripts":{"add":"directus-extension add","dev":"directus-extension build -w --no-minify","link":"directus-extension link","build":"directus-extension build","validate":"directus-extension validate"},"_npmUser":{"name":"boncos_software","actor":{"name":"boncos_software","type":"user","email":"israelposner@boncos.io"},"email":"israelposner@boncos.io"},"overrides":{"vite":"6.3.5","brace-expansion":"2.0.2"},"repository":{"url":"git+https://github.com/boncos-io/sentoo_directus_extension.git","type":"git"},"_npmVersion":"11.4.2","description":"A Directus extension that integrates Sentoo, allowing seamless payment processing by creating transactions directly in a dedicated transaction table.","directories":{},"_nodeVersion":"22.13.1","dependencies":{"express":"^5.1.0","liquidjs":"^10.21.1"},"_hasShrinkwrap":false,"devDependencies":{"vue":"^3.5.17","pino":"9.7.0","typescript":"^5.8.3","@types/node":"^24.0.3","@directus/types":"13.1.2","@directus/errors":"^2.0.1","@directus/extensions":"3.0.6","@directus/extensions-sdk":"13.1.1"},"directus:extension":{"host":"^10.10.0","path":{"api":"dist/api.js","app":"dist/app.js"},"type":"bundle","entries":[{"name":"sentoo-directus-extension-bootstrap-hook","type":"hook","source":"src/hooks/bootstrap/index.ts"},{"name":"directus-extension-pay-with-sentoo","type":"operation","source":{"api":"src/operations/pay/api.ts","app":"src/operations/pay/app.ts"}},{"name":"sentoo-directus-extension-transaction-status-endpoint","type":"endpoint","source":"src/endpoints/transaction-status/index.ts"}]},"_npmOperationalInternal":{"tmp":"tmp/sentoo-directus-extension_1.0.0_1750691124240_0.9286319357111674","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@boncos.io/sentoo-directus-extension","description":"A Directus extension that integrates Sentoo, allowing seamless payment processing by creating transactions directly in a dedicated transaction table.","icon":"extension","version":"1.0.1","license":"MIT","author":{"name":"Boncos.io"},"private":false,"repository":{"type":"git","url":"git+https://github.com/boncos-io/sentoo_directus_extension.git"},"bugs":{"url":"https://github.com/boncos-io/sentoo_directus_extension/issues"},"homepage":"https://github.com/boncos-io/sentoo_directus_extension#readme","keywords":["directus","directus-extension","directus-extension-bundle","sentoo","payment","payment extension","boncos","boncos aruba"],"type":"module","directus:extension":{"type":"bundle","path":{"app":"dist/app.js","api":"dist/api.js"},"entries":[{"type":"hook","name":"sentoo-directus-extension-bootstrap-hook","source":"src/hooks/bootstrap/index.ts"},{"type":"operation","name":"directus-extension-pay-with-sentoo","source":{"app":"src/operations/pay/app.ts","api":"src/operations/pay/api.ts"}},{"type":"endpoint","name":"sentoo-directus-extension-transaction-status-endpoint","source":"src/endpoints/transaction-status/index.ts"}],"host":"^10.10.0"},"scripts":{"build":"directus-extension build","dev":"directus-extension build -w --no-minify","link":"directus-extension link","validate":"directus-extension validate","add":"directus-extension add"},"devDependencies":{"@directus/errors":"^2.0.1","@directus/extensions":"3.0.6","@directus/extensions-sdk":"13.1.1","@directus/types":"13.1.2","@types/node":"^24.0.3","pino":"9.7.0","typescript":"^5.8.3","vue":"^3.5.17"},"dependencies":{"express":"^5.1.0","liquidjs":"^10.21.1"},"overrides":{"vite":"6.3.5","axios":"1.12.0","brace-expansion":"2.0.2"},"gitHead":"b94aff315a19740091ed37732d20adf1398e7cd1","_id":"@boncos.io/sentoo-directus-extension@1.0.1","_nodeVersion":"22.21.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-NM4THDmGop2dtzLai5UtrmV/cwWxfpUWhgcX/dvfUoxxMUx96vyDRRmfuoGooKYAtW8Fem0/1cr41TZgJECF/w==","shasum":"bd23c3ab558e46d0c8ebe68c1042f83523e5e1e8","tarball":"https://registry.npmjs.org/@boncos.io/sentoo-directus-extension/-/sentoo-directus-extension-1.0.1.tgz","fileCount":4,"unpackedSize":1297860,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCZB0QNWC4codK+6TTm/IyiU4B+7ZcnaZVIprgUJSP5lgIhAIe8VdaNukIo5HJLi0lXV8NBCm/NwUmAFH09zxZ/eT31"}]},"_npmUser":{"name":"boncos_software","email":"israelposner@boncos.io"},"directories":{},"maintainers":[{"name":"boncos_software","email":"israelposner@boncos.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sentoo-directus-extension_1.0.1_1769875427004_0.6198653643591199"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-23T15:05:24.087Z","modified":"2026-01-31T16:03:47.353Z","1.0.0":"2025-06-23T15:05:24.574Z","1.0.1":"2026-01-31T16:03:47.196Z"},"bugs":{"url":"https://github.com/boncos-io/sentoo_directus_extension/issues"},"author":{"name":"Boncos.io"},"license":"MIT","homepage":"https://github.com/boncos-io/sentoo_directus_extension#readme","keywords":["directus","directus-extension","directus-extension-bundle","sentoo","payment","payment extension","boncos","boncos aruba"],"repository":{"type":"git","url":"git+https://github.com/boncos-io/sentoo_directus_extension.git"},"description":"A Directus extension that integrates Sentoo, allowing seamless payment processing by creating transactions directly in a dedicated transaction table.","maintainers":[{"name":"boncos_software","email":"israelposner@boncos.io"}],"readme":"# Directus Sentoo Extension by Boncos\n\n> **Note:** This extension is a **third-party integration** developed by Boncos and is **not an official Sentoo plugin**. It is **not built, endorsed, or supported by Sentoo**.  \n> You must have an **active Sentoo merchant account** to use this integration, as access to production API credentials is only granted under contract with Sentoo.  \n> **Sentoo does not provide support for this extension.** For support, please contact the extension maintainers.\n\nThis Directus extension integrates **Sentoo**, an online payment platform for the Dutch Caribbean, directly into your Directus instance.\n\n## What is Sentoo?\n\n**Sentoo** is a digital payment platform designed for the Dutch Caribbean, enabling businesses and consumers to make secure, real-time payments directly from their bank accounts. Sentoo provides a seamless checkout experience, allowing users to pay online without the need for credit cards. The platform supports instant payments, is widely adopted by local banks, and is focused on providing a safe, efficient, and user-friendly payment solution for the region.  \nLearn more at [sentoo.io](https://sentoo.io).\n\n## Features\n\n- Integrates Sentoo payment gateway with Directus.\n- Provides custom payment fields and status tracking.\n- Allows payment triggering via flows.\n- Automatically installs database tables for transaction management.\n\n## Sentoo Settings\n\nAfter installation, you can configure the extension in the Directus settings panel under **Sentoo Settings**.\n\n![Sentoo Settings](https://raw.githubusercontent.com/boncos-io/sentoo_directus_extension/main/extension/readme_images/sentoo_configure_directus_settings.png)\n\nThese include:\n\n- **API Host**: The Sentoo API endpoint to use.\n- **Merchant Id** and **Secret**: Your merchant credentials provided by Sentoo.\n- **Default Currency**: The default currency.\n- **Default Return Url**: The default return url.\n\n## Installed Tables\n\nWhen the extension is installed, the following data models are added to your Directus project:\n\n![Sentoo Tables](https://raw.githubusercontent.com/boncos-io/sentoo_directus_extension/main/extension/readme_images/sentoo_data_models.png)\n\n- `sentoo_meta_info`: Contains metadata such as the extension version.\n- `sentoo_transactions`: Stores all transaction records and states.\n\n## Usage\n\nTo initiate payments, use the **\"Pay with Sentoo\"** operation available in the flows builder.\n\n### Operation Options\n\n- **Amount**: The amount to charge (required).\n- **Currency**: The currency type to use (optional). Leave empty to use the default currency.\n- **Description**: Shown to the user in the Sentoo payment page (required).\n- **Return Url**: URL to redirect after payment completion (optional). Leave empty for default behavior url.\n- **Customer Id**: Optional customer identifier for tracking purposes.\n- **Expiration Time**: (Optional) Provide an expiry date for the transaction in a valid ISO 8601 format (including the timezone offset from UTC). For example, 2023-06-23T02:56:00-04:00. If not provided, the transaction will expire 1 hour after creation. The maximum expiration date is 1 year from now.\n\nThese options support dynamic templating using Directus flow context variables, for example:\n\n- `{{$trigger.payload.amount}}`\n- `{{$last.value}}`\n- `{{operation_key.value}}`\n- Static values like `\"2971234567\"` or `\"Payment for invoice #123\"`\n\n### Operation Setup Example\n\nBelow is an example showing how to configure the operation inputs using values from the trigger payload in the data chain:\n\n![Pay with Sentoo Operation Setup](https://raw.githubusercontent.com/boncos-io/sentoo_directus_extension/main/extension/readme_images/sentoo_operation_options.png)\n\n### Example\n\nBelow is a visual example of the **Pay with Sentoo** flow operation in use within a Directus flow:\n\n![Pay with Sentoo Operation](https://raw.githubusercontent.com/boncos-io/sentoo_directus_extension/main/extension/readme_images/sentoo_flow_operation.png)\n\nTo fully integrate Sentoo payments, you should also create a **\"Mark as Paid\"** flow in Directus (see example image below). This flow listens for transaction updates from Sentoo (such as payment success or failure) and updates the relevant order or record status in your application accordingly. This ensures your application reflects the real-time payment status and can handle actions like marking orders as paid, failed, or cancelled.\n\n![Mark as Paid Flow](https://raw.githubusercontent.com/boncos-io/sentoo_directus_extension/main/extension/readme_images/sentoo_mark_as_paid_flow.png)\n\n### Result\n\nThe operation adds a `sentoo_transactions` entry and outputs the result under the key defined in the operation block.\n\nRefer to the Directus documentation for more on flow operations and data output.\n","readmeFilename":"README.md"}