Pay By Link API | Computop Documents

Computop Paygate ermöglicht das Auslösen von Pay-By-Link-Zahlungen, um Remote-E-Commerce-Zahlungen für Sie und Ihre Kunden zu vereinfachen.

Diese Pay-By-Link-Zahlungen werden normalerweise von Ihnen mittels Computop Analytics ausgelöst.

Es ist die Absicht, dass Sie Zahlungslinks mit einem bestimmten Betrag und einer bestimmten Währung und zusätzlichen Informationen (Warenkorb, Adressdaten) senden können, die dann per E-Mail an Ihre Kunden gesendet werden, um die Zahlung abzuschließen.

Jetzt ist Pay By Link auch über die Paygate-API verfügbar.

So funktioniert es

Sie nutzen https://www.computop-paygate.com/PayByLink.aspx?action=create&MerchantID=<yourMerchantId>&Len=...&Data=..., um eine neue PayByLink-ID (PbLId) zu erzeugen.
Sie senden Ihrem Kunden eine PayByLink-Zahlung mittels https://www.computop-paygate.com/PayByLink.aspx?id=<PbLId> und fordern den Kunden auf, die Zahlung abzuschließen.
Der Kunde löst die Zahlung aus, indem er auf den von Ihnen gesendeten Link klickt: https://www.computop-paygate.com/PayByLink.aspx?id=<PbLId>
Sie erhalten eine Bestätigung an die angegebene URLNotify aus dem generierten Link.
Sie erhalten eine E-Mail, sobald der Kunde die Zahlung erfolgreich abgeschlossen hat. Die E-Mail-Adresse muss vom Computop Helpdesk eingerichtet werden.

API-Aufruf, um Pay By Link zu erzeugen

Um PayByLink über eine Server-zu-Server-Verbindung zu erzeugen, verwenden Sie bitte folgende URL:

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

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Key	Format	CND	Description
MerchantID	ans..30	M	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
action	M	create	z.B. PayByLink.aspx?action=create&Len=xxx&Data=xxx erzeugt einen neuen Datensatz in der Datenbanktabelle und gibt PbLID zurück
Len	M	Blowfish/AES-LEN	Länge der Daten vor der Verschlüsselung
Data	M	Encryped Blowfish/AES data	enthalten HPP-Anfrageparameter (bereits verschlüsselt mit Len=...&Data=...)und zusätzliche Klartextparameter, z.B. ExpirationDate, CustomField1..16, Kanal, PayTypes, .... Parameter für die Anfrage der Hosted Payment Page sind hier zu finden: Hosted Payment Page Der Parameter "RefNr" ist Pflicht Der Parameter "ExpirationDate" (Format JJJJ-MM-TT HH:mm:ss) ist ebenfalls PflichtWenn Sie eine PbLId ohne Ablauf erzeugen wollen, verwenden Sie z.B. "2099-12-31 23:59:59"

Key

Format

CND

Description

MerchantID

ans..30

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

action

create

z.B. PayByLink.aspx?action=create&Len=xxx&Data=xxx
erzeugt einen neuen Datensatz in der Datenbanktabelle und gibt PbLID zurück

Len

Blowfish/AES-LEN

Länge der Daten vor der Verschlüsselung

Data

Encryped Blowfish/AES data

enthalten HPP-Anfrageparameter (bereits verschlüsselt mit Len=...&Data=...)und zusätzliche Klartextparameter, z.B. ExpirationDate, CustomField1..16, Kanal, PayTypes, ....

Parameter für die Anfrage der Hosted Payment Page sind hier zu finden: Hosted Payment Page
Der Parameter "RefNr" ist Pflicht
Der Parameter "ExpirationDate" (Format JJJJ-MM-TT HH:mm:ss) ist ebenfalls PflichtWenn Sie eine PbLId ohne Ablauf erzeugen wollen, verwenden Sie z.B. "2099-12-31 23:59:59"

Aufrufparameter um Pay By Link zu erzeugen

Wenn die PayByLink-API-Anfrage erfolgreich war, erhalten Sie eine URL, die so verwendet und an den Kunden gesendet werden kann.

