Computop Paygate allows to initiate Pay By Link payments to ease remote ecommerce payments for you and for your customers.

These Pay By Link payments are normally initiated by you from Computop Analytics

The intention is that you can send payment links with a dedicated amount and currency and additional information (shopping basked, address data) which are then sent by email to your customers to complete the payment. 

Now Pay By Link is also available via Paygate-API.


How it works

  • you will use https://www.computop-paygate.com/PayByLink.aspx?action=create&MerchantID=<yourMerchantId>&Len=...&Data=...
    to create a new PayByLink-ID (PbLId)
  • you will send a PayByLink-payment to your customer https://www.computop-paygate.com/PayByLink.aspx?id=<PbLId>
    to ask the your customer to complete the payment
  • the customer initiates the payment by opening the link you've sent: https://www.computop-paygate.com/PayByLink.aspx?id=<PbLId>
  • your will receive confirmation to URLNotify provided in the link you've built.
  • you will receive an email once the customer completed the payment successfully. Email-address needs to be setup by Computop Helpdesk


 To carry out PayByLink-creation via a Server-to-Server connection, please use the following URL:

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


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.

Key

Format

CND

Description

Beschreibung
actionMcreate
  • e.g. PayByLink.aspx?action=create&Len=xxx&Data=xxx
  • creates a new record in database table and returns PbLID
  • z.B. PayByLink.aspx?action=create&Len=xxx&Data=xxx
  • erzeugt einen neuen Datensatz in der Datenbanktabelle und gibt PbLID zurück
LenMBlowfish/AES-LENLen of data before encryptionLänge der Daten vor der Verschlüsselung
DataMEncryped Blowfish/AES data

containing HPP-request parameter (already encrypted with Len=...&Data=...)
and additional plain text parameters, e.g. ExpirationDate, CustomField1..16, channel, PayTypes, ....

  • Parameters for Hosted Payment Page request can be found here: Hosted Payment Page
  • (warning) Parameter "RefNr" is mandatory
  • (warning) Parameter "ExpirationDate" (Format YYYY-MM-dd HH:mm:ss) is mandatory, too
    if you want to create a PbLId without expiration you can use e.g. "2099-12-31 23:59:59"

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
  • (warning) Der Parameter "RefNr" ist Pflicht
  • (warning) Der Parameter "ExpirationDate" (Format JJJJ-MM-TT HH:mm:ss) ist ebenfalls Pflicht
    Wenn Sie eine PbLId ohne Ablauf erzeugen wollen, verwenden Sie z.B. "2099-12-31 23:59:59"

Request parameters to create Pay By Link


If PayByLink-API-request was successful you will receive a URL that can be used and sent to the customer as it is.


Sample

1. Building Link to Hosted Payment Page

a) Build request parameters for Hosted Payment Page

  • Parameters for Hosted Payment Page request can be found here: Hosted Payment Page
  • ExpirationDate is mandatory, e.g. "ExpirationDate=2099-12-31 23:59:59"

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

  • Encrypt these data with your Blowfish/AES-password

MerchantID=yourMerchantId&Len=410&Data=fb0f6ee9876fea46f0c9da4224b3559fc316aa2a25334716c5ae40987a9c1c39d4ce95305a65583dd48fc7bf3f5f16e62148191fb636e79574d9e298cc36ef15e56834da45705f220e51ff19cadf957d7841584277d3291d6349593368d3f0e0a242ad1129c70e1754de3944f2a26a6013aeb986ec89985a5acf52f00875ecc10c8caa2678b40fdd10253ab9e017891755f2d8872a0430f0bc8903a57e18bbd65b85d9d1becafcf1dc569b465182c1630c8caa2678b40fdd10253ab9e0178917c0906e6b0f44a2eb01bf04f5dec731cd6a22e817cbdd8632882e76d1f99be8fddbd9cc830472ecebe4b4d9b086efb879e0b51ccd7c1ccf48fcf94f0d7dedbf334592297796d416131b157ba1e2212bda322c3635d28da9e5f2da6cd629b3102552fbee92890381ae497f67886b95dac890791166a31269b53b893fdcb25cacf3789bc7b98c8b96ad1a8867058e1846b5fe32e3a17bb6535cea1b9533c4840e43af6e00bb0b709eda16f5948af965f5b411c5eb51226e08c611d4e2e27ae5f4931ba58e1d5b6ae6cb38488f2ceafc390160d723d28acabfafd587725e06dc18fd

