Direct payment

- a pseudo payment provider, developed by Litium for testing and direct cash handling tasks.

Direct Payment is a reengineered version of the DirectPay extension for Litium 8 and later. It can be used for:

1. Simulating a payment provider, without having to configure a real one! This could be useful until you get your accounts configured from a real payment provider.
2. Allowing the e-commerce administration to place orders and collect money manually.
3. Custom implementation, for example, to place the purchase order into your ERP system.

Version dependencies

• Direct payment app 1.3.0

  • Supports Connect Payments API 1.0

  • Requires Litium 8.6 or later.

Installation

Litium serverless cloud - Use the Cloud CLI to install the app.

Litium legacy cloud - Contact support to install the app in your test and/or production environment.

Local environment - See details below.

Docker template for local installation

Values to replace in the template:

• ports
• environment
  • ASPNETCORE_HTTPS_PORT
  • AppMetadata__AppUrl
  • LitiumApi__ApiUrl

version: '3'
services:
  direct-payment:
    image: registry.litium.cloud/apps/direct-payment:1.4.1
    dns: 
    - 192.168.65.254
    restart: unless-stopped
    ports:
    - "10010:80"
    - "10011:443"
    environment:
    # Enable HTTPS binding
    - ASPNETCORE_URLS=https://+;http://+
    - ASPNETCORE_HTTPS_PORT=10011
    # Configuration for HTTPS inside the container, exported dotnet dev-certs with corresponding password
    - ASPNETCORE_Kestrel__Certificates__Default__Password=${CERT_PWD}
    - ASPNETCORE_Kestrel__Certificates__Default__Path=/https/localhost.pfx
    # Folder for the configuraiton, this is volume-mapped
    - CONFIG_PATH=/app_config
    # Folder where logfiles should be placed, this is volume-mapped
    - APP_LOG_PATH=/logs
    # Don't validate certificates
    - AppConfiguration__ValidateCertificate=false
    # Url to this app
    - AppMetadata__AppUrl=https://customer-app-direct-payment.localtest.me:10011
    # Url to the litium installation
    - LitiumApi__ApiUrl=https://customer.localtest.me:5001
    volumes:
    - ./data/direct-payment/config:/app_config
    - ./data/direct-payment/data:/app_data
    - ./data/direct-payment/logs:/logs
    - ./data/direct-payment/DataProtection-Keys:/root/.aspnet/DataProtection-Keys
    - ./data/https:/https:ro
    

App configuration file

{
  "DirectPay": {
    "PaymentAccounts": [
      {
        "Id": "DirectPay",
        "MerchantAccountId": null,
        "Environment": "Live"
      }
    ]
  }
}

• Id: The payment option id.
• MerchantAccountId: The merchant account identifier. Not currently used.
• Environment: The App environment. It should be "Live" or "Test".