Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hyrsky/salesforce-paymenthighway
PaymentHighway API implemented in apex.
https://github.com/hyrsky/salesforce-paymenthighway
Last synced: 1 day ago
JSON representation
PaymentHighway API implemented in apex.
- Host: GitHub
- URL: https://github.com/hyrsky/salesforce-paymenthighway
- Owner: hyrsky
- License: mit
- Created: 2019-04-03T20:14:13.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-11-05T15:21:42.000Z (12 days ago)
- Last Synced: 2024-11-05T16:34:20.557Z (12 days ago)
- Language: Apex
- Size: 1.31 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/semantic-release/semantic-release)
[](https://circleci.com/gh/hyrsky/salesforce-paymenthighway)
[](https://www.repostatus.org/#wip)
# PaymentHighway API
This is an implementation of the communication with the Payment Highway API using Apex. __The implementation is currently work in progress__.
This code is provided as-is, use it as inspiration, reference or drop it directly into your own project and use it.
For full documentation on the PaymentHighway API visit the developer website: https://paymenthighway.fi/dev/
## Overview
### PaymentApi
In order to do safe transactions, an execution model is used where the first call to /transaction acquires a financial transaction handle, later referred as “ID”, which ensures the transaction is executed exactly once. Afterwards it is possible to execute a debit transaction by using the received id handle. If the execution fails, the command can be repeated in order to confirm the transaction with the particular id has been processed.
In order to be sure that a tokenized card is valid and is able to process payment transactions the corresponding tokenization id must be used to get the actual card token.
#### Initializing the Payment API
```java
String serviceUrl = 'https://v1-hub-staging.sph-test-solinor.com';
String testKey = 'testKey';
String testSecret = 'testSecret';
String account = 'test';
String merchant = 'test_merchantId';
PaymentHighway paymentAPI = new PaymentHighway(serviceUrl, testKey, testSecret, account, merchant);
```
#### Init transaction
```java
PaymentHighway.InitTransactionResponse initResponse = paymentAPI.initTransactionHandle()
```
#### Debit with Token
```java
String token = '';
Integer amount = 1990;
String currency = 'EUR';
String transactionId = initResponse.getId();
PaymentHighway.TransactionRequest transactionRequest = new PaymentHighway.TransactionRequest(token, String.valueOf(amount), currency);
PaymentHighway.TransactionResponse response = paymentAPI.debitTransaction(transactionId, transactionRequest);
if (response.getResult().getCode() == '100') {
System.debug('Closed won');
}
```
## Dev, Build and Test
### CircleCI setup
1. Generate SSL server key and certificate. See ``.circleci/make-key.sh`` as an example.
2. Commit ``.circleci/encrypted.key`` to repository
3. Set up a Connected App in Salesforce for use with the JWT auth flow.
* Set the OAuth callback to http://localhost:1717/OauthRedirect
* Check Use Digital Signatures and add your certificate from step (1)
* Select the required OAuth scopes - make sure that refresh is enabled.
* Verify JWT works through the following command:
``sfdx force:auth:jwt:grant -i --jwtkeyfile path/to/server.key -u ``
4. Configure CircleCI variables inside of the settings for your project
* ``HUB_CONSUMER_KEY``: Your Connected App consumer key
* ``HUB_SFDC_USER``: The username for your Salesforce user
* ``HUB_SERVER_KEY_PASSWORD``: Password to encrypted key from step (1)
## Resources
## Description of Files and Directories
## Issues