b) Add to the encrypted data (Len+Data) additional plain parameters if required

  • Add additional parameters like Template-names, UrlBack, Language if needed.

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

  • Encrypt these data a 2nd time with your Blowfish/AES-password.

  • this 2nd encryption is always required - even if no "additional plain parameters" are used

MerchantID=yourMerchantId&Len=1064&Data=fb0f6ee9876fea46f0c9da4224b3559fc316aa2a25334716efaf244b907c1cab68f1b5f4d87235db85f929704bef40c18f4c2c2c9c30b3e8dbf3a26817fc731350b83d612cdd9a6bf86ee1725a5620dd454382f7489551ab257f3757065293dd98660c22d472dcd71ef3bbf7514e3ecdf9529b385bf54ab7b975c1df5e88e831ddec73e7b7384590b3c31cd6c3c9c7553ecada7cb132c7bf5c41ebd7e443ea9c16f2b2c87570e8fdea572cb7d8fa1702e8edbdaf0fbd2ce9c9f0fa409a980eb3f552863668ce275861db0f101c50c22bd07e89dcf42503c2d65fbd28b5ca5895ec0510334bff65ecf919552feda8a8ba8f062e56159dc02cfaf5588558408c30fe0141fd0dbf1feb7be3b20bd4a500fc706137c1fe12688580dd00e3017d9854202e6ce58fa6eeb4c57f65509173a98a1eeea31ea53c0aa0f57c9ac685b8a5eef42f3327806a9a3a020bedb0590d7754a54b82b4846c10c53ce3365fbbcc15ef7f9d6e7b8df646d7ab78d250992f954353e6cf9d14b5e4f3f359aaf1d08461696f9a07f725603be4c57f65509173a98a1eeea31ea53c0aa0f57c9ac685b8a5ee2ea5c301ea1bf06ddc25cbd507750f81b4f4a7a923ff1d18c64fd7b13cea86e89bb1862539ea9168e3aa14567546de92ed609e7dacf4b492113bbc287ad49b31521a088fdb3eef1931f52ad35b0d2accefc9c19ff0248f1992e2f74fe690f750f4fb415a8522736afd7a0b01f2e97f3ffe6da7dc471270df58c4714bf2fcb8068bc4c17cedcdb7e40fcec89f2bf701326ed798835a76b6431b01c0ba3b221b1ec57795da9568416b1bab685d2388768b357ef73c766068ea39e642a41efe4490a453b2167394d6a03609ff04236e65fbe289d98c9635ce4efb18c9ded50cc5d709a0722131d55bdcdfb17aeeec94633da5ab952b88be619ec78375370ae70bb4893dbaf5dc2b24fef95582bb594a6c215c1a5c0f388f10e40dc05e17963026d36c5382b050e5ed54b3eae15a0cc7c64860881486db892a7fa0c436fcbec7d9a3209a6a9d31e349039e76447d43d8ce874de8cdd1bf5517881bd887bdf0c9cb8d5aaca15659d6efd59da05416e49e31f20fccbee695a33f5c11061d8111e2bd7b858e81ae75bbf16436a63a9d265a73abc1586ca71393a16b743a576c460369f5e193a42052cf75fbb668ebe78b20f7934b4913d570f9276c30f182edc6b07ab02b93d58823ad27ec497f67886b95dac83f167a0a1c5f7084a960692b17567f82e15676c9a6310d12f42e5d567f33e107022f389cbdf790ede15676c9a6310d120d032e5d8e4301c2187c58c4de7a4ca117526ea868bc010c1029848bbf8a5fbbfdbb58bf5dd6dd660c8caa2678b40fdd10253ab9e0178917241b890944d9adae2433e7ea6c92707f810d75f6ffce9addbbf6840a064c5c52ab23481b612706e1db5e42a5db0c9617ee31b189c3b8945b9aaa25a7949acdd30bec84ccd912df0d53be785897ddae60


