Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space ENWORK and version Documentation

...

  • you will use
    Multiexcerpt include
    SpaceWithExcerptEN
    MultiExcerptNameBaseURL
    PageWithExcerptWording
    PayByLink.aspx?action=create&MerchantID=<yourMerchantId>&Len=...&Data=...
    to create a new PayByLink-ID (PbLId)
  • you will send a PayByLink-payment to your customer
    Multiexcerpt include
    SpaceWithExcerptEN
    MultiExcerptNameBaseURL
    PageWithExcerptWording
    PayByLink.aspx?PbLIdid=<PbLId>
    to ask the your customer to complete the payment
  • the customer initiates the payment by opening the link you've sent:
    Multiexcerpt include
    SpaceWithExcerptEN
    MultiExcerptNameBaseURL
    PageWithExcerptWording
    PayByLink.aspx?PbLIdid=<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
    Multiexcerpt include
    SpaceWithExcerptEN
    MultiExcerptNameHelpdesk-Name
    PageWithExcerptWording

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

...

Table Filter
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1679496950363_-151997320
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNamerequest
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1679496950364_1169781734
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
statictrue
nameMerchantID
pageMerchantID
typepage

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

LenMBlowfish/AES-LENLen of data before encryption
DataMEncryped Blowfish/AES data

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

Request parameters to create Pay By Link

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

...

defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1679497313298_-1938336087
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

...

MultiExcerptNameresponse

...

  • Parameters for Hosted Payment Page request can be found here: Hosted Payment Page
  • (warning) Parameter "ExpirationDate" (Format YYYY-MM-dd HH:mm:ss) is mandatory
    if 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

...

dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1679497313300_-283224804
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
statictrue
nameMID
pagemid
typepage

...

Key

...

Format

...

CND

...

Description

...

PayByLinkId new created Pay By Link ID

Table Excerpt Include
statictrue
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
statictrue
nameDescription
pageDescription
typepage

Table Excerpt Include
statictrue
nameCode
pageCode
typepage

Table Excerpt Include
statictrue
nameMAC
pageMAC
typepage

Response parameters to create Pay By Link

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"
Multiexcerpt
MultiExcerptName1sample_plain


Code Block
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&URLBack=https://www.yourshop.com/back.url&Language=enLanguage=en&ExpirationDate=2099-12-31 23:59:59&MAC=abbe18e21242e816452fbcbfb62ff16a11c22960b660f91007e474f77a28e741

...

  • encrypt these data

...

  • with your Blowfish/AES-password
Multiexcerpt
MultiExcerptName1sample_encrypted


Code Block
MerchantID=yourMerchantId&Len=376410&Data=397fb1b3eadb19c4c4610422e3426cecbc9e5f3c83ff04be7a98424c32cd9c23ed65f7cea0b49c808565b9499e31251230455473e910e21a2cdeb7535ae0b3366addf4627bb0ef3c7a4c4ec9c9b4f0956fcf5fee590a4be711fb70ae127684abc8f3f1717fa75a421c4eb8ae12bc62eece8c44dc50726afcf4d249d8a4d5af7ee93f9ea95839bf6ffcaa94eaa70e46f0822d88391b64bda770d54bbba08906bffa43bb2b6a11d6a7cf9f16c82f04f76ce93f9ea95839bf6ffcaa94eaa70e46f0f19f79ff91283c091c2ab39a71f0ce95a0eb64cd0a33661d1e5584535d7ddc3cdf031e73a2185de396aef75883cec751591bf0c5981f6a10662f338e7a0f992fe6b18e64381dce54a587452da6ca8d24a7c4ed9fdc6233f4684d1b88b4fea46c0c78fa0b9c76273abda0956f69eabb0c9745bd76d4121037167c6554d897d55341fbb21fa95a3f26d8b4132d022c245d0f09d9bf6488a86accf189dd306f14fac3e6d65489d7b682736cf2021a293a5ce5e05650359f11e1

...

