About Amazon Pay

General information about Amazon Pay

Amazon Pay provides buyers with a secure, trusted, and convenient way to sign in and pay for their purchases on your site by using their Amazon credentials. See browser support for information about the operating systems, browsers and browser versions that Amazon Pay supports.

This guide provides an overview of the buyer experience and shows you how to integrate with the latest checkout technology from Amazon Pay.

The Amazon Pay checkout experience

  1. The buyer clicks on the Amazon Pay button to start checkout.
  2. The buyer signs in, confirms their preferred payment instrument, and optionally selects a shipping address on the Amazon Pay-hosted page.
  3. The buyer is redirected back to your order review page for confirmation.
  4. The buyer completes checkout on the Amazon Pay-hosted page by responding to the multi-factor authentication (identity validation) challenge, if prompted, or by selecting another payment method if payment was declined.
  5. Amazon Pay redirects the buyer back to your confirmation page.


Further information you will find also on the:


Configuration for Amazon Pay

There are two options that can be used depending if you are a new or an existing customer.

Existing Customers

Already existing customers need to login to their accounts and create a new set of API keys to be used with Amazon Pay Checkout version.2.

We already have the needed data for your accounts done for the original checkout v.1.

Please see below the "Guide to create API keys".

On this page

New Customer

Before using Amazon Pay you need to register at https://pay.amazon.de/signup  

An alternative is also the signup for Amazon based on country, the steps are the;

  • follow the above URL
  • choose the country needed, based on the country flag found at the top-right:


When logged in in the Amazon seller central, you should have 2 accounts, that you can toggle between:

  • Sandbox
  • Production

The needed data for the onboarding are the following:

Amazon Cv.2Comment
Country Code*Code of the Amazon market used (DE=EU, UK, JP and US)
MerchantIDtaken from Amazon seller central
MWS Authorization TokenExample: amzn.mws.a4a8d852-3d9e-f441-0674-d042baa3cf6452
merchant Store NameName of the store
StoreIDExample: amzn1.application-oa2-client.7150fff45acf49f8acd519fa485142a2
  • If you have more than one market this information needs to be given to us for each market needed.


Please follow the guide below to create the API keys necessary.

Important: If you don´t see the option to create the API keys, you need to create a store first and then create the API keys.

Under the "Integration central" at the bottom you can do this using the link found there:


MWS Authorization Token

One of the important piece of data needed is the MWS Authorization token from Amazon which gives Computop permission to conduct transactions for your shop.

The second step is generating a MWS Auth Token. This is the data needed:

German :

  • Developer name: CT_Sandbox_EU
  • Developer account number: 0143-6461-8727

United Kingdom:

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

Guide

When logged in to the seller central of Amazon, go to the top right-hand side of the page and click on Settings and choose "User Permissions":

This leads you to the "User permissions" page which show you the current users, here you can add an external developer to your account, here please click on "Visit manage your apps":

This leads you to a new page were you can see developers that have access, here you can add, delete and renew permissions. Please click on "Authorise new developer":

On the new page you need to add the developer name and ID given above. Fill in the information and click on "Next":

The last page is were you need to agree to the terms and conditions of granting a developer access to the account.

When clicking on "Next", you are shown a success page with information:

With the last click on "Next", you are led back to the original "User Permission" were the developer is now shown:


Here you can now click on "View" and access the "MWS Authorization token" and can also copy it.

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


Guide to create API keys

In order to create new API keys, choose one of your accounts, either Production or Sandbox on top of the page, process needs to be done for both accounts. Amazon description is found here.


Please click left-hand side on the symbol with the 3 horizontal lines. 

On the menu that appears, please go to "Integration" and choose "Integration central". 

On the Integration central, go to the section "Create API Keys" and click on the button there. 

A Pop-up window appears where you need to choose "Generate API Credentials", here you also need to give the keys a unique name: 

The newly created keys are immediately visible on the "Integration central". There you choose the option to "See Details": 

When looking at the details, you can see the data or download the data in JSON format: 

JSON example:

Important

  • This data is needed for your onboarding and needs to be sent in a secure way to Computop Helpdesk for configuration.
  • The same process needs to be repeated for the second account depending on which one you did first

Notify URL

Customers will need to also to store/configure the following Paygate notify URL.

