About Amazon Pay

General information about Amazon Pay

Payment processing with Amazon Pay (APA=Amazon Pay Advanced; LPA= Login and Pay with Amazon) requires the correct and timely coordinated cooperation of several systems working together.

To initialize a payment or a login with Amazon there is a direct interaction with Amazon required. Therefore a button widget provided by Amazon must be implemented in your shop.

Data from the first direct interaction with the Amazon widgets is then transferred to in the following step. resumes the follow-up actions in this process by a direct communication with the Amazon systems. returns all answers of the Amazon systems to your systems (e.g. shop and ERP).

Please consult during conceptual design for implementing Amazon Pay. Only when all steps are properly coordinated will a functional interface be guaranteed.

This manual describes the basics for configuring and using the interface for Amazon Pay as well as:

the parameters of the interface
the Batch using of the interface

Logo

Info

“Amazon Pay and Login by Amazon” is a complete checkout and payment service. It allows millions of Amazon customers to complete their purchases with using their Amazon account without leaving the web page of the visited online shop. The A-Z-guarantee from Amazon gives a comprehensive protection.

Type

Payments by eWallet

Further information you will find also on the Web page of Amazon Pay.

Before using Amazon Pay you need to register at https://pay.amazon.com/de/signup. On this page you can configure a notify URL. Therefore follow the menu steps Settings – Integration settings – Settings for instant notifications – Modify. Enter the Integrator URL AmazonAPANotify.aspx and save it.

The second step is generating a MWS Auth Token. Therefore go to the webpage https://developer.amazonservices.co.uk/gp/mws/registration/register.html and enter the following data:

Developer name: Computop Ltd
Developer account number: 8662-2365-9858

Then submit the received MWS Authorisation Token on a secure way to for configuration.

Documentation > Amazon Pay. > image2019-8-16_12-41-49.png

Documentation > Amazon Pay. > image2019-8-16_12-41-55.png

Steps within the process

The basic payment process with Amazon consists of several steps:

Step	Description
Display Button-Widget	The Amazon button widget must be properly implemented on the page of the webshop and must be called for each payment/login process. Afterwards a redirect to Amazon occurs. Within the redirect data from Amazon (AccessToken, TokenType, Expiry, Scope) is delivered.
Initialize payment via (Server to Server)	With the delivered data from the button widget from Amazon (AccessToken, TokenType, Expiry, Scope) the payment process via is initiated. Please use Eventtoken LGN. Return parameters will include (depending on scope) customer information such as email address and UserID (unique Amazon account ID). Use this information to identify the user and compare with your data.
Load and display address and wallet widgets	Both widgets must be integrated in the shop directly. The widgets communicate directly with the shop. It is recommended to firstly call the address widget, to buffer the „OrderReferenceID“ (OrderReferenceId is generated by address widget – and can be read out via JavaScript with„orderReference.getAmazonOrderReferenceId()“) and to execute immediately a call of AmazonAPA.aspx with Eventtoken „SOD“ and the „orderReferenceID“ via the . In return, depending on the “scope”, you will receive delivery data including city, country and postcode and you can thereby calculate standard shipping costs. Thus the wallet only shows valid payment methods for this order. Each modification of delivery address (if the customer selects a different address for shipping than the standard address within the widget) involves an „OnAddressSelect“– whereupon your systems must react.
Request new shipping information	After an „OnAddressSelect“ a further call of AmazonAPA.aspx via is necessary with Eventtoken „GOD“. The response gives information about the new selected delivery address (only for Scope=payments:shipping_address for recalculating the shipping costs). Now call the AmazonAPA.aspx with Eventtoken SOD, to transfer the possible new total amount for this order.
Finalize the purchase	The purchase confirmation is completed via with the option of one of two Eventtokens – „SCO“ „SetOrderDetails and ConfirmOrder“or „COD“ „ConfirmOrderDetails“. The call with Eventtoken „SCO“ is preferred, because the following steps are easier due to the automatic provision of the final delivery address (with all address details). Nevertheless after getting the response of finalizing the order a further call of AmazonAPA.aspx with Eventtoken „GOD“ should be made, in order to notice possible delivery address changes. After finalizing the order there already doesn’t exits a pecuniary claim against the customer. Subsequently your systems also must execute authorizations and captures.
Confirmation flow	Due to Multi-factor Authentication it is necessary after a succesful confirmation of an order to start a new Javascript call, the ConfirmationFlow. With this AmazonPay can handle the Multi-factor Authentication if required. The changes for Multi-Factor Authentication (MFA) needed, only effect the EUR and UK Amazon Platforms.
Authorisation	The authorization of amount payable must be done within 180 days. Authorizations are valid for 30 days and expire afterwards. After expiry the amount payable can be reauthorized (within 180 days after the order). In the response to an authorization with Amazon you receive a unique -Parameter „XID“. This parameter is a sub-transaction number, which is uniquely associated with a „PayID“ within the . Please ensure that you store this parameter together with this transaction. Within respective „XID“ no further transactions like capture or credit can be executed. Captures and credits with Amazon always must reference to an authorization or capture (authorization „blue pullover“, capture „blue pullover“, credit „blue pullover“). For an initialized Amazon order up to ten authorizations can be submitted simultaneously. Per order lifecycle up to a maximum of 50 authorizations can be submitted. Peculiarity for authorizations with Amazon: There are two different authorization types: Synchronous and asynchronous authorization. Synchronous authorizations always give a clear answer about the authorization result immediately, thus OK or FAILED. Asynchronous authorizations are followed up by a notify, which gives an answer about the authorization result after a definable maximum time period (the notify can be returned earlier). The maximum time period between submitting the authorization and the latest allowed status message per notify can be configured for each MID (in minutes, multiple of 5, maximum 1440 minutes – a value of 0 means synchronous authorization).
Capture	Authorizations can be captured synchronous within seven days starting from the time of authorization. This means the capture gets an „OK“ from Amazon immediately. Between seven and thirty days after authorization the captures are asynchronous and produce a notify to your notify-URL (simultaneously extended risk assessments are started at Amazon). Please ensure to start the delivery only after receiving the notify. For an authorization a capture ≤ authorization amount can be submitted. The „XID“ of the underlying authorization must be submitted to for capture. Captures without XID are refused. If a capture < authorization was submitted, the difference amount can be authorized again immediately. The does not make an automatic reauthorization of the difference amount.
Conclude order process after dispatch	After end of the order process (e.g. after shipment of the last article or after successful last capture) it is recommended, to close the process at Amazon. If the process is not closed, the customer will see an open order in his backend of Amazon Pay. Please use therefore the Eventtoken „COR“. After closing of this process captures on open authorizations as well as credits are still possible – but no further authorizations related to an order process.
Close an authorization	If an article cannot be delivered anymore (or did no longer have to be delivered) existing authorizations that are not captured can be closed. Therefore use the Eventtoken „RAN“.
Credits	According to Amazon credits can issue without time limit. This can be up to a maximum of one year in the case of . For a credit the „XID“ of the underlying capture must be submitted to . Credits without XID are refused. Up to ten credits are allowed per capture.

Integrate Button-Widget

The following example code shows how to integrate the button widget:

<div id="AmazonPayButton"/>
<script type="text/javascript">
  var authRequest;
  OffAmazonPayments.Button("AmazonPayButton", "YOUR_SELLER_ID ", {
    type:  "ENTER_TYPE_PARAMETER",
    color: "ENTER_COLOR_PARAMETER",
    size:  "ENTER_SIZE_PARAMETER",
    language: "ENTER_LANGUAGE_PARAMETER",
    authorization: function() {
      loginOptions = {scope: "ENTER_SCOPES", popup: "ENTER_POPUP_PARAMETER"};            
      authRequest = amazon.Login.authorize (loginOptions, "YOUR_REDIRECT_URL ");
    },
    onError: function(error) {
      // your error handling code
    }
  });
</script>

