Pay By Link API | Computop Documents

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 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

API Call to create Pay By Link

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:

Key	Format	CND	Description
MerchantID	ans..30	M	MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.
action	M	create	e.g. PayByLink.aspx?action=create&Len=xxx&Data=xxx creates a new record in database table and returns PbLID
Len	M	Blowfish/AES-LEN	Len of data before encryption
Data	M	Encryped 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 Parameter "RefNr" is mandatory Parameter "ExpirationDate" (Format YYYY-MM-dd HH:mm:ss) is mandatory, tooif you want to create a PbLId without expiration you can use e.g. "2099-12-31 23:59:59"

Key

Format

CND

Description

MerchantID

ans..30

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

action

create

e.g. PayByLink.aspx?action=create&Len=xxx&Data=xxx
creates a new record in database table and returns PbLID

Len

Blowfish/AES-LEN

Len of data before encryption

Data

Encryped 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
Parameter "RefNr" is mandatory
Parameter "ExpirationDate" (Format YYYY-MM-dd HH:mm:ss) is mandatory, tooif you want to create a PbLId without expiration you can use e.g. "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"
```
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
```

Encrypt these data with your Blowfish/AES-password

1
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.

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

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

1
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.
Each Request to PayByLink.aspx?action=create → will ceate a new PayByLink-Id