Direct Payment/Shipment setup

Data Cleanup

(If You are working on a new db with no data You can move to the next step)

If You are working on a copy of a client from stage or production, You might need to cleanup apps. Both Direct Payment and Direct Shipment.

Press delete and check Force delete:

Go to Globalization > Channels tab

Remove all occurances of Payment methods and Delivery methods for all countries in all channels.

Install custom developer certificate

Go to https://docs.litium.com/platform/get-started/custom-developer-certificate

Download ca.txt, localhost.txt and generate.ps1 and save in the same folder.

Run the generate.ps1 script as an Admin and go through the setup.

In the root folder of Your project (where the docker-compose.yaml file is visible)

run the following command:

dotnet dev-certs https -ep ./data/https/localhost.pfx -p SuperSecretPassword

inside of the .env file store Your password in this example SuperSecretPassword under

CERT_PWD=SuperSecretPassword

Hit: docker-compose up

Check installation status

Go to the terminal and check what is the return status of nslookup command

nslookup customer.localtest.me 127.0.0.1

It should return some answer, similar to following

Check Your Docker Desktop and make sure that all containers are up and running, if You will see that direct-shipment or direct-payment container is keep restarting, there might be a problem with Your certificate or password that is set up in .env file.

Check ports in docker-compose.yaml both for direct-payment and direct-shipment

The ports should match the default port that Your local setup is using for Litium BO in my case it was 64951, otherwise You won't be able to access app installation tab

https://localhost:64951/litium

Installing the apps

After going through the above steps, You should be able to go in the url from yaml config in my case it was

https://customer-app-direct-shipment.localtest.me:10021 for direct shipment

and https://customer-app-direct-payment.localtest.me:10011 for direct payment

You should see the following image:

press install and You should be able to upload Your configuration for both shipment and payments.

If something will go wrong after this step, check versions of Direct shipment app and Direct payment app, some of the versions might not be compatible with Your version of Litium, try to downgrate or upgrade them

You can do it in the .yaml file, in the image settings:

in my case the version is 1.3.0

registry.litium.cloud/apps/direct-shipment:1.3.0