Notice: Because has no influence on the widget code, we recommend you to follow the documentation of Amazon Pay.

In this case the following parameters must be completed within the Widget:

Parameter	Description	Value
YOUR_SELLER_ID	SellerId issued by Amazon
Type	The parameter Type is an optional parameter for defining the button layout of the button widget.	Permissible values: LwA, Login, PwA, Pay, A
Color	The parameter Color defines the color of the button widget	Permissible values: Gold, LightGray, DarkGray
Size	The parameter Size defines the size of the button widget	Permissible values for normal display resolution: small, medium Permissible values for Retina Displays: large, x-large
Language	The parameter Language is optionally used for defining the language of the checkout process. This is helpful especially within a multilingual shop environment. Without submitting the parameter Language Amazon automatically uses the most suitable language for checkout.	Permissible values: en-GB, de-DE, fr-FR, it-IT, es-ES
Scope	The parameter Scope defines the scope of return parameters after the customer login as well as the contents of the consent form for the customer. Example: scope=payments:shipping_address returns the purchaser’s delivery address.	Permissible values: profile, profil:user_id, payments:widget, payments:shipping_address, payments:billing_address

Further information can be found in the documentation from Amazon Pay.

Integrate address book and wallet widget

The following example code shows how to implement the address book widget:

<div id="addressBookWidgetDiv">
</div>
<script>
new OffAmazonPayments.Widgets.AddressBook({
  sellerId: 'YOUR_SELLER_ID_HERE',
  onOrderReferenceCreate: function(orderReference) {
    orderReference.getAmazonOrderReferenceId();
    // Send SetOrderDetails Request with OrderReferenceId to Computop to    
    // set the amount and get the default address    
  },
  onAddressSelect: function(orderReference) {
    // Send GetOrderDetails Request to get the selected address
  },
  design: {
    designmode: 'responsive'
  },
  onError: function(error) {
    // your error handling code
  }      
}).bind("addressBookWidgetDiv");
</script>

The following example code shows how to implement the wallet widget:

<!--Set your sellerId and import JavaScript libraries necessary for rendering the
wallet widget as explained in the documentation linked to below.-->

<div id="walletWidgetDiv"></div>

<script>
new OffAmazonPayments.Widgets.Wallet({ 
  sellerId: 'YOUR_SELLER_ID_HERE', amazonOrderReferenceId: 'ORO_ID_RETREIVED', displayMode: 'Edit', presentmentCurrency: 'EUR', design: { designMode: 'responsive' },
  onPaymentSelect: function(orderReference){ 
    // Replace this code with the action that you want to perform 
    // after the payment method is chosen. 
    // Ideally this would enable the next action for the buyer 
    // including either a "Continue" or "Place Order" button. 
  },
  onError: function(error){ 
    // Your error handling code. 
    // During development you can use the following 
    // code to view error messages: 
    // console.log(error.getErrorCode() + ': ' + error.getErrorMessage()); // See "Handling Errors" for more information. 
  }

}).bind("walletWidgetDiv");
</script>

The option to logout is usually a link which removes all user data from the website and then re-displays the login page via the amazon.Login.logout() method. Use the following codes for this:

<script type="text/javascript">
  document.getElementById('Logout').onclick = function() {
    amazon.Login.logout();
  };
</script>

Further information can be found in the documentation from Amazon Pay.

Javascript for confirmation flow

Due to Multi Factor Authentication it is necessary after a succesful confirmation of an order to start a new call, the ConfirmationFlow.

The following example code shows how to implement the Javscript function for that:

Function confirmationFlow()
{
    // Get the ResultCode from Computop Call AmazonAPA.aspx EventToken: COR
    var resultCode_Computop = callComputopAmazonAPA_Confirmation();
    // Your AmazonSellerID / AmazonMerchantID
    var amazonSellerId = ‚ABCDEFG123456‘;
    // AmazonOrderReferenceID generated by AdressWidget
    var orderReferenceId = ‚P02-1234567-1234567‘;
    // Initiate Conformation Flow
    OffAmazonPayments.initConfirmationFlow(amazonSellerId, orderReferenceId, function (confirmationFlow) {
        if(resultCode_Computop = ‚00000000‘)
        {
            // Do confirmationFlow with Success Confirm
            confirmationFlow.success();
        }
        else
        {
            // Do confirmationFlow with Failured Confirm
            confirmationFlow.error();
        }
    });
}

Available Event-Token

For Amazon Pay there are numerous possible actions whose selection is controlled at the interface via the EventToken parameter.

The following table gives an overview of possible Eventtoken for AmazonAPA.aspx:

EventToken	Action	Description	Beschreibung
LGN	Login	Initializing of a payment/login-process with Amazon via	Initialisierung einer Zahlung/eines Login-Vorgangs mit Amazon über
SOD	SetOrderDetails	Transfer of amount payable and further information – controls also the payment methods selectable for an order at Amazon	Übergabe des Zahlbetrags und weiterer Informationen – steuert auch die für eine Bestellung wählbaren Zahlarten bei Amazon
SCO	SetOrderDetailsAndConfirmOrder	Order confirmation again with transfer of amount payable and further information – with this Eventtoken the order is finalized. After successfully confirmation authorizations can be submitted to Amazon immediately.	Bestätigung der Bestellung mit nochmaliger Übergabe des Zahlbetrags und weiterer Informationen – durch dieses Eventtoken wird die Bestellung abgeschlossen, und es können bei erfolgreicher Bestätigung sofort Autorisierungen an Amazon eingereicht werden
COD	ConfirmOrderDetails	Optional, if amount payable and further information should not transferred once more for order confirmation ( recommends using the Eventtoken SCO for order confirmation.)	Optional, wenn zur Bestellbestätigung nicht nochmals die Übergabe von Zahlbetrag und weiteren Informationen erfolgen soll ( empfiehlt die Nutzung des Eventtoken SCO für die Bestellbestätigung)
GOD	GetOrderDetails	Request of order information, e.g. to get information about a newly selected delivery address. After a call with Eventtoken COD or SCO, GOD returns also the billing address oft he customer When Scope enters “payments:shipping_address” and “payments:billing_address” you receive the full delivery and shipping address after the display of the Address widget. Please transfer the OrderReferenceId on call up.	Abfrage der Order-Informationen, um z.B. Informationen über eine neu gewählte Lieferadresse zu erhalten. Nach einem Aufruf mit Eventtoken COD oder SCO liefert GOD auch die Rechnungsadresse des Kunden zurück. Bei Angabe von Scope „payments:shipping_address“ und “payments:billing_address” erhalten Sie die vollständige Liefer- und Versandadresse bereits nach Anzeige des Adress-Widgets. Übergeben Sie hierzu beim Aufruf bitte die OrderReferenceId.
ATH	Authorize	Eventtoken for authorization	Eventtoken für die Autorisierung
COR	CloseOrderReference	Closing an Amazon order. Captures related to open authorizations as well as credits are possible furthermore.	Schließen einer Order bei Amazon. Es sind weiterhin Buchungen auf offene Autorisierungen und Gutschriften möglich.
RAN	ReverseAuthorization	Closing an open authorization	Schließen einer offenen Autorisierung
ATD	AuthorizeDetails	Status request for an authorization	Statusabfrage einer Autorisierung
CAD	CaptureDetails	Status request for an capture	Statusabfrage einer Buchung (Capture)
CRD	CreditDetails	Status request for an credit	Statusabfrage einer Gutschrift (Credit)

Process flow chart

conditio

Process flow for Amazon Pay within

Process flow for Multi-factor authentication

This action should be triggered by clicked the "Buy Now" button. When MFA is required, the Confirmation Flow (see Javascript above) shows the credit card issuer’s MFA challenge to the buyer. After the buyer interacts with the Confirmation Flow (for example, completes the MFA challenge), the buyer is returned to the merchant’s site (for example, order confirmation page). The merchant should be able to handle the redirection (URLSuccess / URLFailure) with the result of the MFA Challenge.