fb0f6ee9876fea46f0c9da4224b3559fc316aa2a25334716c5ae40987a9c1c39d4ce95305a65583dd48fc7bf3f5f16e62148191fb636e79574d9e298cc36ef15e56834da45705f220e51ff19cadf957d7841584277d3291d6349593368d3f0e0a242ad1129c70e1754de3944f2a26a6013aeb986ec89985a5acf52f00875ecc10c8caa2678b40fdd10253ab9e017891755f2d8872a0430f0bc8903a57e18bbd65b85d9d1becafcf1dc569b465182c1630c8caa2678b40fdd10253ab9e0178917c0906e6b0f44a2eb01bf04f5dec731cd6a22e817cbdd8632882e76d1f99be8fddbd9cc830472ecebe4b4d9b086efb879e0b51ccd7c1ccf48fcf94f0d7dedbf334592297796d416131b157ba1e2212bda322c3635d28da9e5f2da6cd629b3102552fbee92890381ae497f67886b95dac890791166a31269b53b893fdcb25cacf3789bc7b98c8b96ad1a8867058e1846b5fe32e3a17bb6535cea1b9533c4840e43af6e00bb0b709eda16f5948af965f5b411c5eb51226e08c611d4e2e27ae5f4931ba58e1d5b6ae6cb38488f2ceafc390160d723d28acabfafd587725e06dc18fd

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

  • add additional parameters like Template-names, UrlBack,

...

  • Language if needed
Multiexcerpt
MultiExcerptName1sample_plusplain


Code Block
MerchantID=yourMerchantId&Len=376410&Data=397fb1b3eadb19c4c4610422e3426cecbc9e5f3c83ff04be7a98424c32cd9c23ed65f7cea0b49c808565b9499e31251230455473e910e21a2cdeb7535ae0b3366addf4627bb0ef3c7a4c4ec9c9b4f0956fcf5fee590a4be711fb70ae127684abc8f3f1717fa75a421c4eb8ae12bc62eece8c44dc50726afcf4d249d8a4d5af7ee93f9ea95839bf6ffcaa94eaa70e46f0822d88391b64bda770d54bbba08906bffa43bb2b6a11d6a7cf9f16c82f04f76ce93f9ea95839bf6ffcaa94eaa70e46f0f19f79ff91283c091c2ab39a71f0ce95a0eb64cd0a33661d1e5584535d7ddc3cdf031e73a2185de396aef75883cec751591bf0c5981f6a10662f338e7a0f992fe6b18e64381dce54a587452da6ca8d24a7c4ed9fdc6233f4684d1b88b4fea46c0c78fa0b9c76273abda0956f69eabb0c9745bd76d4121037167c6554d897d55341fbb21fa95a3f26d8b4132d022c245d0f09d9bf6488a86accf189dd306f14fac3e6d65489d7b682736cf2021a293a5ce5e05650359f11e1fb0f6ee9876fea46f0c9da4224b3559fc316aa2a25334716c5ae40987a9c1c39d4ce95305a65583dd48fc7bf3f5f16e62148191fb636e79574d9e298cc36ef15e56834da45705f220e51ff19cadf957d7841584277d3291d6349593368d3f0e0a242ad1129c70e1754de3944f2a26a6013aeb986ec89985a5acf52f00875ecc10c8caa2678b40fdd10253ab9e017891755f2d8872a0430f0bc8903a57e18bbd65b85d9d1becafcf1dc569b465182c1630c8caa2678b40fdd10253ab9e0178917c0906e6b0f44a2eb01bf04f5dec731cd6a22e817cbdd8632882e76d1f99be8fddbd9cc830472ecebe4b4d9b086efb879e0b51ccd7c1ccf48fcf94f0d7dedbf334592297796d416131b157ba1e2212bda322c3635d28da9e5f2da6cd629b3102552fbee92890381ae497f67886b95dac890791166a31269b53b893fdcb25cacf3789bc7b98c8b96ad1a8867058e1846b5fe32e3a17bb6535cea1b9533c4840e43af6e00bb0b709eda16f5948af965f5b411c5eb51226e08c611d4e2e27ae5f4931ba58e1d5b6ae6cb38488f2ceafc390160d723d28acabfafd587725e06dc18fd&Language=en&Template=HPP_Template&CCTemplate=SSL_Template&SDDTemplate=SDD_Template

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

...

&URLBack=https://www.yourshop.com/back.url
  • encrypt these data a 2nd time with your Blowfish/AES-password

    Multiexcerpt
    MultiExcerptName

