-
Notifications
You must be signed in to change notification settings - Fork 5
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #9 from AyusheeSrivastava/master
updated readme for malay support
- Loading branch information
Showing
2 changed files
with
40 additions
and
40 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -75,83 +75,83 @@ FieldLevelEncryptionConfig config = FieldLevelEncryptionConfigBuilder.aFieldLeve | |
.build(); | ||
``` | ||
|
||
See also: | ||
See also: | ||
- [Securing Sensitive Data Using Payload Encryption](https://developer.mastercard.com/platform/documentation/security-and-authentication/securing-sensitive-data-using-payload-encryption/). | ||
|
||
## Configuration <a name="configuration"></a> | ||
1. Create your account on [Mastercard Developers](https://sandbox.api.mastercard.com/) if you don't have it already. | ||
1. Create your account on [Mastercard Developers](https://developer.mastercard.com/) if you don't have it already. | ||
2. Create a new project here and add ***Carbon Calculator Experience*** to it and click continue. | ||
3. Download Sandbox Signing Key, a ```.p12``` file will be downloaded. Use this file for payload encryption. | ||
4. Download mastercard Signing Key, a ```mc.p12``` file will be downloaded. Use this file for payload decryption. | ||
5. In the Client Encryption Keys section of the dashboard, click on the ```Actions``` dropdown and download the client encryption key, a ``.pem``` file will be downloaded. | ||
5. In the Client Encryption Keys section of the dashboard, click on the ```Actions``` dropdown and download the client encryption key, a ``.pem`` file will be downloaded. | ||
6. Copy the downloaded ```.p12``` , ```mc.p12``` and ```.pem``` files to ```src/main/resources``` folder in your code. | ||
7. Open ```src/main/resources/application.yml``` and configure: | ||
- ```mastercard.api.environment.basepath ```- Path to sandbox endpoint,for example for Sandbox https://sandbox.api.mastercard.com/cts | ||
- ```mastercard.api.environment.key-file ```- Path to keystore (.p12) file, just change the name as per the downloaded file in step 5. | ||
- ```mastercard.api.environment.key-file ```- Path to keystore (.p12) file, just change the name as per the downloaded file in step 5. | ||
- ```mastercard.api.authentication.consumer-key``` - Copy the Consumer key from "Sandbox/Production Keys" section on your project page | ||
- ```mastercard.api.authentication.keystore-alias``` - Alias of your key. Default key alias for sandbox is ```keyalias```. | ||
- ```mastercard.api.authentication.keystore-password``` - Password of your Keystore. Default keystore password for sandbox project is ```keystorepassword```. | ||
- ```mastercard.api.encryption.key-file ```- Path to encryption key (.pem) file, just change the name as per the downloaded file in step 5. | ||
```mastercard.api.encryption.fingerprint ```- Fingerprint, copy the fingerprint from Client Encryption Keys section. If you have multiple client encryption keys then copy the fingerprint of the key which you want to use. | ||
- ```mastercard.api.encryption.key-file ```- Path to encryption key (.pem) file, just change the name as per the downloaded file in step 5. | ||
```mastercard.api.encryption.fingerprint ```- Fingerprint, copy the fingerprint from Client Encryption Keys section. If you have multiple client encryption keys then copy the fingerprint of the key which you want to use. | ||
|
||
## Use-Cases <a name="use-cases"></a> | ||
1. **Get Webview URL** <br/> | ||
endpoint "/issuers/users/{userid}/dashboards" | ||
Use this endpoint to get a new token with expiry specified. Language code "lang=en-US" can be passed as query parameter (Not mandatory). Supported lang "en-US,es-419,sv,es-CL,es-CR,pl-PL". Default is "en-US". | ||
endpoint "/issuers/users/{userid}/dashboards" | ||
Use this endpoint to get a new token with expiry specified. Language code "lang=en-US" can be passed as query parameter (Not mandatory). Supported lang "en-US,es-419,sv,es-CL,es-CR,pl-PL,ms-MY". Default is "en-US". | ||
|
||
2. **Get Current Months Carbon Score** <br/> | ||
endpoint "/issuers/users/{userid}/aggregate-carbon-scores"<br/> | ||
Use this endpoint to display the current months' carbon score, to provide a snapshot of their score prior to opening the dashboard. | ||
2. **Get Current Months Carbon Score** <br/> | ||
endpoint "/issuers/users/{userid}/aggregate-carbon-scores"<br/> | ||
Use this endpoint to display the current months' carbon score, to provide a snapshot of their score prior to opening the dashboard. | ||
|
||
3. **Enroll User** <br/> | ||
endpoint "/issuers/users" <br/> | ||
Use this endpoint to enrol their customers onto Carbon Calculator Experience platform. | ||
Donate feature toggle, which allows the issuer to disable the donate feature during onboarding. | ||
If the issuer has opted for the Donation feature then the fields - *name, billing address, email, locale, cardholder name, card number, card base currency and card expiry date* fields are **mandatory** in the payload. | ||
endpoint "/issuers/users" <br/> | ||
Use this endpoint to enrol their customers onto Carbon Calculator Experience platform. | ||
Donate feature toggle, which allows the issuer to disable the donate feature during onboarding. | ||
If the issuer has opted for the Donation feature then the fields - *name, billing address, email, locale, cardholder name, card number, card base currency and card expiry date* fields are **mandatory** in the payload. | ||
|
||
4. **Get Issuer** <br/> | ||
endpoint "/issuers" <br/> | ||
Use this endpoint to fetch issuer details onboarded to Carbon Calculator Experience platform. | ||
endpoint "/issuers" <br/> | ||
Use this endpoint to fetch issuer details onboarded to Carbon Calculator Experience platform. | ||
|
||
5. **Delete User** <br/> | ||
endpoint "/issuers/user-deletions" </br> | ||
Use this endpoint to delete user registered to Carbon Calculator Experience platform. | ||
endpoint "/issuers/user-deletions" </br> | ||
Use this endpoint to delete user registered to Carbon Calculator Experience platform. | ||
|
||
6. **Update Issuer** <br/> | ||
endpoint "/issuers"<br/> | ||
Use this endpoint to update issuer details onboarded to Carbon Calculator Experience Platform. | ||
This endpoint is not supported when the Donate feature for your bank is disabled. | ||
endpoint "/issuers"<br/> | ||
Use this endpoint to update issuer details onboarded to Carbon Calculator Experience Platform. | ||
This endpoint is not supported when the Donate feature for your bank is disabled. | ||
|
||
More details can be found [here](https://stage.developer.mastercard.com/drafts/priceless-planet-carbon-tracker/staging/documentation/use-cases/). | ||
More details can be found [here](https://developer.mastercard.com/priceless-planet-carbon-tracker/documentation/use-cases/). | ||
|
||
|
||
## Execute the Use-Cases <a name="execute-the-use-cases"></a> | ||
1. Run ```mvn clean install``` from the root of the project directory. | ||
2. There are two ways to execute the use-cases: | ||
1. Execute the use-cases(test cases): | ||
1. Execute the use-cases(test cases): | ||
- Run ```mvn clean install``` from the root of the project directory. | ||
- When the project builds successfully, you can run the following command to start the project: | ||
java -jar target/carbon-tracker-0.0.1-SNAPSHOT.jar | ||
java -jar target/carbon-tracker-0.0.1-SNAPSHOT.jar | ||
- Above command will start the application and execute all the use cases mentioned in readme file | ||
2. Use REST API based Client( such as [Insomnia](https://insomnia.rest/download/core/) or [Postman](https://www.postman.com/downloads/)) | ||
- Run ```mvn spring-boot:run``` command to run the application. | ||
- Use any REST API based Client to test the functionality. Below are the APIs exposed by this application ,use locahost:8080 as the Host:<br/> | ||
- GET {Host}/cts/issuers/users/{userid}/dashboards <br/> | ||
- GET {Host}/cts/issuers/users/{userid}/aggregate-carbon-scores <br/> | ||
- GET {HOST}/cts/issuers <br/> | ||
- POST {HOST}/cts/issuers/users <br/> | ||
- PUT {HOST}/cts/issuers <br/> | ||
- POST {HOST}/cts/issuers/user-deletions <br/> | ||
|
||
2. Use REST API based Client( such as [Insomnia](https://insomnia.rest/download/core/) or [Postman](https://www.postman.com/downloads/)) | ||
- Run ```mvn spring-boot:run``` command to run the application. | ||
- Use any REST API based Client to test the functionality. Below are the APIs exposed by this application ,use locahost:8080 as the Host:<br/> | ||
- GET {HOST}/cts/issuers/users/{userid}/dashboards <br/> | ||
- GET {HOST}/cts/issuers/users/{userid}/aggregate-carbon-scores <br/> | ||
- GET {HOST}/cts/issuers <br/> | ||
- POST {HOST}/cts/issuers/users <br/> | ||
- PUT {HOST}/cts/issuers <br/> | ||
- POST {HOST}/cts/issuers/user-deletions <br/> | ||
|
||
|
||
## Service Documentation <a name="documentation"></a> | ||
|
||
Carbon Calculator Experience documentation can be found [here](https://stage.developer.mastercard.com/drafts/priceless-planet-carbon-tracker/staging/documentation/use-cases/). | ||
Carbon Calculator Experience documentation can be found [here](https://developer.mastercard.com/priceless-planet-carbon-tracker/documentation/use-cases/). | ||
|
||
|
||
## API Reference <a name="api-reference"></a> | ||
The Swagger API specification can be found [here](https://stage.developer.mastercard.com/drafts/priceless-planet-carbon-tracker/staging/documentation/api-reference/). | ||
The Swagger API specification can be found [here](https://developer.mastercard.com/priceless-planet-carbon-tracker/documentation/api-reference/). | ||
|
||
## Support <a name="support"></a> | ||
Please send an email to **[email protected]** with any questions or feedback you may have. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters