Skip to content

Commit

Permalink
Aprilupdate (#120)
Browse files Browse the repository at this point in the history
* Update 17-contact-us.adoc

* Update wiretransfer_authorization_request_success.xml

* Update 09-shop-systems.adoc

* Update 05-00-01-01-prestashop.adoc

* Update 05-00-02-01-woocommerce.adoc

* Update 05-00-03-01-magento.adoc

* Delete WPP.jpg

* Add files via upload

* Delete WPP.PNG

* Add files via upload

* Delete mfp1.jpg

* Add files via upload

* Delete AdditionalFields_demoshop_orderOverview.jpg

* Add files via upload

* Add files via upload

* Update pos-host-to-host-integration-guide.adoc

* Added POS preauth and increment samples

---------

Co-authored-by: srikanth.kasam <srikanth.kasam@getneteurope.com>
  • Loading branch information
HDjebali and skasam2210 authored Apr 19, 2023
1 parent 1a8e26e commit aa9fcfb
Show file tree
Hide file tree
Showing 23 changed files with 810 additions and 3 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file modified content/images/03-01-06-07-my-favorite-payment/mfp1.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified content/images/03-payment-page-solutions/WPP.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,13 @@ For <<Glossary_TransactionType, transaction type>> details which are not given h
| _void-purchase_ | Frees reserved funds from the cardholder's account due to a _purchase_. | <<POSHostToHostIntegrationGuide_Samples_voidpurchase, _void-purchase_ samples>>
| _void-refund-capture_ | Voids a previous _refund-capture_ transaction. | <<POSHostToHostIntegrationGuide_Samples_voidrefundcapture, _void-refund-capture_ samples>>
| _void-refund-purchase_ | Voids a previous _refund-purchase_ transaction. | <<POSHostToHostIntegrationGuide_Samples_voidrefundpurchase, _void-refund-purchase_ samples>>
| _preauthorization_ | Reserves funds from the cardholder’s account. A capture on this transaction must be conducted within 3-30 days, depending on the acquirer and card brand. | <<POSHostToHostIntegrationGuide_Samples_preauthorization, _preauthorization_ samples>>
| _preauthorization-supplementary_ | Reserves funds from the cardholder´s account on top of pre-authorized amount.Must follow a pre-authorization transaction. | <<POSHostToHostIntegrationGuide_Samples_preauthorizationsupplementary, _preauthorization_supplementary_ samples>>
| _preauthorization-capture_ | Takes funds from the cardholder's account. Must follow an _preauthorization_ or _preauthorization-supplementary_ . | <<POSHostToHostIntegrationGuide_Samples_preauthorizationcapture, _preauthorization_capture_ samples>>
| _void-preauthorization_ | Frees reserved funds from the cardholder’s account due to pre-authorization. | <<POSHostToHostIntegrationGuide_Samples_voidpreauthorization, _void_preauthorization_ samples>>
| _reversal-preauthorization_ | Reverses pre-authorization transaction. The reversal transaction is initiated by the system, not the merchant. | <<POSHostToHostIntegrationGuide_Samples_reversalpreauthorization, _reversal_preauthorization_ samples>>
| _void-preauthorization-supplementary_ | Frees reserved funds from the cardholder’s account due to pre-authorization supplementery. | <<POSHostToHostIntegrationGuide_Samples_voidpreauthorizationsupplementary, _void_preauthorization_supplementary_ samples>>
| _reversal-preauthorization-supplementary_ | Reverses an preauthorization-supplementery transaction. The reversal transaction is initiated by the system, not the merchant. | <<POSHostToHostIntegrationGuide_Samples_reversalpreauthorizationsupplementary, _reversal_preauthorization_supplementary_ samples>>
|===

[#POSHostToHostIntegrationGuide_TestCredentials]
Expand Down Expand Up @@ -922,3 +929,108 @@ include::{root}/samples/xml/pos_void-refund-purchase_request_success_en.xml[]
----
include::{root}/samples/xml/pos_void-refund-purchase_response_success_en.xml[]
----
[#POSHostToHostIntegrationGuide_Samples_preauthorization]
==== _preauthorization_
===== _preauthorization_ Request (Successful)
[source,xml]
----
include::{root}/samples/xml/pos_preauthorization_request_success_en.xml[]
----
===== _preauthorization_ Response (Successful)
[source,xml]
----
include::{root}/samples/xml/pos_preauthorization_response_success_en.xml[]
----
[#POSHostToHostIntegrationGuide_Samples_preauthorizationcapture]
==== _preauthorization_capture_
===== _preauthorization_capture_ Request (Successful)
[source,xml]
----
include::{root}/samples/xml/pos_capture_preauthorization_request_success_en.xml[]
----
===== _preauthorization_capture_ Response (Successful)
[source,xml]
----
include::{root}/samples/xml/pos_capture_preauthorization_response_success_en.xml[]
----
[#POSHostToHostIntegrationGuide_Samples_preauthorizationsupplementary]
==== _preauthorization_supplementary_
===== _preauthorization_supplementary_ Request (Successful)
[source,xml]
----
include::{root}/samples/xml/pos_preauthorization_supplementary_request_success_en.xml[]
----
===== _preauthorization_supplementary_ Response (Successful)
[source,xml]
----
include::{root}/samples/xml/pos_preauthorization_supplementary_response_success_en.xml[]
----
[#POSHostToHostIntegrationGuide_Samples_reversalpreauthorizationsupplementary]
==== _reversal_preauthorization_supplementary_
===== _reversal_preauthorization_supplementary_ Request (Successful)
[source,xml]
----
include::{root}/samples/xml/pos_reversal_preauth_supplementary_request_en.xml[]
----
===== _reversal_preauthorization_supplementary_ Response (Successful)
[source,xml]
----
include::{root}/samples/xml/pos_reversal_preauth_supplementary_response_en.xml[]
----
[#POSHostToHostIntegrationGuide_Samples_reversalpreauthorization]
==== _reversal_preauthorization_
===== _reversal_preauthorization_ Request (Successful)
[source,xml]
----
include::{root}/samples/xml/pos_reversal_preauthorization_request_en.xml[]
----
===== _reversal_preauthorization_ Response (Successful)
[source,xml]
----
include::{root}/samples/xml/pos_reversal_preauthorization_response_en.xml[]
----
[#POSHostToHostIntegrationGuide_Samples_voidpreauthorizationsupplementary]
==== _void_preauthorization_supplementary_
===== _void_preauthorization_supplementary_ Request (Successful)
[source,xml]
----
include::{root}/samples/xml/pos_void_preauth_supplementary_resquest_en.xml[]
----
===== _void_preauthorization_supplementary_ Response (Successful)
[source,xml]
----
include::{root}/samples/xml/pos_void_preauth_supplementary_response_en.xml[]
----
[#POSHostToHostIntegrationGuide_Samples_voidpreauthorization]
==== _void_preauthorization_
===== _void_preauthorization_ Request (Successful)
[source,xml]
----
include::{root}/samples/xml/pos_void_preauthorization_request_en.xml[]
----
===== _void_preauthorization_ Response (Successful)
[source,xml]
----
include::{root}/samples/xml/pos_void_preauthorization_response_en.xml[]
----
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,8 @@ image::images/09-02-prestashop/prestashop-transactions-index.jpg[]

{empty} +

Select the transaction that you wish to refund, then click on the refund button.
**Note: Notice that for Sofort, iDEAL and SEPA DD the refunds are actually SEPA credits. If you refunded from the merchant portal it is still possible to refund again from the plugin
Select the transaction that you wish to refund, then click on the refund button.**

[%hardbreaks]
image::images/09-02-prestashop/prestashop-transaction-refund.jpg[]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -82,6 +82,8 @@ image::images/09-02-woocommerce/order_notes.PNG[]

{empty} +

**Note: Notice that for Sofort, iDEAL and SEPA DD the refunds are actually SEPA credits. If you refunded from the merchant portal it is still possible to refund again from the plugin.**

*Plugin Usage Rules:*
[%hardbreaks]
image::images/09-02-woocommerce/table.PNG[]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -144,6 +144,8 @@ image::images/09-01-magento/notes_for_this_order.PNG[]

{empty} +

**Note: Notice that for Sofort, iDEAL and SEPA DD the refunds are actually SEPA credits. If you refunded from the merchant portal it is still possible to refund again from the plugin.**


*Status Update*
For "Offline Bank Transfer" type payments, there is the "Update status" button, in this option, the system will ask if you agree to want to check the status and update, when you accept, the request will be sent to Getnet to check the current status and if it is different from the one in the system, it will be updated.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,7 @@ You are able to *test the shop plugin* features and functionality via
need your personal credentials which you receive from Getnet after
concluding a corresponding contract. Please contact our <<ContactUs, Merchant Support>>.

All our shop plugins are offered on link:https://github.com/getneteurope[GitHub]. This means you are able
to use them free-of-charge and and are given access to the source code.
Magento and Woocommerce can be found in their respective public Github repositories https://github.com/getneteurope/magento-getnet and https://github.com/getneteurope/woocommerce-getnet . To obtain Prestashop contact our merchant support team.

Please have a look on
our <<ShopSystems_TermsOfUse, Terms of Use and Legal Notice>> before you use our shop plugins in your online
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<payment xmlns="http://www.elastic-payments.com/schema/payment">
<merchant-account-id>daa1734c-9c38-4140-841f-70f6aac05056</merchant-account-id>
<request-id>430f2c58-9b91-4a80-aeac-c070a74790f9</request-id>
<transaction-type>capture-preauthorization</transaction-type>
<requested-amount currency="EUR">12.30</requested-amount>
<parent-transaction-id>73de80df-9c90-46f9-985d-95b613d57867</parent-transaction-id>
</payment>
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<payment xmlns="http://www.elastic-payments.com/schema/payment" self="https://api-qa.getneteurope.com:443/engine
/rest/merchants/daa1734c-9c38-4140-841f-70f6aac05056/payments/864e6b2e-2214-4826-b410-2ec0ec1bdd72">
<merchant-account-id ref="https://api-qa.getneteurope.com:443/engine/rest/config/merchants/daa1734c-9c38-
4140-841f-70f6aac05056">daa1734c-9c38-4140-841f-70f6aac05056</merchant-account-id>
<transaction-id>864e6b2e-2214-4826-b410-2ec0ec1bdd72</transaction-id>
<request-id>430f2c58-9b91-4a80-aeac-c070a74790f9</request-id>
<transaction-type>capture-preauthorization</transaction-type>
<transaction-state>success</transaction-state>
<completion-time-stamp>2023-04-17T09:36:34.000Z</completion-time-stamp>
<statuses>
<status code="201.0000" description="3d-acquirer:The resource was successfully created." severity="
information" provider-transaction-id="C690539168172419395933"/>
</statuses>
<requested-amount currency="EUR">12.30</requested-amount>
<parent-transaction-id>73de80df-9c90-46f9-985d-95b613d57867</parent-transaction-id>
<card>
<expiration-month>12</expiration-month>
<expiration-year>2023</expiration-year>
<card-type>visa</card-type>
</card>
<card-token>
<token-id>4809775583911543</token-id>
<masked-account-number>400902******1543</masked-account-number>
</card-token>
<ip-address>10.10.50.233</ip-address>
<order-number>380AA6E59B0349ABAB0CB4C076229CBA</order-number>
<order-detail>accept.</order-detail>
<descriptor>accept.</descriptor>
<payment-methods>
<payment-method name="creditcard"/>
</payment-methods>
<parent-transaction-amount currency="EUR">15.300000</parent-transaction-amount>
<authorization-code>152314</authorization-code>
<api-id>elastic-api</api-id>
<iso>
<pos-transaction-time>093634</pos-transaction-time>
<pos-transaction-date>0417</pos-transaction-date>
</iso>
<provider-account-id>GN0000317A708D07</provider-account-id>
</payment>
56 changes: 56 additions & 0 deletions content/samples/xml/pos_preauthorization_request_success_en.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<payment xmlns="http://www.elastic-payments.com/schema/payment">
<merchant-account-id>daa1734c-9c38-4140-841f-70f6aac05056</merchant-account-id>
<request-id>7bb32d7f-1fe6-41cb-8d61-19f6e0bccd4f</request-id>
<transaction-type>preauthorization</transaction-type>
<requested-amount currency="EUR">11.30</requested-amount>
<card>
<card-type>visa</card-type>
<track-2>4009029195741543=23121010912345678901</track-2>
<card-emv>
<request-iccdata>f0f0f4f0f50068f0f0f9f1f9a0000000031010f0f0f4f1f00978f0f0f3f0f280f0f0f5f1f5010302f0f0f6f2f100001854f0f0f8f1f
3000000000000f0f0f9f0f306010c03a40000f0f0f8f0f9000000005000f0f0f4f1f15c00f0f0f4f2f0008cf0f0f6f0f4a63f881ef0f0f4f
1f20276f0f1f0f1f73235303839303231f0f0f5f1f4e0f0c8f0f1f0f0f1db38bb23fd088de2f0f0f5f0f7110210f0f0f7f0f60040008000f
0f0f3f1f622f0f0f3f0f800</request-icc-data>
<request-icc-data-encoding>hex</request-icc-data-encoding>
<request-icc-data-format>gicc</request-icc-data-format>
</card-emv>
<card-pin>
<data>CBFC69A0369B9C3F</data>
<encoding>hex</encoding>
<format>ISO-0</format>
<encryption-context>
<value>paymentengine.thor-2</value>
<version>0</version>
<algorithm>dukpt</algorithm>
<parameter>0001999900000200020C</parameter>
<padding>pkcs</padding>
</encryption-context>
</card-pin>
<card-raw>
<data>586E42A37E2B907384739985767438C678D7B73D376990DF</data>
<encoding>hex</encoding>
<format>thor-posmate-chip</format>
<encryption-context>
<value>paymentengine.thor-2</value>
<version>0</version>
<algorithm>dukpt</algorithm>
<parameter>0001999900000200020C</parameter>
<padding>pkcs</padding>
</encryption-context>
</card-raw>
</card>
<ip-address>10.10.50.233</ip-address>
<order-number>380AA6E59B0349ABAB0CB4C076229CBA</order-number>
<order-detail>accept.</order-detail>
<descriptor>accept.</descriptor>
<payment-methods>
<payment-method name="creditcard"/>
</payment-methods>
<iso>
<merchant-id>100100000000153</merchant-id>
<terminal-id>GC004045</terminal-id>
<pos-entry-mode>902</pos-entry-mode>
<pos-pin-input-length-capability>6</pos-pin-input-length-capability>
</iso>
</payment>
47 changes: 47 additions & 0 deletions content/samples/xml/pos_preauthorization_response_success_en.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<payment xmlns="http://www.elastic-payments.com/schema/payment" self="https://api-qa.getneteurope.com:443/engine
/rest/merchants/daa1734c-9c38-4140-841f-70f6aac05056/payments/1b130b84-840e-4356-be6a-4357596acead">
<merchant-account-id ref="https://api-qa.getneteurope.com:443/engine/rest/config/merchants/daa1734c-9c38-
4140-841f-70f6aac05056">daa1734c-9c38-4140-841f-70f6aac05056</merchant-account-id>
<transaction-id>1b130b84-840e-4356-be6a-4357596acead</transaction-id>
<request-id>7bb32d7f-1fe6-41cb-8d61-19f6e0bccd4f</request-id>
<transaction-type>preauthorization</transaction-type>
<transaction-state>success</transaction-state>
<completion-time-stamp>2023-04-17T10:24:33.000Z</completion-time-stamp>
<statuses>
<status code="201.0000" description="3d-acquirer:The resource was successfully created." severity="
information" provider-transaction-id="C562349168172707302218"/>
</statuses>
<requested-amount currency="EUR">11.30</requested-amount>
<card>
<expiration-month>12</expiration-month>
<expiration-year>2023</expiration-year>
<card-type>visa</card-type>
<card-emv>
<request-iccdata>f0f0f4f0f50068f0f0f9f1f9a0000000031010f0f0f4f1f00978f0f0f3f0f280f0f0f5f1f5010302f0f0f6f2f100001854f0f0f8f1f
3000000000000f0f0f9f0f306010c03a40000f0f0f8f0f9000000005000f0f0f4f1f15c00f0f0f4f2f0008cf0f0f6f0f4a63f881ef0f0f4f
1f20276f0f1f0f1f73235303839303231f0f0f5f1f4e0f0c8f0f1f0f0f1db38bb23fd088de2f0f0f5f0f7110210f0f0f7f0f60040008000f
0f0f3f1f622f0f0f3f0f800</request-icc-data>
<request-icc-data-encoding>hex</request-icc-data-encoding>
<request-icc-data-format>gicc</request-icc-data-format>
</card-emv>
</card>
<card-token>
<token-id>4809775583911543</token-id>
<masked-account-number>400902******1543</masked-account-number>
</card-token>
<ip-address>10.10.50.233</ip-address>
<order-number>380AA6E59B0349ABAB0CB4C076229CBA</order-number>
<order-detail>accept.</order-detail>
<descriptor>accept.</descriptor>
<payment-methods>
<payment-method name="creditcard"/>
</payment-methods>
<authorization-code>152314</authorization-code>
<api-id>elastic-api</api-id>
<iso>
<pos-transaction-time>102433</pos-transaction-time>
<pos-transaction-date>0417</pos-transaction-date>
</iso>
<provider-account-id>GN0000317A708D07</provider-account-id>
</payment>
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<payment xmlns="http://www.elastic-payments.com/schema/payment">
<merchant-account-id>daa1734c-9c38-4140-841f-70f6aac05056</merchant-account-id>
<request-id>e976059e-53f7-47b6-b738-a5b171fe42a9</request-id>
<transaction-type>preauthorization-supplementary</transaction-type>
<requested-amount currency="EUR">15.30</requested-amount>
<parent-transaction-id>1b130b84-840e-4356-be6a-4357596acead</parent-transaction-id>
<card>
<card-type>visa</card-type>
<track-2>4009029195741543=23121010912345678901</track-2>
<card-emv>
<request-iccdata>f0f0f4f0f50068f0f0f9f1f9a0000000031010f0f0f4f1f00978f0f0f3f0f280f0f0f5f1f5010302f0f0f6f2f100001854f0f0f8f1f
3000000000000f0f0f9f0f306010c03a40000f0f0f8f0f9000000005000f0f0f4f1f15c00f0f0f4f2f0008cf0f0f6f0f4a63f881ef0f0f4f
1f20276f0f1f0f1f73235303839303231f0f0f5f1f4e0f0c8f0f1f0f0f1db38bb23fd088de2f0f0f5f0f7110210f0f0f7f0f60040008000f
0f0f3f1f622f0f0f3f0f800</request-icc-data>
<request-icc-data-encoding>hex</request-icc-data-encoding>
<request-icc-data-format>gicc</request-icc-data-format>
</card-emv>
<card-pin>
<data>CBFC69A0369B9C3F</data>
<encoding>hex</encoding>
<format>ISO-0</format>
<encryption-context>
<value>paymentengine.thor-2</value>
<version>0</version>
<algorithm>dukpt</algorithm>
<parameter>0001999900000200020C</parameter>
<padding>pkcs</padding>
</encryption-context>
</card-pin>
<card-raw>
<data>586E42A37E2B907384739985767438C678D7B73D376990DF</data>
<encoding>hex</encoding>
<format>thor-posmate-chip</format>
<encryption-context>
<value>paymentengine.thor-2</value>
<version>0</version>
<algorithm>dukpt</algorithm>
<parameter>0001999900000200020C</parameter>
<padding>pkcs</padding>
</encryption-context>
</card-raw>
</card>
<ip-address>10.10.50.233</ip-address>
<order-number>380AA6E59B0349ABAB0CB4C076229CBA</order-number>
<order-detail>accept.</order-detail>
<descriptor>accept.</descriptor>
<payment-methods>
<payment-method name="creditcard"/>
</payment-methods>
<iso>
<merchant-id>100100000000153</merchant-id>
<terminal-id>GC004045</terminal-id>
<pos-entry-mode>902</pos-entry-mode>
<pos-pin-input-length-capability>6</pos-pin-input-length-capability>
</iso>
</payment>
Loading

0 comments on commit aa9fcfb

Please sign in to comment.