In case of amazonstatus=Success the purchase is completed. In case of amazonstatus=Failure or amazonStatus=Abandoned the customer is redirected to the URLFailure and the merchant should cancel the order by calling reverse,aspx (see below in chapter "Amazon Pay reverse an authorization"). The customer can be redirected to select a different payment method or in case of Abandoned to replace the order and complete the MFA challange.

Instead of the one-step solution with EventToken=SCO the process can be splitted into EventToken=SOD and EventToken=COD followed by the Confirmation Flow.

Process flow for Multi-factor authentication with Amazon Pay (amazonstatus=Success)

Process flow for failed Multi-factor authentication with Amazon Pay (amazonstatus=Failure or Abandoned)

interface

Initialize Amazon Pay interface

In order to initialize a payment with Amazon Pay, please use the following URL:

AmazonAPA.aspx

Key	Format	CND	Description	Beschreibung
CountryCode	an2	M	Country code of used marketplace. Presently only DE and GB permitted.	Länderkennung des genutzten Marketplace. Derzeit nur DE und GB erlaubt.
URLNotify	ans..256	C	Complete URL which calls up in order to notify the shop about the payment result. The URL may be called up only via port 443. It may not contain parameters. Optional if an URLNotify is permanently defined at the .	Vollständige URL, die das aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten. Optional, wenn eine URLNotify am fest definiert ist.
AccessToken	a..512	M	Parameter „access_token“ which is transferred during the redirect from Amazon after the customer has logged in. Used to request the full delivery address during the checkout process. Important: It can be used only, if for Scope is given at least „payments:shipping_address“ within the button widget.	Parameter „access_token“, der beim Redirect von Amazon nach Login durch den Kunden übermittelt wird. Dient der Abfrage der vollständigen Lieferadresse bereits während des Checkout-Prozesses. Wichtig: Kann nur verwendet werden, wenn im Button-Widget als Scope mindestens „payments:shipping_address“ angegeben ist.
TokenType	ans..6	M	Parameter „token_type“ which is transferred during the redirect from Amazon after the customer has logged in.	Parameter „token_type“, der beim Redirect von Amazon nach Login durch den Kunden übermittelt wird.
Expiry	n..4	M	Parameter „expires_in“ which is transferred during the redirect from Amazon after the customer has logged in.	Parameter „expires_in“, der beim Redirect von Amazon nach Login durch den Kunden übermittelt wird.
Scope	a..128	M	Parameter „scope“ which is transferred during the redirect from Amazon after the customer has logged in. Important: Within the button widget use at least the values „profile payments:widget and payments:shipping_address“.	Parameter „scope“, der beim Redirect von Amazon nach Login durch den Kunden übermittelt wird. Wichtig: Verwenden Sie im Button-Widget mindestens die Werte „profile payments:widget payments:shipping_address“.
EventToken	enum	M	Abbreviation of the action to be done: <LGN> = Login	Abkürzung der auszuführenden Aktion <LGN> = Login
OrderDesc	ans..127	O	Use this parameter for the simulation mode. During live mode this parameter has no effects.	Nutzen Sie diesen Parameter für den Simulationsmodus. Im Livebetrieb hat dieser Parameter keine Auswirkungen.

Encrypted parameters for initializing an Amazon Pay payment

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
Key	Format	CND	Shipping information	Versandinformationen
UserID	as..64	O	part of the userprofile information. Unique ID issued by Amazon per user.	Teil der Benutzerprofil-Informationen. Eindeutige von Amazon pro User vergebene ID.
BuyerName	as..50	O	part of the userprofile information. User name	Teil der Benutzerprofil-Informationen. Benutzername
BuyerMail	as..128	O	part of the userprofile information. E-mail address	Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrZip	as..128	O	part of the userprofile information. Postcode in the standard delivery address	Teil der Benutzerprofil-Informationen. Postleitzahl der Standard-Lieferadresse

Response parameters after initializing an Amazon Pay payment

Amazon Pay set order details

In order to confirm the order details of a payment with Amazon Pay with the function „SetOrderDetails“, please visit the following URL:

AmazonAPA.aspx

The following tables describe the transfer parameters and return values which are exchanged via the socket connection. The server-to-server communication process is described in the manual Programming basics.

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..127	M	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise etc.
OrderReferenceID	ans..19	O	OrderReferenceId generated by button widget or by address widget which is read out via JavaScript using „OrderReference.getAmazonOrderReferenceId()“	Vom Button-Widget oder Adress-Widget erzeugte OrderReferenceId, die per JavaScript mittels „orderReference.getAmazonOrderReferenceId()“ ausgelesen wird
StoreName	ans..1024	O	Name of the shop. Is printed in email to customer.	Name des Shops. Wird in E-Mail an Kunden abgedruckt.
EventToken	enum	M	Abbreviation of the action to be done: <SOD> = SetOrderDetails <SCO> = SetOrderDetailsAndConfirmOrder	Abkürzung der auszuführenden Aktion <SOD> = SetOrderDetails <SCO> = SetOrderDetailsAndConfirmOrder
URLSuccess	ans..256	M	The buyer is redirected to this URL if the Multi Factor Authentication is successful.	Der Käufer wird zu dieser URL weitergeleitet, wenn die Multi-Faktor-Authentisierung erfolgreich war.
URLFailure	ans..256	O	The buyer is redirected to this URL if the Multi Factor Authentication is unsuccessful.	Der Käufer wird zu dieser URL weitergeleitet, wenn die Multi-Faktor-Authentisierung nicht erfolgreich war.
AuthorizationAmount	n..10	O	The amount to authenticate during Multi Factor Authentication completion. Use this parameter if you want to set a payment amount that is different than the OrderTotal provided in the SetOrderReferenceDetails operation call. If this parameter is not set, the amount authenticated during Multi Factor Authentication will be equal to the OrderTotal provided in the SetOrderReferenceDetails operation call.	Der während der Multi-Faktor-Authentisierung zu authentisierende Betrag. Verwenden Sie diesen Parameter, wenn Sie einen vom Wert in OrderTotal beim Aufruf von SetOrderReferenceDetails abweichenden Zahlungsbetrag festlegen wollen. Wenn dieser Parameter nicht gesetzt wird, ist der bei der Multi-Faktor-Authentisierung authentisierte Betrag gleich dem Wert von OrderTotal aus dem Aufruf von SetOrderReferenceDetails.

Encrypted parameters for calling SetOrderDetails and SetOrderDetailsAndConfirmOrder for an Amazon Pay payment

Notice: You can combine calling SetOrderDetails and ConfirmOrderDetails, if you are using EventToken <SCO> for SetOrderDetailsAndConfirmOrder.

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide .
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.

Key	Format	CND	Description	Beschreibung
Key	Format	CND	Shipping information	Versandinformationen
BuyerName	a..50	O	part of the userprofile information. User name	Teil der Benutzerprofil-Informationen. Benutzername
BuyerMail	as..128	O	part of the userprofile information. E-mail address	Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrName	a..50	O	First name and surname of addressee	Vorname und Nachname des Adressaten
PhoneNumber	a..128	O	Phone number of addressee	Telefonnummer des Adressaten
AddrCountryCode	a2	O	Country code of delivery country according to ISO 3166	Ländercode des Lieferlandes gemäß ISO 3166
AddrState	a..50	O	Federal state of the delivery address	Bundesland der Lieferadresse
AddrCounty	a..50	O	County of delivery address	Landkreis der Lieferadresse
AddrDistrict	a..50	O	District of delivery address	Bezirk der Lieferadresse
AddrZip	a..20	O	Postcode in the delivery address	Postleitzahl der Lieferadresse
AddrCity	a..50	O	Town/city in the delivery address	Ortsname der Lieferadresse
AddrStreet	a..180	O	Company name (if given) or street name and street number	Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer
AddrStreet2	a..60	O	Street name and house number	Straßenname mit Hausnummer
AddrStreet3	a..60	O	Other additions	Sonstige Zusätze

