From 586873ab11e3f5532c0ce1f5dbc30ae444caf063 Mon Sep 17 00:00:00 2001 From: Mike Motteram Date: Wed, 15 Mar 2023 17:29:09 +0000 Subject: [PATCH 1/5] Remove Authorize and Sandbox as they are no longer valid Add Merchant URL to Paysafe Improve accuracy of Documentation --- docs/connectors/connector.md | 124 +++++++++++++++++++++-------------- 1 file changed, 76 insertions(+), 48 deletions(-) diff --git a/docs/connectors/connector.md b/docs/connectors/connector.md index 9f2e82b..6a68bb6 100644 --- a/docs/connectors/connector.md +++ b/docs/connectors/connector.md @@ -57,13 +57,14 @@ Here are the configuration options for each of the connectors for the Payment Pr #### Payment Providers -- [Authorize.net](#authorizenet) +[//]: # (- [Authorize.net](#authorizenet)) - [Braintree](#braintree) - [PayPal Express Checkout](#paypal---express-checkout) - [PayPal Website Payments Pro](#paypal---website-payments-pro) - [Paysafe](#paysafe) - [Qualpay](#qualpay) -- [Sandbox](#sandbox) + +[//]: # (- [Sandbox](#sandbox)) - [Stripe](#stripe) - [Vindicia](#vindicia) - [Checkout](#checkout) @@ -78,24 +79,38 @@ Here are the configuration options for each of the connectors for the Payment Pr --- -### Authorize.net +[//]: # () +[//]: # (### Authorize.net) -Library: `authorize` -Configuration: +[//]: # () +[//]: # (Library: `authorize` ) -```json -{ - "APILoginID": "xxxxxxxxxxxx", - "TransactionKey": "xxxxxxxxxxxx", - "Environment": "xxxxxxxxxxxx" -} -``` +[//]: # (Configuration:) + +[//]: # () +[//]: # (```json ) + +[//]: # ({) + +[//]: # ( "APILoginID": "xxxxxxxxxxxx",) + +[//]: # ( "TransactionKey": "xxxxxxxxxxxx",) + +[//]: # ( "Environment": "xxxxxxxxxxxx") + +[//]: # (} ) + +[//]: # (``` ) +[//]: # () +[//]: # (| FieldName | Definition | ) + +[//]: # (|---------------:|:--------------------------------------------------------------------------------------------------------|) -| FieldName | Definition | -|---------------:|:--------------------------------------------------------------------------------------------------------| -| APILoginID | The Api Login ID from your Authorize.net account found in Account -> API Credentials & Keys | -| TransactionKey | The Transaction Key obtained from your Authorize.net account found in Account -> API Credentials & Keys | -| Environment | Must be either "sandbox" or "production" | +[//]: # (| APILoginID | The Api Login ID from your Authorize.net account found in Account -> API Credentials & Keys |) + +[//]: # (| TransactionKey | The Transaction Key obtained from your Authorize.net account found in Account -> API Credentials & Keys |) + +[//]: # (| Environment | Must be either "sandbox" or "production" |) ### Braintree @@ -206,7 +221,8 @@ Configuration: "Currency": "USD", "UseVault": "false", "SingleUseTokenUsername": "xxxxxxxxxxxx", - "SingleUseTokenPassword": "xxxxxxxxxxxx" + "SingleUseTokenPassword": "xxxxxxxxxxxx", + "merchantURL":"xxxxxxxxxxxx" } ``` @@ -215,17 +231,18 @@ Configuration: -----------------------:|:--- Acquirer | The Acquirer bank setup for this merchant account (optional, if you are not using a defined acquirer this can be left blank) -AccountID | The AccountID for this merchant account -APIUsername | The API Username from your merchant account in your account settings API page -APIPassword | The API Password from your merchant account in your account settings API page +AccountID | The AccountID for this merchant account (10 digit numeric ID) +APIUsername | The API Public Key Username from your merchant account in your account settings API keys page +APIPassword | The API Public Key Password from your merchant account in your account settings API keys page Environment | Must be "MOCK", "TEST" or "LIVE" Country | Optional string field for country. Must be in two character country format (e.g. ["US", "DE", "FR"]) Currency | The currency setup for this merchant account, in standard three character format (e.g. ["GBP", "USD", "EUR"]) -UseVault | Boolean field can be set to "true" or "false" -SingleUseTokenUsername | The Single Use Token Username in your account settings API page. If this is entered the +UseVault | Boolean field can be set to "true" or "false" - Vault is Paysafe's customer Vault for tokenizing Payment Methods. Payment methods are already Tokenized in Chargehive so this should be set to 'false' +SingleUseTokenUsername | The Single Use Token (Public Key) Username in your account settings API Keys page. If this is entered the Password must be entered as well -SingleUseTokenPassword | The Single Use Token Password in your account settings API page. If this is entered the +SingleUseTokenPassword | The Single Use Token (Public Key) Password in your account settings API Keys page. If this is entered the Username must be entered as well +Merchant URL | The url your Order Form is hosted on ### QualPay @@ -240,29 +257,40 @@ Configuration: } ``` -| FieldName | Definition | -|------------:|:---------------------------------------------------------------------| -| APIKey | Your Qualpay API Key from your Qualpay account administration | -| MerchantID | This is your Qualpay Merchant ID. It must be a 64 character integer. | -| Environment | Must be "test" or "live" | +| FieldName | Definition | +|------------:|:-----------------------------------------------------------------------------------------------| +| APIKey | Your Qualpay API Key from your Qualpay account Administration -> Security -> API Security Keys | +| MerchantID | This is your Qualpay Merchant ID. It must be a 64 character integer. It can be found in account Administration -> Security -> API Security Keys | +| Environment | Must be "test" or "live" | -### SandBox +[//]: # (### SandBox) -Library: `sandbox` -Configuration: +[//]: # () +[//]: # (Library: `sandbox` ) -```json -{ - "Mode": "dynamic", - "TransactionIDPrefix": "xxxxxxxxxxxx" -} -``` +[//]: # (Configuration:) + +[//]: # () +[//]: # (```json ) - FieldName | Definition +[//]: # ({) ---------------------:|:--- -Mode | Must be "dynamic", "offline", "delayed", "random-timeout" or "chaos" -TransactionIDPrefix | Prepends transactions with this prefix +[//]: # ( "Mode": "dynamic",) + +[//]: # ( "TransactionIDPrefix": "xxxxxxxxxxxx") + +[//]: # (} ) + +[//]: # (``` ) +[//]: # () +[//]: # ( FieldName | Definition ) + +[//]: # () +[//]: # (--------------------:|:--- ) + +[//]: # (Mode | Must be "dynamic", "offline", "delayed", "random-timeout" or "chaos" ) + +[//]: # (TransactionIDPrefix | Prepends transactions with this prefix) ### Stripe @@ -324,12 +352,12 @@ Configuration: FieldName | Definition -----------------------:|:--- -publicKey | The Public Key of this account. This can be found in settings page of Hub -secretKey | The Secret Key of this account. This can be found in settings page of Hub +publicKey | The Public Key of this account. This can be found in Developers -> Keys -> API Keys +secretKey | The Secret Key of this account. This can be found in Developers -> Keys -> API Keys currency | The currency to process with this account environment | Must be "sandbox" or "production" -signatureKey | Obtained from Checkout dashboard Notification configuration -authorizationHeaderKey | Obtained from Checkout dashboard Notification configuration +signatureKey | This can be found in Developers -> Keys -> Access Keys (Key Value) +authorizationHeaderKey | This can be found in Developers -> Keys -> Access Keys (Key ID) platform | must be `default` or `previous` --- @@ -339,7 +367,7 @@ platform | must be `default` or `previous` Library: `worldpay` Configuration: -```json +```json { "Username": "xxxxxxxxxxxx", "Password": "xxxxxxxxxxxx", @@ -396,7 +424,7 @@ Configuration: ---------------:|:--- MerchantID | The Merchant ID on your Cybersource Account -TransactionKey | The Transaction Key generated in Cybersource on Payment Configuration -> Key Management +TransactionKey | Generate a new REST API Key in Cybersource account Payment Configuration -> Key Management. The Secret Key is the Transaction Key needed here. Environment | Must be either "test" or "live" ### Kount From ff8695a33de9fae65e462186c0975f4023655ee4 Mon Sep 17 00:00:00 2001 From: Mike Motteram Date: Fri, 17 Mar 2023 13:49:18 +0000 Subject: [PATCH 2/5] Update Json labels to be correct case --- docs/connectors/connector.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/connectors/connector.md b/docs/connectors/connector.md index 6a68bb6..7a99779 100644 --- a/docs/connectors/connector.md +++ b/docs/connectors/connector.md @@ -251,9 +251,9 @@ Configuration: ```json { - "APIKey": "xxxxxxxxxxxx", - "MerchantID": "int64", - "Environment": "test" + "apiKey": "xxxxxxxxxxxx", + "merchantID": "int64", + "environment": "test" } ``` From a49649deb899ddbbbd4b2c17ea610f5b2d3fc3cc Mon Sep 17 00:00:00 2001 From: Mike Motteram Date: Fri, 24 Mar 2023 10:39:34 +0000 Subject: [PATCH 3/5] Update Schedules to start from 1 as they are zero indexed --- docs/scheduler/sequential.md | 14 +------------- 1 file changed, 1 insertion(+), 13 deletions(-) diff --git a/docs/scheduler/sequential.md b/docs/scheduler/sequential.md index cdc4524..2bf26e5 100644 --- a/docs/scheduler/sequential.md +++ b/docs/scheduler/sequential.md @@ -1,7 +1,7 @@ # Sequential Scheduler The sequential scheduler allows for a sequence or schedule of connectors to be used when attempting to complete a charge. -They are mapped by attempt number. +They are mapped by attempt number and are zero indexed, so the first attempt should have an index of 1. ## Format As with all configs, the standard wrapper is used. @@ -105,18 +105,6 @@ Value| Definition }, "spec": { "schedules": { - "0": { - "attemptConfig": { - "poolType": "cascade", - "methodSelector": "primary", - "connectorLimit": 0, - "methodLimit": 0, - "cascadeDelay": null, - "overridePoolConnectorIDs": [ - "sandbox-connector" - ] - } - }, "1": { "attemptConfig": { "poolType": "cascade", From e82f445a5a446b339a8c70385a280a060a31adb2 Mon Sep 17 00:00:00 2001 From: Mike Motteram Date: Wed, 29 Mar 2023 17:58:22 +0100 Subject: [PATCH 4/5] Update Kount field descriptions --- docs/connectors/connector.md | 10 +++++----- docs/policy/fraud.md | 2 +- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/connectors/connector.md b/docs/connectors/connector.md index 7a99779..eed035d 100644 --- a/docs/connectors/connector.md +++ b/docs/connectors/connector.md @@ -447,12 +447,12 @@ Configuration: FieldName | Definition ----------------------:|:--- -siteID | The site ID on your Kount Account -merchantID | The Merchant Id of your Kount Account +siteID | The site ID for your Kount Account - this will be given to you by Kount +merchantID | The Merchant Id for your Kount Account - this will be given to you by Kount configKey | The configuration key defined within your Kount account -apiKey | The API key defined in your Kount account -dataCollectorURL | The Kount data collection URL and will be test or a production URL depending on the environment -riskInquiryServiceURL | The Kount risk inquiry URL and will be test or a production URL depending on the environment +apiKey | The API key for your Kount account -> Admin -> API Keys, create a new Key. +dataCollectorURL | The Kount data collection URL and will be test or a production URL depending on the environment. Kount will provide this. +riskInquiryServiceURL | The Kount risk inquiry URL and will be test or a production URL depending on the environment. Kount will provide this. environment | Must be either "test" or "production" ### MaxMind diff --git a/docs/policy/fraud.md b/docs/policy/fraud.md index 4fea581..78c8151 100644 --- a/docs/policy/fraud.md +++ b/docs/policy/fraud.md @@ -1,5 +1,5 @@ # Fraud Policy -The fraud policy defines +The fraud policy allows a Fraud service to be used for charges to get back a recommendtaion of the likelihood of Fraud within each transaction. ## Format As with all configs, the standard wrapper is used. From d271626021a3546c5436f0ac653d506016f5f590 Mon Sep 17 00:00:00 2001 From: Mike Motteram Date: Thu, 13 Apr 2023 13:34:31 +0100 Subject: [PATCH 5/5] Update Kount field descriptions --- docs/connectors/connector.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/connectors/connector.md b/docs/connectors/connector.md index eed035d..445856f 100644 --- a/docs/connectors/connector.md +++ b/docs/connectors/connector.md @@ -449,7 +449,7 @@ Configuration: ----------------------:|:--- siteID | The site ID for your Kount Account - this will be given to you by Kount merchantID | The Merchant Id for your Kount Account - this will be given to you by Kount -configKey | The configuration key defined within your Kount account +configKey | The configuration key for your Kount account - this will be given to you by Kount apiKey | The API key for your Kount account -> Admin -> API Keys, create a new Key. dataCollectorURL | The Kount data collection URL and will be test or a production URL depending on the environment. Kount will provide this. riskInquiryServiceURL | The Kount risk inquiry URL and will be test or a production URL depending on the environment. Kount will provide this.