Beispiel

1. Link zur Hosted Payment Page erzeugen

a) Aufrufparameter für die Hosted Payment Page erzeugen

Die Parameter für die Anfrage an die Hosted Payment Page finden Sie hier: Hosted Payment Page
ExpirationDate ist obligatorisch, z.B. "ExpirationDate=2099-12-31 23:59:59"
```
1
MerchantID=yourMerchantId&TransID=TID-1679503992356-021830709399&MsgVer=2.0&RefNr=MyRef&Amount=123&Currency=EUR&URLSuccess=https://www.yourshop.com/success.url&URLFailure=https://www.yourshop.com/failure.url&URLNotify=https://www.yourshop.com/notify.url&Language=en&ExpirationDate=2099-12-31 23:59:59&MAC=abbe18e21242e816452fbcbfb62ff16a11c22960b660f91007e474f77a28e741
```

Verschlüsseln Sie diese Daten mit Ihrem Blowfish/AES-Passwort

1
MerchantID=yourMerchantId&Len=410&Data=fb0f6ee9876fea46f0c9da4224b3559fc316aa2a25334716c5ae40987a9c1c39d4ce95305a65583dd48fc7bf3f5f16e62148191fb636e79574d9e298cc36ef15e56834da45705f220e51ff19cadf957d7841584277d3291d6349593368d3f0e0a242ad1129c70e1754de3944f2a26a6013aeb986ec89985a5acf52f00875ecc10c8caa2678b40fdd10253ab9e017891755f2d8872a0430f0bc8903a57e18bbd65b85d9d1becafcf1dc569b465182c1630c8caa2678b40fdd10253ab9e0178917c0906e6b0f44a2eb01bf04f5dec731cd6a22e817cbdd8632882e76d1f99be8fddbd9cc830472ecebe4b4d9b086efb879e0b51ccd7c1ccf48fcf94f0d7dedbf334592297796d416131b157ba1e2212bda322c3635d28da9e5f2da6cd629b3102552fbee92890381ae497f67886b95dac890791166a31269b53b893fdcb25cacf3789bc7b98c8b96ad1a8867058e1846b5fe32e3a17bb6535cea1b9533c4840e43af6e00bb0b709eda16f5948af965f5b411c5eb51226e08c611d4e2e27ae5f4931ba58e1d5b6ae6cb38488f2ceafc390160d723d28acabfafd587725e06dc18fd

b) Verschlüsselte Daten (Len+Data) bei Bedarf um zusätzliche Klartextparameter ergänzen

Fügen Sie bei Bedarf zusätzliche Parameter wie Vorlagennamen, UrlBack, Language hinzu

1
MerchantID=yourMerchantId&Len=410&Data=fb0f6ee9876fea46f0c9da4224b3559fc316aa2a25334716c5ae40987a9c1c39d4ce95305a65583dd48fc7bf3f5f16e62148191fb636e79574d9e298cc36ef15e56834da45705f220e51ff19cadf957d7841584277d3291d6349593368d3f0e0a242ad1129c70e1754de3944f2a26a6013aeb986ec89985a5acf52f00875ecc10c8caa2678b40fdd10253ab9e017891755f2d8872a0430f0bc8903a57e18bbd65b85d9d1becafcf1dc569b465182c1630c8caa2678b40fdd10253ab9e0178917c0906e6b0f44a2eb01bf04f5dec731cd6a22e817cbdd8632882e76d1f99be8fddbd9cc830472ecebe4b4d9b086efb879e0b51ccd7c1ccf48fcf94f0d7dedbf334592297796d416131b157ba1e2212bda322c3635d28da9e5f2da6cd629b3102552fbee92890381ae497f67886b95dac890791166a31269b53b893fdcb25cacf3789bc7b98c8b96ad1a8867058e1846b5fe32e3a17bb6535cea1b9533c4840e43af6e00bb0b709eda16f5948af965f5b411c5eb51226e08c611d4e2e27ae5f4931ba58e1d5b6ae6cb38488f2ceafc390160d723d28acabfafd587725e06dc18fd&Language=en&Template=HPP_Template&CCTemplate=SSL_Template&SDDTemplate=SDD_Template&URLBack=https://www.yourshop.com/back.url