Response parameters after SetOrderDetails and SetOrderDetailsAndConfirmOrder for an Amazon Pay payment

Amazon Pay request order details

In order to request the order details of a payment with Amazon Pay with the function „GetOrderDetails“, please visit the following URL:

AmazonAPA.aspx

The following tables describe the transfer parameters and return values which are exchanged via the socket connection. The server-to-server communication process is described in the manual Programming basics.

Key

Format

CND

Description

Beschreibung

EventToken

enum

M

Abbreviation of the action to be done:

<GOD> = GetOrderDetails

Abkürzung der auszuführenden Aktion

<GOD> = GetOrderDetails

OrderReferenceID

ans..19

O

If not already submitted for <SOD> SetOrderDetails

Falls noch nicht bei <SOD> SetOrderDetails übergeben

OrderDesc

ans..127

O

Use this parameter for the simulation mode. During live mode this parameter has no effects.

Nutzen Sie diesen Parameter für den Simulationsmodus. Im Livebetrieb hat dieser Parameter keine Auswirkungen.

Encrypted parameters for calling GetOrderDetails for an Amazon Pay payment

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide .
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde
Key	Format	CND	Shipping information	Versandinformationen
BuyerName	a..50	O	part of the userprofile information. User name	Teil der Benutzerprofil-Informationen. Benutzername
BuyerMail	as..128	O	part of the userprofile information. E-mail address	Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrName	a..50	O	First name and surname of addressee	Vorname und Nachname des Adressaten
PhoneNumber	a..128	O	Phone number of addressee	Telefonnummer des Adressaten
AddrCountryCode	a2	O	Country code of delivery country according to ISO 3166	Ländercode des Lieferlandes gemäß ISO 3166
AddrState	a..50	O	Federal state of the delivery address	Bundesland der Lieferadresse
AddrCounty	a..50	O	County of delivery address	Landkreis der Lieferadresse
AddrDistrict	a..50	O	District of delivery address	Bezirk der Lieferadresse
AddrZip	a..20	O	Postcode in the delivery address	Postleitzahl der Lieferadresse
AddrCity	a..50	O	Town/city in the delivery address	Ortsname der Lieferadresse
AddrStreet	a..180	O	Company name (if given) or street name and street number	Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer
AddrStreet2	a..60	O	Street name and house number	Straßenname mit Hausnummer
AddrStreet3	a..60	O	Other additions	Sonstige Zusätze
Key	Format	CND	Billing address (only for Scope="payments:billing_address")	Rechnungsadresse (nur bei Scope="payments:billing_address")
bdAddrName	a..50	O	First name and surname of addressee in the billing address	Vorname und Nachname des Adressaten der Rechnungsadresse
bdPhoneNumber	a..128	O	Phone number of addressee in the billing address	Telefonnummer des Adressaten der Rechnungsadresse
bdAddrCountryCode	a2	O	Country code of the billing country according to ISO 3166	Ländercode des Rechnungslandes gemäß ISO 3166
bdAddrState	a..50	O	Federal state in the invoicing address	Bundesland der Rechnungsadresse
bdAddrCounty	a..50	O	County of billing address	Landkreis der Rechnungsadresse
bdAddrDistrict	a..50	O	District of billing address	Bezirk der Rechnungsadresse
bdAddrZip	a..20	O	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdAddrCity	a..50	O	Name of town/city in the billing address	Ortsname der Rechnungsadresse
bdAddrStreet	a..180	O	Company name (if given) or street name and street number in the billing address	Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer der Rechnungsadresse
bdAddrStreet2	a..60	O	Street name and street number in the billing address	Straßenname mit Hausnummer der Rechnungsadresse
bdAddrStreet3	a..60	O	Other additions in the billing address	Sonstige Zusätze der Rechnungsadresse

Response parameters after GetOrderDetails of an Amazon Pay payment

Amazon Pay confirm order details

In order to confirm the order details of a payment with Amazon Pay with the function „ConfirmOrderDetails“, please visit the following URL:

AmazonAPA.aspx

The following tables describe the transfer parameters and return values which are exchanged via the socket connection. The server-to-server communication process is described in the manual Programming basics.

Key	Format	CND	Description	Beschreibung
EventToken	a3	M	Abbreviation of the action to be done: <COD> = ConfirmOrderDetails	Abkürzung der auszuführenden Aktion: <COD> = ConfirmOrderDetails
URLSuccess	ans..256	M	The buyer is redirected to this URL if the Multi Factor Authentication is successful.	Der Käufer wird zu dieser URL weitergeleitet, wenn die Multi-Faktor-Authentisierung erfolgreich war.
URLFailure	ans..256	O	The buyer is redirected to this URL if the Multi Factor Authentication is unsuccessful.	Der Käufer wird zu dieser URL weitergeleitet, wenn die Multi-Faktor-Authentisierung nicht erfolgreich war.
URLNotify	ans..256	M	Complete URL which calls up in order to notify the shop about the payment result. The URL may be called up only via port 443. It may not contain parameters.	Vollständige URL, die das aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten.
AuthorizationAmount	n..10	O	The amount to authenticate during Multi Factor Authentication completion. Use this parameter if you want to set a payment amount that is different than the OrderTotal provided in the SetOrderReferenceDetails operation call. If this parameter is not set, the amount authenticated during Multi Factor Authentication will be equal to the OrderTotal provided in the SetOrderReferenceDetails operation call.	Der während der Multi-Faktor-Authentisierung zu authentisierende Betrag. Verwenden Sie diesen Parameter, wenn Sie einen vom Wert in OrderTotal beim Aufruf von SetOrderReferenceDetails abweichenden Zahlungsbetrag festlegen wollen. Wenn dieser Parameter nicht gesetzt wird, ist der bei der Multi-Faktor-Authentisierung authentisierte Betrag gleich dem Wert von OrderTotal aus dem Aufruf von SetOrderReferenceDetails.

Encrypted parameters for calling ConfirmOrderDetails for an Amazon Pay payment

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide .
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Key	Format	CND	Description	Beschreibung
Key	Format	CND	Shipping information	Versandinformationen
BuyerName	a..50	O	part of the userprofile information. User name	Teil der Benutzerprofil-Informationen. Benutzername
BuyerMail	as..128	O	part of the userprofile information. E-mail address	Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrName	a..50	O	First name and surname of addressee	Vorname und Nachname des Adressaten
PhoneNumber	a..128	O	Phone number of addressee	Telefonnummer des Adressaten
AddrCountryCode	a2	O	Country code of delivery country according to ISO 3166	Ländercode des Lieferlandes gemäß ISO 3166
AddrState	a..50	O	Federal state of the delivery address	Bundesland der Lieferadresse
AddrCounty	a..50	O	County of delivery address	Landkreis der Lieferadresse
AddrDistrict	a..50	O	District of delivery address	Bezirk der Lieferadresse
AddrZip	a..20	O	Postcode in the delivery address	Postleitzahl der Lieferadresse
AddrCity	a..50	O	Town/city in the delivery address	Ortsname der Lieferadresse
AddrStreet	a..180	O	Company name (if given) or street name and street number	Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer
AddrStreet2	a..60	O	Street name and house number	Straßenname mit Hausnummer
AddrStreet3	a..60	O	Other additions	Sonstige Zusätze
Key	Format	CND	Billing address (only for Scope="payments:billing_address")	Rechnungsadresse (nur bei Scope="payments:billing_address")
bdAddrName	a..50	O	First name and surname of addressee in the billing address	Vorname und Nachname des Adressaten der Rechnungsadresse
bdPhoneNumber	a..128	O	Phone number of addressee in the billing address	Telefonnummer des Adressaten der Rechnungsadresse
bdAddrCountryCode	a2	O	Country code of the billing country according to ISO 3166	Ländercode des Rechnungslandes gemäß ISO 3166
bdAddrState	a..50	O	Federal state in the invoicing address	Bundesland der Rechnungsadresse
bdAddrCounty	a..50	O	County of billing address	Landkreis der Rechnungsadresse
bdAddrDistrict	a..50	O	District of billing address	Bezirk der Rechnungsadresse
bdAddrZip	a..20	O	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdAddrCity	a..50	O	Name of town/city in the billing address	Ortsname der Rechnungsadresse
bdAddrStreet	a..180	O	Company name (if given) or street name and street number in the billing address	Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer der Rechnungsadresse
bdAddrStreet2	a..60	O	Street name and street number in the billing address	Straßenname mit Hausnummer der Rechnungsadresse
bdAddrStreet3	a..60	O	Other additions in the billing address	Sonstige Zusätze der Rechnungsadresse

