Identity Authenticator Service Template

A new open repository has been published that simplifies the creation of new identity authenticator services on the TAG Neuron® to customize KyC. The repository also contains instructions on how to implement such a service, what interfaces to use, and the different steps that need to be completed in order to create an installable package for the service, to distribute it in a Neuron® network.

For more information, see the TemplateIdentityAuthenticator repository on GitHub.

#new, #repository, #neuron, #payments, #id, #kyc

Payment Service Template

A new open repository has been published that simplifies the creation of new payment services on the TAG Neuron®. The repository also contains instructions on how to implement such a service, what interfaces to use, and the different steps that need to be completed in order to create an installable package for the service, to distribute it in a Neuron® network.

For more information, see the TemplatePaymentService repository on GitHub.

#new, #repository, #neuron, #payments

Neuro-Checkout Demo

A demo-package is now available for demonstrating and testing the Neuro-Checkout™, availble on your Neuron®. To view the demo, install the following package on your Neuron®:

Some more information
Package	TAG.NeuroCheckoutDemo.package
Installation key	EkMCng7rNmWDL5RVdVRmRW6B6ZB83Oc/Dcmyn+cU5yGjCr2rw2kq22vePMUZvCPs3o87lYzrDYIA12e7069beeb8fd9d9182b566e41c7932
More information	https://github.com/Trust-Anchor-Group/NeuroCheckoutDemo

#new, #repository, #neuron, #payments, #features

Integrating an external payment service with a Neuron

You can integrate an external payment service with a TAG Neuron® in several ways. You can choose to integrate it with a service module you install on the TAG Neuron®. Or you can implement an API in the external payment service, to allow it to be integrated using an already existing service module in the Neuron® called Paiwise. This article describes the steps necessary to implement this light-weight API.

Configuration on the Nueron

The first step is to install the Paiwise.Internal.package on the Neuron®. Following is some information regarding this package:

Some more information
Package	Paiwise.Internal.package
Installation key	Q1a8tCfisc2z4IJ1aqTohsjYBe2kD1EZLCyrG0A4ZfQvPMHdOjMKQ/2sEppwXZaiR93k3oQelugA67e770167db44c319088bf1d26a4248e
Configuring Service	/Settings/Paiwise.md on the Neuron® on which the service is installed.
API Documentation	https://lab.tagroot.io/Settings/PaiwiseApi.md (or similar on the Neuron® on which the service is installed).

Once the package is installed, you will find a link to the configuration page in the Software section of the Admin page. You can also enter it manually as a URL, from the link above. On the configuration page, you setup a Token, configured for the Neuron®. This token will be provided in calls to the external service, and help identify the Neuron® to the service (together with multual TLS). You also configure a domain name for the host of the external payment service, as well as a timeout parameter.

Security

All requests made to the external payment service will be made using HTTPS. The Neuron® will validate the name of the payment service, by validating the server certificate of the external service.

In requests made to the external payment service, the token will be provided in a Bearer HTTP header. This token should be seen as an API key, and does not change. It provides very little security.

To validate the identity of the Neuron®, the payment service should use Mutual TLS. If enabled, the Neuron® will send the public part of its server certificate in the request, enabling the external payment service to validate the origin of the call, and make sure the caller has the right to use the associated token.

Host

The host name is the domain name of the server hosting the service. All API calls will be made to this host name. When listing resources for the API below, it will be assumed they are prefixed by https://HOSTNAME, where HOSTNAME is replaced by the domain name provided here.

API

Once the service has been installed and configured, payment services implemented on the external payment service will be provided to users connected to the Neuron®, as long as the external payment service implements the Paiwise API, as described in the API documentation of the service. You can find a link to the API documentation on the configuration page. You can also type the URL manually into the browser, using the URL above.

#api, #documentation, #payments

Creating script-based payment services

You can now use script to create service integrations where earlier C#/.NET was requred. By installing the TAG.ScriptProviders.package, available in the Packages page in the Admin menu, you can easily create such integrations. You can also use the package to create mock services for testing. You will need to provide a key when installing. Use the following public key:

Some more information
Package	TAG.ScriptProviders.package
Installation key	lXIkgFyVhmHhjxSqtGUtgmRkqXV2xHkojl0vaz+RPWNvoycZR4dEzdAnKFemiA6KvakEb9r6juSAf3b1986aba9c6d9e3b7803981660dc55
More information	https://github.com/Trust-Anchor-Group/NeuronScriptProviders

Example

The following example creates a mock payment service for buying eDaler®, available here on the lab.tagroot.io Neuron®. It is provided in a .config file, in the ProgramDatafolder. (The repository contains more information and explanations of how the service works.) You can try the service if you have an ID application connected to this Neuron®.

<?xml version="1.0" encoding="utf-8"?>
<ServiceConfiguration xmlns="http://waher.se/Schema/ServiceConfiguration.xsd">
	<StartupScript>
		<![CDATA[
		BuyEDalerService(
		\{
			"Id":"Mock",
			"Name":"Mock payment service",
			"IconUrl":"https://upload.wikimedia.org/wikipedia/en/6/62/Kermit_the_Frog.jpg",
			"IconWidth":282,
			"IconHeight":353,
			"ContractTemplateId":"2bfab592-1c24-d090-7419-d51e36f8377f@legal.lab.tagroot.io",
			"Supports":(Currency)->true,
			"CanBuyEDaler":(AccountName)->true,
			"GetOptions":(Request)->
			(
				Sleep(2000);
				[
					\{
						"Account":"Account 1",
						"Message":"First"
					\},
					\{
						"Account":"Account 2",
						"Message":"Second"
					\},
					\{
						"Account":"Account 3",
						"Message":"Third"
					\}
				]
			),
			"BuyEDaler":(Request)->
			(
				Sleep(5000);
				Error("Kermit took all the money and ran.")
			)
		\});
		]]>
	</StartupScript>
</ServiceConfiguration>

#new, #features, #neuron, #payments, #repository