Verschlüsseln Sie diese Daten ein zweites Mal mit Ihrem Blowfish/AES-Passwort
Diese zweite Verschlüsselung ist stets erforderlich - auch dann, wenn keine zusätzlichen Klartextparameter angegeben werden

1
MerchantID=yourMerchantId&Len=1064&Data=fb0f6ee9876fea46f0c9da4224b3559fc316aa2a25334716efaf244b907c1cab68f1b5f4d87235db85f929704bef40c18f4c2c2c9c30b3e8dbf3a26817fc731350b83d612cdd9a6bf86ee1725a5620dd454382f7489551ab257f3757065293dd98660c22d472dcd71ef3bbf7514e3ecdf9529b385bf54ab7b975c1df5e88e831ddec73e7b7384590b3c31cd6c3c9c7553ecada7cb132c7bf5c41ebd7e443ea9c16f2b2c87570e8fdea572cb7d8fa1702e8edbdaf0fbd2ce9c9f0fa409a980eb3f552863668ce275861db0f101c50c22bd07e89dcf42503c2d65fbd28b5ca5895ec0510334bff65ecf919552feda8a8ba8f062e56159dc02cfaf5588558408c30fe0141fd0dbf1feb7be3b20bd4a500fc706137c1fe12688580dd00e3017d9854202e6ce58fa6eeb4c57f65509173a98a1eeea31ea53c0aa0f57c9ac685b8a5eef42f3327806a9a3a020bedb0590d7754a54b82b4846c10c53ce3365fbbcc15ef7f9d6e7b8df646d7ab78d250992f954353e6cf9d14b5e4f3f359aaf1d08461696f9a07f725603be4c57f65509173a98a1eeea31ea53c0aa0f57c9ac685b8a5ee2ea5c301ea1bf06ddc25cbd507750f81b4f4a7a923ff1d18c64fd7b13cea86e89bb1862539ea9168e3aa14567546de92ed609e7dacf4b492113bbc287ad49b31521a088fdb3eef1931f52ad35b0d2accefc9c19ff0248f1992e2f74fe690f750f4fb415a8522736afd7a0b01f2e97f3ffe6da7dc471270df58c4714bf2fcb8068bc4c17cedcdb7e40fcec89f2bf701326ed798835a76b6431b01c0ba3b221b1ec57795da9568416b1bab685d2388768b357ef73c766068ea39e642a41efe4490a453b2167394d6a03609ff04236e65fbe289d98c9635ce4efb18c9ded50cc5d709a0722131d55bdcdfb17aeeec94633da5ab952b88be619ec78375370ae70bb4893dbaf5dc2b24fef95582bb594a6c215c1a5c0f388f10e40dc05e17963026d36c5382b050e5ed54b3eae15a0cc7c64860881486db892a7fa0c436fcbec7d9a3209a6a9d31e349039e76447d43d8ce874de8cdd1bf5517881bd887bdf0c9cb8d5aaca15659d6efd59da05416e49e31f20fccbee695a33f5c11061d8111e2bd7b858e81ae75bbf16436a63a9d265a73abc1586ca71393a16b743a576c460369f5e193a42052cf75fbb668ebe78b20f7934b4913d570f9276c30f182edc6b07ab02b93d58823ad27ec497f67886b95dac83f167a0a1c5f7084a960692b17567f82e15676c9a6310d12f42e5d567f33e107022f389cbdf790ede15676c9a6310d120d032e5d8e4301c2187c58c4de7a4ca117526ea868bc010c1029848bbf8a5fbbfdbb58bf5dd6dd660c8caa2678b40fdd10253ab9e0178917241b890944d9adae2433e7ea6c92707f810d75f6ffce9addbbf6840a064c5c52ab23481b612706e1db5e42a5db0c9617ee31b189c3b8945b9aaa25a7949acdd30bec84ccd912df0d53be785897ddae60

2. Link zur Hosted Payment Page verwenden, um über PayByLink.aspx eine PbLId zu erzeugen