Response parameters after ConfirmOrderDetails of an Amazon Pay payment

In case of an error (e.g. if Amazon refuses the payment) you get a notify to your specified URLNotify with following parameters:

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide .
NotificationType	a..25	M	Describes the type of notifcation. Fixed value: <OrderNotification>	Beschreibt die Art der Benachrichtigung. Fester Wert: <OrderNotification>

Response parameters to URLNotify after ConfirmOrderDetails for an Amazon Pay payment

Amazon Pay finalize authorization

In order to authorize a payment with Amazon Pay, please visit the following URL:

AmazonAPA.aspx

The following tables describe the transfer parameters and return values which are exchanged via the socket connection. The server-to-server communication process is described in the manual Programming basics.

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..127	M	Description of purchased goods, unit prices etc. for authorization	Beschreibung der gekauften Waren, Einzelpreise etc. zur Autorisierung
ChDesc	ans..16	O	Text printed on the customer’s credit card bill alongside the payee (only for Capture=AUTO or Capture=<NUMBER>)	Text der auf der Abrechnung des Kreditinstituts des Kunden erscheint (nur bei Capture=AUTO oder Capture=<ZAHL>)
EventToken	enum	M	Abbreviation of the action to be done: <ATH> = Authorize	Abkürzung der auszuführenden Aktion: <ATH> = Authorize

Encrypted parameters for authorizing an Amazon Pay payment

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide .
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefID	ans..27	M	Unique ID for the transaction issued by Amazon	Von Amazon vergebene eindeutige ID für die Transaktion

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Key	Format	CND	Description	Beschreibung
Key	Format	CND	Shipping information	Versandinformationen
BuyerName	a..50	O	part of the userprofile information. User name	Teil der Benutzerprofil-Informationen. Benutzername
BuyerMail	as..128	O	part of the userprofile information. E-mail address	Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrName	a..50	O	First name and surname of addressee	Vorname und Nachname des Adressaten
PhoneNumber	a..128	O	Phone number of addressee	Telefonnummer des Adressaten
AddrCountryCode	a2	O	Country code of delivery country according to ISO 3166	Ländercode des Lieferlandes gemäß ISO 3166
AddrState	a..50	O	Federal state of the delivery address	Bundesland der Lieferadresse
AddrCounty	a..50	O	County of delivery address	Landkreis der Lieferadresse
AddrDistrict	a..50	O	District of delivery address	Bezirk der Lieferadresse
AddrZip	a..20	O	Postcode in the delivery address	Postleitzahl der Lieferadresse
AddrCity	a..50	O	Town/city in the delivery address	Ortsname der Lieferadresse
AddrStreet	a..180	O	Company name (if given) or street name and street number	Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer
AddrStreet2	a..60	O	Street name and house number	Straßenname mit Hausnummer
AddrStreet3	a..60	O	Other additions	Sonstige Zusätze
Key	Format	CND	Invoicing address	Rechnungsadresse
bdAddrName	a..50	O	First name and surname of addressee in the billing address	Vorname und Nachname des Adressaten der Rechnungsadresse
bdPhoneNumber	a..128	O	Phone number of addressee in the billing address	Telefonnummer des Adressaten der Rechnungsadresse
bdAddrCountryCode	a2	O	Country code of the billing country according to ISO 3166	Ländercode des Rechnungslandes gemäß ISO 3166
bdAddrState	a..50	O	Federal state in the invoicing address	Bundesland der Rechnungsadresse
bdAddrCounty	a..50	O	County of billing address	Landkreis der Rechnungsadresse
bdAddrDistrict	a..50	O	District of billing address	Bezirk der Rechnungsadresse
bdAddrZip	a..20	O	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdAddrCity	a..50	O	Name of town/city in the billing address	Ortsname der Rechnungsadresse
bdAddrStreet	a..180	O	Company name (if given) or street name and street number in the billing address	Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer der Rechnungsadresse
bdAddrStreet2	a..60	O	Street name and street number in the billing address	Straßenname mit Hausnummer der Rechnungsadresse
bdAddrStreet3	a..60	O	Other additions in the billing address	Sonstige Zusätze der Rechnungsadresse

Response parameters after authorization of an Amazon Pay payment

After an authorization you get a notify to your specified URLNotify with following parameters:

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide .
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefID	ans..27	M	Unique ID for the transaction issued by Amazon	Von Amazon vergebene eindeutige ID für die Transaktion

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Key	Format	CND	Description	Beschreibung
Key	Format	CND	Shipping information	Versandinformationen
BuyerName	a..50	O	part of the userprofile information. User name	Teil der Benutzerprofil-Informationen. Benutzername
BuyerMail	as..128	O	part of the userprofile information. E-mail address	Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrName	a..50	O	First name and surname of addressee	Vorname und Nachname des Adressaten
PhoneNumber	a..128	O	Phone number of addressee	Telefonnummer des Adressaten
AddrCountryCode	a2	O	Country code of delivery country according to ISO 3166	Ländercode des Lieferlandes gemäß ISO 3166
AddrState	a..50	O	Federal state of the delivery address	Bundesland der Lieferadresse
AddrCounty	a..50	O	County of delivery address	Landkreis der Lieferadresse
AddrDistrict	a..50	O	District of delivery address	Bezirk der Lieferadresse
AddrZip	a..20	O	Postcode in the delivery address	Postleitzahl der Lieferadresse
AddrCity	a..50	O	Town/city in the delivery address	Ortsname der Lieferadresse
AddrStreet	a..180	O	Company name (if given) or street name and street number	Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer
AddrStreet2	a..60	O	Street name and house number	Straßenname mit Hausnummer
AddrStreet3	a..60	O	Other additions	Sonstige Zusätze
Key	Format	CND	Invoicing address	Rechnungsadresse
bdAddrName	a..50	O	First name and surname of addressee in the billing address	Vorname und Nachname des Adressaten der Rechnungsadresse
bdPhoneNumber	a..128	O	Phone number of addressee in the billing address	Telefonnummer des Adressaten der Rechnungsadresse
bdAddrCountryCode	a2	O	Country code of the billing country according to ISO 3166	Ländercode des Rechnungslandes gemäß ISO 3166
bdAddrState	a..50	O	Federal state in the invoicing address	Bundesland der Rechnungsadresse
bdAddrCounty	a..50	O	County of billing address	Landkreis der Rechnungsadresse
bdAddrDistrict	a..50	O	District of billing address	Bezirk der Rechnungsadresse
bdAddrZip	a..20	O	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdAddrCity	a..50	O	Name of town/city in the billing address	Ortsname der Rechnungsadresse
bdAddrStreet	a..180	O	Company name (if given) or street name and street number in the billing address	Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer der Rechnungsadresse
bdAddrStreet2	a..60	O	Street name and street number in the billing address	Straßenname mit Hausnummer der Rechnungsadresse
bdAddrStreet3	a..60	O	Other additions in the billing address	Sonstige Zusätze der Rechnungsadresse

Response parameters to URLNotify after authorization of an Amazon Pay payment

Amazon Pay capture a payment

