SKY API - Payments API Sample App

Server

Run locally:

• Download and install .NET Core SDK
• Open Terminal/Command Prompt and type:

$  git clone https://github.com/blackbaud/payments-api-sample.git
$  cd payments-api-sample/server/dotnet-blazor

• Duplicate appsettings.json-sample as appsettings.Development.json and fill in the missing values (all required).

{
    "AppSettings": {
        "AuthClientId": "<Your developer app ID>",
        "AuthClientSecret": "<Your developer app secret>",
        "AuthRedirectUri": "https://localhost:5001/auth/callback",
        "GeneralSubscriptionKey": "<Your Standard subscription key>",
        "PaymentsSubscriptionKey": "<Your Payments subscription key>"
    }
}

• Open Terminal/Command Prompt and type:

dotnet restore

• On a Mac, type:

export ASPNETCORE_ENVIRONMENT=Development && dotnet run

• On a PC, type:

set ASPNETCORE_ENVIRONMENT=Development && dotnet run

Visit https://localhost:5001/

Client

Run locally

To serve the static html client code locally, the easiest option is to use http-server and ngrok. http-server will serve the static content for access in the browser, while ngrok will allow use of SSL, which is required to use Blackbaud Checkout.

• Navigate into directory

cd client/html

• Run http-server

npx http-server .

• Run ngrok

ngrok http http://localhost:8080

• Access page at url provided by ngrok, i.e., https://0759-98-214-92-44.ngrok-free.app