URL:  https://www.computop-paygate.com/amazonpaycomplete.aspx

Go to the menu on the te top left-hand side:


On the menu that appears, please go to "Integration" and choose "MWD Access Key":


At the bottom of the page you can see the option for IPN (Instant Payment notification":

After clicking on the blue link another pages open with integration settings: 


Here please click on the "Edit"-button: 

  1. Here please add the fowllowing URL to the integrator URL and click on the "Update"-button

https://www.computop-paygate.com/amazonAPAV2Notify.aspx

      2. The merchant can also save his own notify URL if he so wishes. Computop will ask for the NotifyURL on the request as well.

Important: Please make sure to use the Notifies sent via server to server and not only rely on the SuccessURLs/FailureURLs.



Steps within the process

The basic payment process with Amazon consists of several steps:


Step

Description

1

Display Amazon Pay button

The Amazon Pay button must be properly implemented on the page of the webshop and must be called for each payment process. You can find below the example code snippet.

2

Initialize payment via amazonAPA.aspx (Server to Server)

You will call Paygate endpoint https://www.computop-paygate.com/amazonapa.aspx according to description below.

Paygate will respond with parameters that you must use to update the Amazon Pay button.

3

Redirect to Amazon

After updating the Amazon Pay button, customer will be redirected to Amazon.

4

Redirect back to your webshop

After confirming customer's preferred payment instrument, and optionally shipping address on the Amazon Pay-hosted page, customer is redirected back to your webshop order review page.

5

Finalize the purchase

After customer confirms the order, you will redirect the client to Amazon URL received in response from Paygate.

6Redirect back to your webshopAfter customer finalizes the payment at Amazon side, customer will be redirected back to your defined URL based on result of payment (URLSuccess / URLFailure).
7

Notify from Computop is sent via S2S

Please make sure to setup and use the notifyURL to get final confirmation on the requests success/failure
Important

Please make sure that you plan in the 2 main tasks for merchants:

  1. Add the new Amazon Cv.2 Button (Step 1)
  2. On the redirect back to the shop (Step 3) were changes may take place, merchant needs to make sure that address (if applicable) and payment method, can be changed. Also the possibility of changes to the amount should be pass with a call to the Paygate


Integrate Amazon Pay button

The following example code shows how to integrate the Amazon Pay button in your webshop.

When customer submits this button, you will call Paygate to obtain additional data, which are required for updating the Amazon Pay button.

var amazonPayButton = amazon.Pay.renderButton('#AmazonPayButton', {

   merchantId: 'xxxxx',
   publicKeyId: 'SANDBOX-xxxxxxxxxx', 
   ledgerCurrency: 'EUR',          
   checkoutLanguage: 'en_GB', 
   productType: 'PayAndShip', 
   placement: 'Cart',
   buttonColor: 'Gold'
});

amazonPayButton.onClick(function(){
  const [payload, signature, publicKeyId] = your_call_to_paygate();
  
  amazonPayButton.initCheckout({
    createCheckoutSessionConfig: { 
      payloadJSON: payload,
      signature: signature,
      publicKeyId: publicKeyId
    }
  });
});


In this case the following parameters must be present within the Button:

Parameter

Description

Value

merchantId

SellerId issued by Amazon


ledgerCurrency

Your ledger currency. For  EU/UK accounts a different presentment currency can be used on the auth/capture


Permissible values:

  • US merchants - 'USD'
  • EU merchants - 'EUR'
  • UK merchants - 'GBP'
  • JP merchants - 'JPY'
placementPlacement of the button

Permissible values:

Cart

buttonColor

The parameter buttonColor defines the color of the button


Permissible values:

Gold, LightGray, DarkGray

productType

The parameter productType defines if the transaction is done for physical or digital goods. PayAndShip is default.


Permissible values:

  • PayAndShip - Physical goods
  • PayOnly - Digital goods

checkoutLanguage

The parameter checkoutLanguage 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:

  • US merchants - 'en_US'
  • EU/UK merchants - 'en_GB', de_DE', 'fr_FR', 'it_IT', 'es_ES'
  • JP merchants - 'ja_JP'


estimatedOrderAmount

This is the estimated checkout order amount, it does not have to match the final order amount if the buyer updates their order after starting checkout. Amazon Pay will use this value to assess transaction risk and prevent buyers from selecting payment methods that can't be used to process the order 

Use updateButtonInfo() to update the estimatedOrderAmount if the estimated order amount changes; for example, if the buyer removes or adds something to their cart. This function may update the button UI and the new estimatedOrderAmount will be used to determine whether the order meets the installment provider’s minimum order price threshold.

Example of the function

<script type="text/javascript" charset="utf-8">
         amazonPayButton.updateButtonInfo({"amount":"120.99","currencyCode":"USD"});
</script>

Example:

{ "amount": "50.99", "currencyCode":"USD"},

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


Review Page

When using the complete checkout of Amazon Pay v2, the review page is to be used on the side of the merchant to allow:

  • change of address
  • change of payment method

A change of either one or both is possible.

Review Page Example


Computop Data

This is the Computop data that is delivered to the merchant for the review page

  • mid
  • PayID
  • XID
  • TransID
  • Status=REQUEST
  • Code=0
  • AmountAuth=0
  • AmountCap=0
  • AmountCred=0
  • bdaddrstreet2
  • bdaddrcity
  • bdaddrcountrycode
  • bdaddrname
  • bdphonenumber
  • bdaddrzip
  • AddrStreet
  • AddrCity
  • AddrCountryCode
  • addrname
  • phonenumber
  • AddrZip
  • addrstate
  • amazonmerchantid
  • rtf=onetime
  • amazonstatus=Open
  • amazonpayredirecturl
  • amazoncheckoutsessionid
  • amazonpaymentdescriptor

JS example

This is an JS Example that merchants can use to accommodate changes if necessary

let session = document.getElementById('sessionId').value;
let link = document.getElementById('redirectUrl').value;
let buyNow = document.getElementById('buy-now');
buyNow.addEventListener('click', () => {
  window.location = link;
})
amazon.Pay.bindChangeAction('#change-paymethod', {
  amazonCheckoutSessionId: session,
  changeAction: 'changePayment'
});
amazon.Pay.bindChangeAction('#change-shipping', {
  amazonCheckoutSessionId: session,
  changeAction: 'changeAddress'
});


The Amazon description can be found here:

https://developer.amazon.com/de/docs/amazon-pay-checkout/display-shipping-payment-info.html#2-enable-shipping-and-payment-updates

Update Amount:

If the amount changes during the Review Process, then following amount update request need to be sent to Paygate.

Request URL:


Request Parameter:

Amount=999&
Currency=EUR&
CountryCode=EU&
eventToken=UpdateAuthorizeAmount&
PayId=be30427125a94801a4c3757f4ea2111


Response Parameter:

mid=ct_teamtest
PayID=be30427125a94801a4c3757f4ea21111
TransID=n/a
Status=AUTHORIZE_REQUEST
Code=0
XID=d1708fcca09945e6b3e195156848b2f8
AmountAuth=0
AmountCap=0
AmountCred=0


Process flow chart

  • Version with possibly changes done to delivery address, payment instrument or amount.
  • Valid for OTP (One time payments) or for Recurring setup (RTF=I)



Recurring Subsequent

Subsequent actions

Capture a payment

Credit a payment

Reverse an order


Paygate interface

Definitions

Data formats

Format

Description

a

alphabetical

as

alphabetical with special characters

n

numeric

an

alphanumeric

ans

alphanumeric with special characters

ns

numeric with special characters

bool

boolean expression (true or false)

3

fixed length with 3 digits/characters

..3

variable length with maximum 3 digits/characters

enum

enumeration of allowed values

dttm

ISODateTime (YYYY-MM-DDThh:mm:ss)


Abbreviations

Abbreviation

Description

Comment

CND

condition


M

mandatory

If a parameter is mandatory, then it must be present

O

optional

If a parameter is optional, then it can be present, but it is not required

C

conditional

If a parameter is conditional, then there is a conditional rule which specifies whether it is mandatory or optional


Notice: Please note that the names of parameters can be returned in upper or lower case.

Initialize Amazon Pay interface

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


Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter.

The following table describes the encrypted payment request parameters:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung
CountryCodean2MCountry code of used marketplace. Options EU, US and JP.Ländercode des verwendeten Marktplatzes. Optionen EU, US und JP.

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
URLSuccessans..256MThe buyer is redirected to this URL if action was successfulDer Käufer wird zu dieser URL weitergeleitet, wenn die Aktion erfolgreich war
URLFailureans..256MThe buyer is redirected to this URL if action was unsuccessfulDer Käufer wird zu dieser URL weitergeleitet, wenn die Aktion nicht erfolgreich war

KeyFormatCNDDescriptionBeschreibung
URLNotify

ans..256

M

Complete URL which Paygate 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: Use the UserData parameter instead.

(info) Common notes:

  • We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate
  • However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess/URLNotify. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.

Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData.

(info) Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von Paygate zu erhalten
  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Key

Format

CND

Description

Beschreibung
URLCancelans..256MThe buyer is redirected to this URL if the operation is cancelledDer Käufer wird zu dieser URL weitergeleitet, wenn der Vorgang abgebrochen wird

ShopUrl

ans..256

M

Order review page where customer is redirected after confirming customer's preferred payment instrument and optionally shipping address on the Amazon Pay-hosted pageBestellüberprüfungsseite, auf die der Kunde weitergeleitet wird, nachdem er das bevorzugte Zahlungsmittel und optional die Lieferadresse auf der von Amazon Pay gehosteten Seite bestätigt hat
TxTypean..20C

Payment flow for charging the buyer. Supported values:

  • 'AuthorizeWithCapture' – Authorize and capture funds immediately, is default
  • 'Authorize' – Authorize funds immediately and capture at a later time

Zahlungsablauf für die Belastung des Käufers. Unterstützte Werte:

  • 'AuthorizeWithCapture' – Sofortiges Autorisieren und Einziehen von Geldern ist die Standardeinstellung
  • 'Authorize' – Gelder sofort autorisieren und zu einem späteren Zeitpunkt buchen
LocalCurrencya3CThe currency that the buyer will be charged in ISO 4217 format. Only possible for Amazon EU and UK markets.Die Währung, die dem Käufer in Rechnung gestellt wird, im ISO-4217-Format. Nur möglich für Amazon EU- und UK-Märkte.
Scopea..128O

The buyer details that you're requesting access to. Possible values:

  • "name"
  • "email"
  • "phoneNumber"
  • "billingAddress"

If not included, all buyer information is requested.

Die Käuferdetails, auf die Sie Zugriff anfordern. Mögliche Werte:

  • "name"
  • "email"
  • "phoneNumber"
  • "billingAddress"

Wenn nicht enthalten, werden alle Käuferinformationen angefordert.

ChDescans..16COnly for sale type transactions: AuthorizeWithCapture.
Default: "AMZ*<SELLER_NAME> pay.amazon.com"
Nur für Sale-Transaktionen: AuthorizeWithCapture.
Standardwert: "AMZ*<SELLER_NAME> pay.amazon.com"

OrderDesc

ans..127

O

Use this parameter for the simulation mode. During live mode this parameter has no effects.Verwenden Sie diesen Parameter für den Simulationsmodus. Im Live-Modus hat dieser Parameter keine Auswirkungen.



RecurringRecurring (wiederholte Zahlungen)
RTFans1OFor repeated payments (subscriptions): I = Initial payment of series of payments. Default is OTP, one time payment.Bei wiederholten Zahlungen (Abonnements): I = Erstzahlung einer Reihe von Zahlungen. Standard ist OTP, einmalige Zahlung.
cyclean..7CCycle. Supported values: 'Year', 'Month', 'Week', 'Day', 'Variable'Zyklus. Unterstützte Werte: 'Jahr', 'Monat', 'Woche', 'Tag', 'Variabel'
Valuen..4C

Number of frequency units per billing cycle. For example, to specify a weekly cycle set unit to Week and value to 1. You must set value to 0 if you're using variable unit.

  • year: 1-3
  • Month: 1-36
  • Week: 1-57
  • Day: 1-1095

Anzahl der Frequenzeinheiten pro Abrechnungszeitraum. Um beispielsweise einen wöchentlichen Zyklus anzugeben, setzen Sie die Einheit auf Woche und den Wert auf 1. Sie müssen den Wert auf 0 setzen, wenn Sie eine variable Einheit verwenden..

  • Jahr: 1-3
  • Monat: 1-36
  • Woche: 1-57
  • Tag: 1-1095
InstallmentAmountn..10CTransaction amount – choose zero if is not a fixed amountTransaktionsbetrag – wählen Sie Null, wenn es sich nicht um einen festen Betrag handelt
currencya3CTransaction currency code in ISO 4217 format. Example: EURWährungscode der Transaktion im Format ISO 4217. Beispiel: EUR

Encrypted parameters for initializing an Amazon Pay payment


Intermediate response with button additional parameters

The following table describes the result parameters with which the Computop Paygate responds to your system

(info) pls. be prepared to receive additional parameters at any time and do not check the order of parameters

(info) the key (e.g. MerchantId, RefNr) should not be checked case-sentive

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

Key

Format

CND

Description

Beschreibung

buttonsignature

ans..256MSignature for the Amazon buttonSignatur für die Amazon-Schaltfläche

buttonpayload

ans..256MPayload for the Amazon buttonPayload für die Amazon-Schaltfläche

buttonpublickeyid

ans..256MPublic Key ID for the Amazon buttonPublic-Key-ID für die Amazon-Schaltfläche

Response parameters after initializing an Amazon Pay payment


The following example code shows the updated and complete Amazon Pay button, which will redirect the client to Amazon.

<div id="AmazonPayButton"></div>
<script src="https://static-na.payments-amazon.com/checkout.js"></script>
<script type="text/javascript" charset="utf-8">
var amazonPayButton = amazon.Pay.renderButton('#AmazonPayButton', {
merchantId: 'xxxxx',
ledgerCurrency: 'EUR',          
checkoutLanguage: 'en_GB', 
productType: 'PayAndShip', 
placement: 'Cart',
buttonColor: 'Gold'
});

amazonPayButton.onClick(function(){
// Here you need to call your shop server, which creates the initial Call towards Paygate
// and then returns the required data payloadJSON, signature, publicKeyId from the response
var buttonData = getSignedButtonData()

amazonPayButton.initCheckout({
    createCheckoutSessionConfig: { 
    payloadJSON: buttonData.payloadJSON,
    signature: buttonData.signature,
    publicKeyId: buttonData.publicKeyId
    }
});
</script>

Intermediate response with customer information to your ShopUrl

The following table describes the result parameters with which the Computop Paygate responds to your system

(info) pls. be prepared to receive additional parameters at any time and do not check the order of parameters

(info) the key (e.g. MerchantId, RefNr) should not be checked case-sentive

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key

Format

CND

Description

Beschreibung
RTFans1O

Onetime or recurring. For repeated payments (subscriptions): I = Initial payment of series of payments.

Einmalig oder wiederkehrend. Bei wiederholten Zahlungen (Abonnements): I = Erstzahlung einer Reihe von Zahlungen.

Response parameters after initializing an Amazon Pay payment


Amazon Pay capture a payment

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


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.

Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter.

The following table describes the encrypted payment request parameters:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung
ChDescans..16OText printed on the customer’s credit card bill alongside the payeeText der auf der Abrechnung des Kreditinstituts des Kunden erscheint
OrderDescans..127MUse 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.

KeyFormatCNDDescriptionBeschreibung
ReqId

ans..32

O

To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action.

Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly.

Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Encrypted parameters for capturing an authorized Amazon Pay payment


The following table describes the result parameters with which the Computop Paygate responds to your system

(info) pls. be prepared to receive additional parameters at any time and do not check the order of parameters

(info) the key (e.g. MerchantId, RefNr) should not be checked case-sentive

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key

Format

CND

Description

Beschreibung
CodeExtans..10OError code from Amazon, if transferredFehlercode von Amazon, wenn übergeben
ErrorTextas..1024OError description from Amazon, if transferredFehlerbeschreibung von Amazon, wenn diese übergeben wurde

chargeid

ans..256MAmazon Pay Charge IDAmazon Pay Charge ID
AmazonStatusa..20MOrder status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.Bestellstatus bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.

chargepermissionid

ans..256MAmazon Pay Permission IDAmazon Pay Permission ID

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, 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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key

Format

CND

Description

Beschreibung
CodeExtans..10OError code from Amazon, if transferredFehlercode von Amazon, wenn übergeben
ErrorTextas..1024OError description from Amazon, if transferredFehlerbeschreibung von Amazon, wenn diese übergeben wurde

chargeid

ans..256MAmazon Pay Charge IDAmazon Pay Charge ID
AmazonStatusa..20MOrder status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.Bestellstatus bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.

chargepermissionid

ans..256MAmazon Pay Permission IDAmazon Pay Permission ID
OrderIDans..19MUnique ID for the order issued by Amazon. Corresponds to the OrderReferenceID.Von Amazon vergebene eindeutige ID für die Bestellung. Entspricht der OrderReferenceID.
AmazonRefIDans..27MUnique ID for the transaction issued by AmazonVon Amazon vergebene eindeutige ID für die Transaktion

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde
NotificationTypea..25MDescribes 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 use the following URL:


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.

Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter.

The following table describes the encrypted payment request parameters:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung
OrderDescans..127MDescription of purchased goods, unit prices etc. for creditBeschreibung der gekauften Waren, Einzelpreise etc. für die Gutschrift

chargeid

ans..256MAmazon Pay Charge IDAmazon Pay Charge ID

KeyFormatCNDDescriptionBeschreibung
ReqId

ans..32

O

To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action.

Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly.

Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Encrypted parameters for crediting an Amazon Pay payment


The following table describes the result parameters with which the Computop Paygate responds to your system

(info) pls. be prepared to receive additional parameters at any time and do not check the order of parameters

(info) the key (e.g. MerchantId, RefNr) should not be checked case-sentive

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key

Format

CND

Description

Beschreibung
CodeExtans..10OError code from Amazon, if transferredFehlercode von Amazon, wenn übergeben
ErrorTextas..1024OError description from Amazon, if transferredFehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatusa..20MOrder status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.Bestellstatus bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.
chargeidans..256MAmazon Pay Charge IDAmazon Pay Charge ID
refundidans..256MAmazon Pay Refund IDAmazon Pay Refund ID

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, 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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key

Format

CND

Description

Beschreibung
CodeExtans..10OError code from Amazon, if transferredFehlercode von Amazon, wenn übergeben
ErrorTextas..1024OError description from Amazon, if transferredFehlerbeschreibung von Amazon, wenn diese übergeben wurde
AmazonStatusa..20MOrder status at Amazon. Following values are possible: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details see Amazon API Reference Guide.Bestellstatus bei Amazon. Folgende Werte sind möglich: „Draft“, „Open“, „Suspended“, „Abandoned“, „Canceled“, „Closed“. Details siehe Amazon API Reference Guide.
chargeidans..256MAmazon Pay Charge IDAmazon Pay Charge ID
refundidans..256MAmazon Pay Refund IDAmazon Pay Refund ID

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde
NotificationTypea..25MDescribes 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 reverse an order

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


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.

Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter.

The following table describes the encrypted payment request parameters:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

Format

CND

Description

Beschreibung
Reasona..1024OReason for reversalGrund der Stornierung
chargeidans..256MAmazon Pay Charge IDAmazon Pay Charge ID

KeyFormatCNDDescriptionBeschreibung
ReqId

ans..32

O

To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action.

Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly.

Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

Encrypted parameters for reversal of an Amazon Pay payment


The following table describes the result parameters with which the Computop Paygate responds to your system

(info) pls. be prepared to receive additional parameters at any time and do not check the order of parameters

(info) the key (e.g. MerchantId, RefNr) should not be checked case-sentive

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyFormatCNDDescriptionBeschreibung
Status

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

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
AmazonStatusa..20MOrder 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.
chargeidans..256MAmazon Pay Charge IDAmazon Pay Charge ID
chargepermissionidans..256MAmazon Pay Permission IDAmazon Pay Permission ID

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung
AmountAuthn..10MTotal amount which is reserved at AmazonGesamtbetrag, der bei Amazon reserviert wurde
AmountCapn..10MTotal amount which is already successfully captured at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gebucht wurde
AmountCredn..10MTotal amount which is already successfully credited at AmazonGesamtbetrag, der bisher bei Amazon erfolgreich gutgeschrieben wurde

Response parameters after reversing an Amazon Pay payment


  • No labels