In order to capture an authorized payment with Amazon Pay, please visit the following URL:

capture.aspx

The following tables describe the transfer parameters and return values which are exchanged via the socket connection. The server-to-server communication process is described in the manual Programming basics.

Key	Format	CND	Description	Beschreibung
ChDesc	ans..16	O	Text printed on the customer’s credit card bill alongside the payee	Text der auf der Abrechnung des Kreditinstituts des Kunden erscheint
OrderDesc	ans..127	M	Use this parameter for the simulation mode. During live mode this parameter has no effects.	Nutzen Sie diesen Parameter für den Simulationsmodus. Im Livebetrieb hat dieser Parameter keine Auswirkungen.

Encrypted parameters for capturing an authorized Amazon Pay payment

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide .
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Response parameters after capturing an authorized Amazon Pay payment

After a capture you get a notify to your specified URLNotify with following parameters:

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide .
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefID	ans..27	M	Unique ID for the transaction issued by Amazon	Von Amazon vergebene eindeutige ID für die Transaktion

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde
NotificationType	a..25	M	Describes the type of notification. Fixed value: <CaptureNotification>	Beschreibt die Art der Benachrichtigung. Fester Wert: <CaptureNotification>

Response parameters to URLNotify after capturing an authorized Amazon Pay payment

Amazon Pay credit a payment

In order to credit a captured payment with Amazon Pay, please visit the following URL:

credit.aspx

The following tables describe the transfer parameters and return values which are exchanged via the socket connection. The server-to-server communication process is described in the manual Programming basics.

Key	Format	CND	Description	Beschreibung
ChDesc	ans..16	O	Text printed on the customer’s credit card bill alongside the payee	Text der auf der Abrechnung des Kreditinstituts des Kunden erscheint
OrderDesc	ans..127	M	Description of purchased goods, unit prices etc. for authorization	Beschreibung der gekauften Waren, Einzelpreise etc. zur Buchung

Encrypted parameters for crediting an Amazon Pay payment

Key	Format	CND	Description	Beschreibung
Status	a..30	M	REQUEST (Because credits are not carried out real time, the status is always pending.)	REQUEST (Da Gutschriften nicht in Echtzeit ausgeführt werden, ist der Status zunächst stets wartend.)

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide .
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Response parameters after crediting an authorized Amazon Pay payment

After a credit you get a notify to your specified URLNotify with following parameters:

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide .
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefID	ans..27	M	Unique ID for the transaction issued by Amazon	Von Amazon vergebene eindeutige ID für die Transaktion

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde
NotificationType	a..25	M	Describes the type of notification. Fixed value: <CreditNotification>	Beschreibt die Art der Benachrichtigung. Fester Wert: <CreditNotification>

Response parameters to URLNotify after credit of an Amazon Pay payment

Amazon Pay close an order

In order to close an order with Amazon Pay with the function „CloseOrder“, please visit the following URL:

AmazonAPA.aspx

The following tables describe the transfer parameters and return values which are exchanged via the socket connection. The server-to-server communication process is described in the manual Programming basics.

Key	Format	CND	Description	Beschreibung
EventToken	an3	M	Abbreviation of the action to be done: <COR> = CloseOrderReference	Abkürzung der auszuführenden Aktion: <COR> = CloseOrderReference

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..127	M	Use this parameter for the simulation mode. During live mode this parameter has no effects.	Nutzen Sie diesen Parameter für den Simulationsmodus. ImLivebetrieb hat dieser Parameter keine Auswirkungen.

Encrypted parameters for closing an Amazon Pay payment

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide .
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Key	Format	CND	Description	Beschreibung
Key	Format	CND	Shipping information	Versandinformationen
BuyerName	a..50	O	part of the userprofile information. User name	Teil der Benutzerprofil-Informationen. Benutzername
BuyerMail	as..128	O	part of the userprofile information. E-mail address	Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrName	a..50	O	First name and surname of addressee	Vorname und Nachname des Adressaten
PhoneNumber	a..128	O	Phone number of addressee	Telefonnummer des Adressaten
AddrCountryCode	a2	O	Country code of delivery country according to ISO 3166	Ländercode des Lieferlandes gemäß ISO 3166
AddrState	a..50	O	Federal state of the delivery address	Bundesland der Lieferadresse
AddrCounty	a..50	O	County of delivery address	Landkreis der Lieferadresse
AddrDistrict	a..50	O	District of delivery address	Bezirk der Lieferadresse
AddrZip	a..20	O	Postcode in the delivery address	Postleitzahl der Lieferadresse
AddrCity	a..50	O	Town/city in the delivery address	Ortsname der Lieferadresse
AddrStreet	a..180	O	Company name (if given) or street name and street number	Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer
AddrStreet2	a..60	O	Street name and house number	Straßenname mit Hausnummer
AddrStreet3	a..60	O	Other additions	Sonstige Zusätze
Key	Format	CND	Invoicing address	Rechnungsadresse
bdAddrName	a..50	O	First name and surname of addressee in the billing address	Vorname und Nachname des Adressaten der Rechnungsadresse
bdPhoneNumber	a..128	O	Phone number of addressee in the billing address	Telefonnummer des Adressaten der Rechnungsadresse
bdAddrCountryCode	a2	O	Country code of the billing country according to ISO 3166	Ländercode des Rechnungslandes gemäß ISO 3166
bdAddrState	a..50	O	Federal state in the invoicing address	Bundesland der Rechnungsadresse
bdAddrCounty	a..50	O	County of billing address	Landkreis der Rechnungsadresse
bdAddrDistrict	a..50	O	District of billing address	Bezirk der Rechnungsadresse
bdAddrZip	a..20	O	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdAddrCity	a..50	O	Name of town/city in the billing address	Ortsname der Rechnungsadresse
bdAddrStreet	a..180	O	Company name (if given) or street name and street number in the billing address	Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer der Rechnungsadresse
bdAddrStreet2	a..60	O	Street name and street number in the billing address	Straßenname mit Hausnummer der Rechnungsadresse
bdAddrStreet3	a..60	O	Other additions in the billing address	Sonstige Zusätze der Rechnungsadresse

Response parameters after closing an Amazon Pay payment

Amazon Pay reverse an order

In order to reverse a complete order with Amazon Pay with the function „CancelOrderReference“, please visit the following URL:

reverse.aspx

The following tables describe the transfer parameters and return values which are exchanged via the socket connection. The server-to-server communication process is described in the manual Programming basics.

Key	Format	CND	Description	Beschreibung
Reason	a..1024	O	Reason for reversal	Grund der Stornierung

Encrypted parameters for reversal of an Amazon Pay payment

Key	Format	CND	Description	Beschreibung
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Response parameters after reversing an Amazon Pay payment

Notice: If you are reversing an order completely, you will get also a notify like for an incorrect order as described above.

Amazon Pay reverse an authorization

In order to reverse a single authorization with Amazon Pay with the function „CancelAuthorize“, please visit the following URL:

AmazonAPA.aspx

The following tables describe the transfer parameters and return values which are exchanged via the socket connection. The server-to-server communication process is described in the manual Programming basics.

Key	Format	CND	Description	Beschreibung
Reason	a..1024	M	Reason for reversal	Grund der Stornierung
EventToken	an3	M	Abbreviation of the action to be done: <RAN> = ReverseAuthorization	Abkürzung der auszuführenden Aktion: <RAN> = ReverseAuthorization