Nehmen Sie die verschlüsselten Daten von 1b) und senden diese mit "action=create" an PayByLink.aspx, z.B.
https://www.computop-paygate.com/PayByLink.aspx?action=create&MerchantID=yourMerchantId&Len=1064&Data=fb0f6ee9876fea46f0c9da4224b3559fc316aa2a25334716efaf244b907c1cab68f1b5f4d87235db85f929704bef40c18f4c2c2c9c30b3e8dbf3a26817fc731350b83d612cdd9a6bf86ee1725a5620dd454382f7489551ab257f3757065293dd98660c22d472dcd71ef3bbf7514e3ecdf9529b385bf54ab7b975c1df5e88e831ddec73e7b7384590b3c31cd6c3c9c7553ecada7cb132c7bf5c41ebd7e443ea9c16f2b2c87570e8fdea572cb7d8fa1702e8edbdaf0fbd2ce9c9f0fa409a980eb3f552863668ce275861db0f101c50c22bd07e89dcf42503c2d65fbd28b5ca5895ec0510334bff65ecf919552feda8a8ba8f062e56159dc02cfaf5588558408c30fe0141fd0dbf1feb7be3b20bd4a500fc706137c1fe12688580dd00e3017d9854202e6ce58fa6eeb4c57f65509173a98a1eeea31ea53c0aa0f57c9ac685b8a5eef42f3327806a9a3a020bedb0590d7754a54b82b4846c10c53ce3365fbbcc15ef7f9d6e7b8df646d7ab78d250992f954353e6cf9d14b5e4f3f359aaf1d08461696f9a07f725603be4c57f65509173a98a1eeea31ea53c0aa0f57c9ac685b8a5ee2ea5c301ea1bf06ddc25cbd507750f81b4f4a7a923ff1d18c64fd7b13cea86e89bb1862539ea9168e3aa14567546de92ed609e7dacf4b492113bbc287ad49b31521a088fdb3eef1931f52ad35b0d2accefc9c19ff0248f1992e2f74fe690f750f4fb415a8522736afd7a0b01f2e97f3ffe6da7dc471270df58c4714bf2fcb8068bc4c17cedcdb7e40fcec89f2bf701326ed798835a76b6431b01c0ba3b221b1ec57795da9568416b1bab685d2388768b357ef73c766068ea39e642a41efe4490a453b2167394d6a03609ff04236e65fbe289d98c9635ce4efb18c9ded50cc5d709a0722131d55bdcdfb17aeeec94633da5ab952b88be619ec78375370ae70bb4893dbaf5dc2b24fef95582bb594a6c215c1a5c0f388f10e40dc05e17963026d36c5382b050e5ed54b3eae15a0cc7c64860881486db892a7fa0c436fcbec7d9a3209a6a9d31e349039e76447d43d8ce874de8cdd1bf5517881bd887bdf0c9cb8d5aaca15659d6efd59da05416e49e31f20fccbee695a33f5c11061d8111e2bd7b858e81ae75bbf16436a63a9d265a73abc1586ca71393a16b743a576c460369f5e193a42052cf75fbb668ebe78b20f7934b4913d570f9276c30f182edc6b07ab02b93d58823ad27ec497f67886b95dac83f167a0a1c5f7084a960692b17567f82e15676c9a6310d12f42e5d567f33e107022f389cbdf790ede15676c9a6310d120d032e5d8e4301c2187c58c4de7a4ca117526ea868bc010c1029848bbf8a5fbbfdbb58bf5dd6dd660c8caa2678b40fdd10253ab9e0178917241b890944d9adae2433e7ea6c92707f810d75f6ffce9addbbf6840a064c5c52ab23481b612706e1db5e42a5db0c9617ee31b189c3b8945b9aaa25a7949acdd30bec84ccd912df0d53be785897ddae60
Die Antwort ist eine URL wie "https://www.computop-paygate.com/paybylink.aspx?id=025e47f6601e421995e082a4439de5e2", die kopiert und an Ihren Kunden gesendet werden kann.
Jede Anfrage an PayByLink.aspx?action=create → erzeugt eine neue PayByLink-Id.