2. Use Link to Hosted Payment Page to create PbLId via PayByLink.aspx

  • Take encrypted data from 1b) and send them with "action=create" to PayByLink.aspx, e.g.
  • https://www.computop-paygate.com/PayByLink.aspx?action=create&MerchantID=yourMerchantId&Len=1064&Data=fb0f6ee9876fea46f0c9da4224b3559fc316aa2a25334716efaf244b907c1cab68f1b5f4d87235db85f929704bef40c18f4c2c2c9c30b3e8dbf3a26817fc731350b83d612cdd9a6bf86ee1725a5620dd454382f7489551ab257f3757065293dd98660c22d472dcd71ef3bbf7514e3ecdf9529b385bf54ab7b975c1df5e88e831ddec73e7b7384590b3c31cd6c3c9c7553ecada7cb132c7bf5c41ebd7e443ea9c16f2b2c87570e8fdea572cb7d8fa1702e8edbdaf0fbd2ce9c9f0fa409a980eb3f552863668ce275861db0f101c50c22bd07e89dcf42503c2d65fbd28b5ca5895ec0510334bff65ecf919552feda8a8ba8f062e56159dc02cfaf5588558408c30fe0141fd0dbf1feb7be3b20bd4a500fc706137c1fe12688580dd00e3017d9854202e6ce58fa6eeb4c57f65509173a98a1eeea31ea53c0aa0f57c9ac685b8a5eef42f3327806a9a3a020bedb0590d7754a54b82b4846c10c53ce3365fbbcc15ef7f9d6e7b8df646d7ab78d250992f954353e6cf9d14b5e4f3f359aaf1d08461696f9a07f725603be4c57f65509173a98a1eeea31ea53c0aa0f57c9ac685b8a5ee2ea5c301ea1bf06ddc25cbd507750f81b4f4a7a923ff1d18c64fd7b13cea86e89bb1862539ea9168e3aa14567546de92ed609e7dacf4b492113bbc287ad49b31521a088fdb3eef1931f52ad35b0d2accefc9c19ff0248f1992e2f74fe690f750f4fb415a8522736afd7a0b01f2e97f3ffe6da7dc471270df58c4714bf2fcb8068bc4c17cedcdb7e40fcec89f2bf701326ed798835a76b6431b01c0ba3b221b1ec57795da9568416b1bab685d2388768b357ef73c766068ea39e642a41efe4490a453b2167394d6a03609ff04236e65fbe289d98c9635ce4efb18c9ded50cc5d709a0722131d55bdcdfb17aeeec94633da5ab952b88be619ec78375370ae70bb4893dbaf5dc2b24fef95582bb594a6c215c1a5c0f388f10e40dc05e17963026d36c5382b050e5ed54b3eae15a0cc7c64860881486db892a7fa0c436fcbec7d9a3209a6a9d31e349039e76447d43d8ce874de8cdd1bf5517881bd887bdf0c9cb8d5aaca15659d6efd59da05416e49e31f20fccbee695a33f5c11061d8111e2bd7b858e81ae75bbf16436a63a9d265a73abc1586ca71393a16b743a576c460369f5e193a42052cf75fbb668ebe78b20f7934b4913d570f9276c30f182edc6b07ab02b93d58823ad27ec497f67886b95dac83f167a0a1c5f7084a960692b17567f82e15676c9a6310d12f42e5d567f33e107022f389cbdf790ede15676c9a6310d120d032e5d8e4301c2187c58c4de7a4ca117526ea868bc010c1029848bbf8a5fbbfdbb58bf5dd6dd660c8caa2678b40fdd10253ab9e0178917241b890944d9adae2433e7ea6c92707f810d75f6ffce9addbbf6840a064c5c52ab23481b612706e1db5e42a5db0c9617ee31b189c3b8945b9aaa25a7949acdd30bec84ccd912df0d53be785897ddae60
  • The response will be a URL like "https://www.computop-paygate.com/paybylink.aspx?id=025e47f6601e421995e082a4439de5e2" which can be copied and sent to your customer.
  • (info) Each Request to PayByLink.aspx?action=create → will ceate a new PayByLink-Id.


  • No labels