Encrypted parameters for reverse an Amazon Pay authorization

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide .
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefID	ans..27	M	Unique ID for the transaction issued by Amazon	Von Amazon vergebene eindeutige ID für die Transaktion

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Key	Format	CND	Description	Beschreibung
Key	Format	CND	Shipping information	Versandinformationen
BuyerName	a..50	O	part of the userprofile information. User name	Teil der Benutzerprofil-Informationen. Benutzername
BuyerMail	as..128	O	part of the userprofile information. E-mail address	Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrName	a..50	O	First name and surname of addressee	Vorname und Nachname des Adressaten
PhoneNumber	a..128	O	Phone number of addressee	Telefonnummer des Adressaten
AddrCountryCode	a2	O	Country code of delivery country according to ISO 3166	Ländercode des Lieferlandes gemäß ISO 3166
AddrState	a..50	O	Federal state of the delivery address	Bundesland der Lieferadresse
AddrCounty	a..50	O	County of delivery address	Landkreis der Lieferadresse
AddrDistrict	a..50	O	District of delivery address	Bezirk der Lieferadresse
AddrZip	a..20	O	Postcode in the delivery address	Postleitzahl der Lieferadresse
AddrCity	a..50	O	Town/city in the delivery address	Ortsname der Lieferadresse
AddrStreet	a..180	O	Company name (if given) or street name and street number	Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer
AddrStreet2	a..60	O	Street name and house number	Straßenname mit Hausnummer
AddrStreet3	a..60	O	Other additions	Sonstige Zusätze
Key	Format	CND	Invoicing address	Rechnungsadresse
bdAddrName	a..50	O	First name and surname of addressee in the billing address	Vorname und Nachname des Adressaten der Rechnungsadresse
bdPhoneNumber	a..128	O	Phone number of addressee in the billing address	Telefonnummer des Adressaten der Rechnungsadresse
bdAddrCountryCode	a2	O	Country code of the billing country according to ISO 3166	Ländercode des Rechnungslandes gemäß ISO 3166
bdAddrState	a..50	O	Federal state in the invoicing address	Bundesland der Rechnungsadresse
bdAddrCounty	a..50	O	County of billing address	Landkreis der Rechnungsadresse
bdAddrDistrict	a..50	O	District of billing address	Bezirk der Rechnungsadresse
bdAddrZip	a..20	O	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdAddrCity	a..50	O	Name of town/city in the billing address	Ortsname der Rechnungsadresse
bdAddrStreet	a..180	O	Company name (if given) or street name and street number in the billing address	Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer der Rechnungsadresse
bdAddrStreet2	a..60	O	Street name and street number in the billing address	Straßenname mit Hausnummer der Rechnungsadresse
bdAddrStreet3	a..60	O	Other additions in the billing address	Sonstige Zusätze der Rechnungsadresse

Response parameters after reversal of an Amazon Pay authorization

Notice: If you reverse an authorization you will also get a notify similar to the above described notify for authorization.

Amazon Pay request authorization details

In order to request the details of an authorization with Amazon Pay, please visit the following URL:

AmazonAPA.aspx

The following tables describe the transfer parameters and return values which are exchanged via the socket connection. The server-to-server communication process is described in the manual Programming basics.

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..127	O	Use this parameter for the simulation mode. During live mode this parameter has no effects.	Nutzen Sie diesen Parameter für den Simulationsmodus. ImLivebetrieb hat dieser Parameter keine Auswirkungen.
EventToken	an3	M	Abbreviation of the action to be done: <ATD> = AuthorizeDetails	Abkürzung der auszuführenden Aktion: <ATD> = AuthorizeDetails

Encrypted parameters for requesting details of an Amazon Pay authorization

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide .
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefID	ans..27	M	Unique ID for the transaction issued by Amazon	Von Amazon vergebene eindeutige ID für die Transaktion

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Key	Format	CND	Description	Beschreibung
Key	Format	CND	Shipping information	Versandinformationen
BuyerName	a..50	O	part of the userprofile information. User name	Teil der Benutzerprofil-Informationen. Benutzername
BuyerMail	as..128	O	part of the userprofile information. E-mail address	Teil der Benutzerprofil-Informationen. E-Mail-Adresse
AddrName	a..50	O	First name and surname of addressee	Vorname und Nachname des Adressaten
PhoneNumber	a..128	O	Phone number of addressee	Telefonnummer des Adressaten
AddrCountryCode	a2	O	Country code of delivery country according to ISO 3166	Ländercode des Lieferlandes gemäß ISO 3166
AddrState	a..50	O	Federal state of the delivery address	Bundesland der Lieferadresse
AddrCounty	a..50	O	County of delivery address	Landkreis der Lieferadresse
AddrDistrict	a..50	O	District of delivery address	Bezirk der Lieferadresse
AddrZip	a..20	O	Postcode in the delivery address	Postleitzahl der Lieferadresse
AddrCity	a..50	O	Town/city in the delivery address	Ortsname der Lieferadresse
AddrStreet	a..180	O	Company name (if given) or street name and street number	Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer
AddrStreet2	a..60	O	Street name and house number	Straßenname mit Hausnummer
AddrStreet3	a..60	O	Other additions	Sonstige Zusätze
Key	Format	CND	Invoicing address	Rechnungsadresse
bdAddrName	a..50	O	First name and surname of addressee in the billing address	Vorname und Nachname des Adressaten der Rechnungsadresse
bdPhoneNumber	a..128	O	Phone number of addressee in the billing address	Telefonnummer des Adressaten der Rechnungsadresse
bdAddrCountryCode	a2	O	Country code of the billing country according to ISO 3166	Ländercode des Rechnungslandes gemäß ISO 3166
bdAddrState	a..50	O	Federal state in the invoicing address	Bundesland der Rechnungsadresse
bdAddrCounty	a..50	O	County of billing address	Landkreis der Rechnungsadresse
bdAddrDistrict	a..50	O	District of billing address	Bezirk der Rechnungsadresse
bdAddrZip	a..20	O	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdAddrCity	a..50	O	Name of town/city in the billing address	Ortsname der Rechnungsadresse
bdAddrStreet	a..180	O	Company name (if given) or street name and street number in the billing address	Firmenname (wenn angegeben), sonst Straßenname mit Hausnummer der Rechnungsadresse
bdAddrStreet2	a..60	O	Street name and street number in the billing address	Straßenname mit Hausnummer der Rechnungsadresse
bdAddrStreet3	a..60	O	Other additions in the billing address	Sonstige Zusätze der Rechnungsadresse

Response parameters for requesting details of an Amazon Pay authorization

Amazon Pay request capture details

In order to request the details of a capture with Amazon Pay, please visit the following URL:

AmazonAPA.aspx

The following tables describe the transfer parameters and return values which are exchanged via the socket connection. The server-to-server communication process is described in the manual Programming basics.

Key	Format	CND	Description	Beschreibung
EventToken	an3	M	Abbreviation of the action to be done: <CAD> = CaptureDetails	Abkürzung der auszuführenden Aktion: <CAD> = CaptureDetails

Encrypted parameters for requesting details of an Amazon Pay capture

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide .
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefID	ans..27	M	Unique ID for the transaction issued by Amazon	Von Amazon vergebene eindeutige ID für die Transaktion

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Response parameters for requesting details of an Amazon Pay capture

Amazon Pay request credit details

In order to request the details of a credit with Amazon Pay, please visit the following URL:

AmazonAPA.aspx

The following tables describe the transfer parameters and return values which are exchanged via the socket connection. The server-to-server communication process is described in the manual Programming basics.

Key	Format	CND	Description	Beschreibung
EventToken	an3	M	Abbreviation of the action to be done: <CRD> = CreditDetails	Abkürzung der auszuführenden Aktion: <CRD> = CreditDetails

Encrypted parameters for requesting details of an Amazon Pay credit

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Amazon, if transferred	Fehlercode von Amazon, wenn übergeben
ErrorText	as..1024	O	Error description from Amazon, if it was transferred	Fehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatus	a..20	M	Order status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide .
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefID	ans..27	M	Unique ID for the transaction issued by Amazon	Von Amazon vergebene eindeutige ID für die Transaktion

Key	Format	CND	Description	Beschreibung
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Response parameters for requesting details of an Amazon Pay credit

Batch processing via the interface

Basic information about using Batch files and about their structure you can find inside the separate manual for the Batch manager. Within batch processing not alle functions are available which are usually available for the online interface.