...

  • 1sample_encrypted


    Code Block
    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.
  • Multiexcerpt include
    SpaceWithExcerptEN
    MultiExcerptNameBaseURL
    PageWithExcerptWording
    PayByLink.aspx

...

  • ?action=create

...

  • &MerchantID=yourMerchantId&Len=1064&Data=fb0f6ee9876fea46f0c9da4224b3559fc316aa2a25334716efaf244b907c1cab68f1b5f4d87235db85f929704bef40c18f4c2c2c9c30b3e8dbf3a26817fc731350b83d612cdd9a6bf86ee1725a5620dd454382f7489551ab257f3757065293dd98660c22d472dcd71ef3bbf7514e3ecdf9529b385bf54ab7b975c1df5e88e831ddec73e7b7384590b3c31cd6c3c9c7553ecada7cb132c7bf5c41ebd7e443ea9c16f2b2c87570e8fdea572cb7d8fa1702e8edbdaf0fbd2ce9c9f0fa409a980eb3f552863668ce275861db0f101c50c22bd07e89dcf42503c2d65fbd28b5ca5895ec0510334bff65ecf919552feda8a8ba8f062e56159dc02cfaf5588558408c30fe0141fd0dbf1feb7be3b20bd4a500fc706137c1fe12688580dd00e3017d9854202e6ce58fa6eeb4c57f65509173a98a1eeea31ea53c0aa0f57c9ac685b8a5eef42f3327806a9a3a020bedb0590d7754a54b82b4846c10c53ce3365fbbcc15ef7f9d6e7b8df646d7ab78d250992f954353e6cf9d14b5e4f3f359aaf1d08461696f9a07f725603be4c57f65509173a98a1eeea31ea53c0aa0f57c9ac685b8a5ee2ea5c301ea1bf06ddc25cbd507750f81b4f4a7a923ff1d18c64fd7b13cea86e89bb1862539ea9168e3aa14567546de92ed609e7dacf4b492113bbc287ad49b31521a088fdb3eef1931f52ad35b0d2accefc9c19ff0248f1992e2f74fe690f750f4fb415a8522736afd7a0b01f2e97f3ffe6da7dc471270df58c4714bf2fcb8068bc4c17cedcdb7e40fcec89f2bf701326ed798835a76b6431b01c0ba3b221b1ec57795da9568416b1bab685d2388768b357ef73c766068ea39e642a41efe4490a453b2167394d6a03609ff04236e65fbe289d98c9635ce4efb18c9ded50cc5d709a0722131d55bdcdfb17aeeec94633da5ab952b88be619ec78375370ae70bb4893dbaf5dc2b24fef95582bb594a6c215c1a5c0f388f10e40dc05e17963026d36c5382b050e5ed54b3eae15a0cc7c64860881486db892a7fa0c436fcbec7d9a3209a6a9d31e349039e76447d43d8ce874de8cdd1bf5517881bd887bdf0c9cb8d5aaca15659d6efd59da05416e49e31f20fccbee695a33f5c11061d8111e2bd7b858e81ae75bbf16436a63a9d265a73abc1586ca71393a16b743a576c460369f5e193a42052cf75fbb668ebe78b20f7934b4913d570f9276c30f182edc6b07ab02b93d58823ad27ec497f67886b95dac83f167a0a1c5f7084a960692b17567f82e15676c9a6310d12f42e5d567f33e107022f389cbdf790ede15676c9a6310d120d032e5d8e4301c2187c58c4de7a4ca117526ea868bc010c1029848bbf8a5fbbfdbb58bf5dd6dd660c8caa2678b40fdd10253ab9e0178917241b890944d9adae2433e7ea6c92707f810d75f6ffce9addbbf6840a064c5c52ab23481b612706e1db5e42a5db0c9617ee31b189c3b8945b9aaa25a7949acdd30bec84ccd912df0d53be785897ddae60
  • the response will be a URL like "https://computop-paygate.com/paybylink.aspx?id=025e47f6601e421995e082a4439de5e2" which can be copied and sent to your customer.

...

3. Send payment link via PayByLink.aspx to your customer

...

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBaseURL
PageWithExcerptWording

...