This section describes the parameters which must be transferred within the data set (Record) for executing a payment with Amazon Pay and which information can be found within the response file about the payment status.

For Amazon Pay the transactions AUTHORIZE, CAPTURE, CREDIT, COR, REVERSE and RAN are possible via Batch. Batch versions X.0; X.1; 1.X and 2.X are supported.

Following table gives an overview of all batch versions that are possible for a specific action an their specialities:

Action	Version	Description	Beschreibung
Authorize	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)
Capture	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)
Credit	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)
COR	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)
Reverse	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)
RAN	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2x.	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)

Description of the possible batch versions

The structure for a payment with Amazon Pay within a Batch file to be submitted is the following:

HEAD,<MerchantID>,<Date>,<Version>
AmazonAPA,AUTHORIZE,(<MID>,)<Betrag>,<Währung>,<TransID>,(<RefNr>,)<PayID>,<Capture>(,<ChDesc>,<OrderDesc>)
AmazonAPA,CAPTURE,(<MID>,)<Betrag>,<Währung>,<TransID>,(<RefNr>,)<PayID>,<AuthXID>(,<ChDesc>,<OrderDesc>)
AmazonAPA,CREDIT,(<MID>,)<Betrag>,<Währung>,<TransID>,(<RefNr>,)<PayID>,<CapXID>(,<ChDesc>,<OrderDesc>)
AmazonAPA,COR,(<MID>,)<PayID>
AmazonAPA,REVERSE,(<MID>,)<PayID>(,<Reason>)
AmazonAPA,RAN,(<MID>,)<PayID>,<AuthXID>(,<Reason>)
FOOT,<CountRecords>,<SumAmount>

Example for Master MID function:

HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount

The following table describes the individual fields and values used within the data set (record) within the batch file:

Key

Format

CND

Description

Beschreibung

Type

a..11

M

HEAD for Header, FOOT for Footer, AmazonAPA for Amazon Pay

HEAD für Header, FOOT für Footer, AmazonAPA für Amazon Pay

Action

a..20

M

The parameter Action defines the type of transaction:

AUTHORIZE (authorization)

CAPTURE (Capture)

CREDIT (Credit)

COR (CloseOrderReference – Close order)

REVERSE (cancellation)

RAN (ReverseAuthorize – cancel authorization)

Der Action-Parameter definiert die Art der Transaktion:

AUTHORIZE (Autorisierung)

CAPTURE (Buchung)

CREDIT (Gutschrift)

COR (CloseOrderReference – Order schließen)

REVERSE (Storno)

RAN (ReverseAuthorize – Autorisierung stornieren)

Key	Format	CND	Description	Beschreibung
AuthXID	an32	M	ID assigned by for all single transactions (authorization, capture, credit), which are made for one payment. Transfer here the XID of the authorization that should be captured.	Vom vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden. Übergeben Sie hier die XID zur Autorisierung, die gebucht werden soll.
CapXID	an32	M	ID assigned by for all single transactions (authorization, capture, credit), which are made for one payment. Transfer here the XID of the capture that should be credited.	Vom vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden. Übergeben Sie hier die XID zur Buchung, die gutgeschrieben werden soll.
ChDesc	ans..16	OC	Optional: Text printed on the customer’s credit card bill alongside the payee (only for Capture=AUTO or Capture=<NUMBER>)	Optional: Text, der auf der Abrechnung des Kreditinstituts des Kunden erscheint (nur bei CAPTURE= AUTO oder <ZAHL>)
OrderDesc	ans..127	O	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.
Reason	ans..1024	O	Reason for reversal	Grund zur Stornierung

Description of fields within the record for Batch files

The record area within the response file for Batch transactions looks the following way:

AmazonAPA,AUTHORIZE,(<MID>,)<Betrag>,<Währung>,<TransID>,(<RefNr>,)<PayID>,<Capture>,(<ChDesc>,)(<OrderDesc>,)<Status>,(<Code>,)<AuthXID>,<AmazonStatus>,<OrderID>,<AmazonRefId>,<AmountAuth>,<AmountCap>,<AmountCred>
AmazonAPA,CAPTURE,(<MID>,)<Betrag>,<Währung>,<TransID>,(<RefNr>,)<PayID>,<AuthXID>,(<ChDesc>,)(<OrderDesc>,)<Status>,(<Code>,)<CapXID>,<AmazonStatus>,<OrderID>,<AmazonRefId>,<AmountAuth>,<AmountCap>,<AmountCred>
AmazonAPA,CREDIT,(<MID>,)<Betrag>,<Währung>,<TransID>,(<RefNr>,)<PayID>,<CapXID>,(<ChDesc>,)(<OrderDesc>,)<Status>,(<Code>,)<CredXID>,<AmazonStatus>,<OrderID>,<AmazonRefId>,<AmountAuth>,<AmountCap>,<AmountCred>
AmazonAPA,COR,(<MID>,)<PayID>,<Status>,(<Code>,)<AmazonStatus>,<OrderID>,<AmountAuth>,<AmountCap>,<AmountCred>
AmazonAPA,REVERSE,(<MID>,)<PayID>,(<Reason>,)<Status>,(<Code>,)<OrderId>
AmazonAPA,RAN,(<MID>,)<PayID>,<AuthXID>,(<Reason>,)<Status>,(<Code>,)<AmazonStatus>,<OrderID>,<AmazonRefId>,<AmountAuth>,<AmountCap>,<AmountCred>

The following table describes the response parameters which the Batch Manager saves in the Record area for each transaction (standard parameters not explained here, such as <TransID> or <RefNR> correspond to the call as specified above):

Key	Format	CND	Description	Beschreibung
Action	a..20	M	The parameter Action defines the type of transaction like capture or credit.	Der Action-Parameter definiert die Art der Transaktion wie Capture (Buchung) oder Credit (Gutschrift).

Key	Format	CND	Description	Beschreibung
AuthXID	an32	M	ID assigned by for the authorization	Vom vergebene ID für die Autorisierung
CapXID	an32	M	ID assigned by for the capture	Vom vergebene ID für die Buchung (Capture)
CredXID	an32	M	ID assigned by for the credit	Vom vergebene ID für die Gutschrift (Credit)
AmazonStatus	a..20	M	Order status at Amazon. The available values depend on the Action already carried out and correspond to the values explained above as with the direct implementation of this action via the interface. Details see Amazon API Reference Guide .	Status der Bestellung bei Amazon. Die jeweils möglichen Werte hängen von der gerade durchgeführten Action ab und entsprechen den oben erklärten Werten wie bei der direkten Ausführung dieser Action über die Schnittstelle. Details siehe Amazon API Reference Guide .
OrderID	ans..19	M	Unique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.	Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefID	ans..27	M	Unique ID for the transaction issued by Amazon	Von Amazon vergebene eindeutige ID für die Transaktion
AmountAuth	n..10	M	Total amount which is reserved at Amazon	Gesamtbetrag, der bei Amazon reserviert wurde
AmountCap	n..10	M	Total amount which is already successfully captured at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCred	n..10	M	Total amount which is already successfully credited at Amazon	Gesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Description of result parameters within the record for Batch files

About Amazon Pay

General information about Amazon Pay

On this page

Configuration for Amazon Pay

Steps within the process

Integrate Button-Widget

Integrate address book and wallet widget

Javascript for confirmation flow

Available Event-Token

Process flow chart

Process flow for Multi-factor authentication

interface

Initialize Amazon Pay interface

Amazon Pay set order details

Amazon Pay request order details

Amazon Pay confirm order details

Amazon Pay finalize authorization

Amazon Pay capture a payment

Amazon Pay credit a payment

Amazon Pay close an order

Amazon Pay reverse an order

Amazon Pay reverse an authorization

Amazon Pay request authorization details

Amazon Pay request capture details

Amazon Pay request credit details

Batch processing via the interface