Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Platform-Name |
---|
PageWithExcerpt | Wording |
---|
|
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
Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Backoffice-Name |
---|
PageWithExcerpt | Wording |
---|
|
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
Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Platform-Kurz |
---|
PageWithExcerpt | Wording |
---|
|
-API.
How it works
- you will use
Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | BaseURL |
---|
PageWithExcerpt | Wording |
---|
|
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 |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | BaseURL |
---|
PageWithExcerpt | Wording |
---|
|
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:
Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | BaseURL |
---|
PageWithExcerpt | Wording |
---|
|
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
Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Helpdesk-Name |
---|
PageWithExcerpt | Wording |
---|
|
API Call to create Pay By Link
To carry out
...
PayByLink-creation via a Server-to-Server connection, please use the following URL:
Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | BaseURL |
---|
PageWithExcerpt | Wording |
---|
| PayByLink.aspx
|
Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Request_Intro |
---|
PageWithExcerpt | Reuse API |
---|
|
Table Filter |
---|
default | Beschreibung |
---|
isFirstTimeEnter | false |
---|
hideColumns | true |
---|
sparkName | Sparkline |
---|
hidePane | true |
---|
datepattern | dd M yy |
---|
id |
---|
|
...
...
2010973829 | worklog | 365|5|8|y w d h m|y w d h m |
---|
isOR | AND |
---|
separator | Point (.) |
---|
order | 0 |
---|
|
Multiexcerpt |
---|
| Table Transformer |
---|
dateFormat | dd M yy |
---|
export-word | false |
---|
show-source | false |
---|
export-csv | false |
---|
id |
---|
|
|
|
...
...
-1378865413 | transpose | false |
---|
worklog | 365|5|8|y w d h m|y w d h m |
---|
separator | . |
---|
export-pdf | false |
---|
sql | SELECT * FROM T* |
---|
| Table Excerpt Include |
---|
static | true |
---|
name | MerchantID |
---|
page | MerchantID |
---|
type | page |
---|
|
Key | Format | CND | Description | Beschreibung |
---|
action | M | create | - 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
| Len | M | Blowfish/AES-LEN | Len of data before encryption | Länge der Daten vor der Verschlüsselung | Data | M | Encryped Blowfish/AES data | containing HPP-request parameter (already encrypted with Len=...&Data=...) and |
|
|
|
...
...
...
ExpirationDate, CustomField1..16, channel, PayTypes, .... |
|
|
|
Request parameters to create Pay By Link
Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Response_Intro |
---|
PageWithExcerpt | Reuse API |
---|
|
...
default | Beschreibung |
---|
isFirstTimeEnter | false |
---|
hideColumns | true |
---|
sparkName | Sparkline |
---|
hidePane | true |
---|
datepattern | dd M yy |
---|
id | 1679497313298_-1938336087 |
---|
worklog | 365|5|8|y w d h m|y w d h m |
---|
isOR | AND |
---|
separator | Point (.) |
---|
order | 0 |
---|
...
...
dateFormat | dd M yy |
---|
export-word | false |
---|
show-source | false |
---|
export-csv | false |
---|
id | 1679497313300_-283224804 |
---|
transpose | false |
---|
worklog | 365|5|8|y w d h m|y w d h m |
---|
separator | . |
---|
export-pdf | false |
---|
sql | SELECT * FROM T* |
---|
Table Excerpt Include |
---|
static | true |
---|
name | MID |
---|
page | mid |
---|
type | page |
---|
|
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.
...
Key
...
Format
...
CND
...
Description
...
PayByLinkId new created Pay By Link ID
Table Excerpt Include |
---|
static | true |
---|
name | Status_OK_FAILED |
---|
page | Status |
---|
type | page |
---|
|
Table Excerpt Include |
---|
static | true |
---|
name | Description |
---|
page | Description |
---|
type | page |
---|
|
Table Excerpt Include |
---|
static | true |
---|
name | Code |
---|
page | Code |
---|
type | page |
---|
|
Table Excerpt Include |
---|
static | true |
---|
name | MAC |
---|
page | MAC |
---|
type | page |
---|
|
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 |
---|
MultiExcerptName | 1sample_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& |
|
...
Language=en&ExpirationDate=2099-12-31 23:59:59&MAC=abbe18e21242e816452fbcbfb62ff16a11c22960b660f91007e474f77a28e741 |
|
...
- Encrypt these data with your Blowfish/AES-password
Multiexcerpt |
---|
MultiExcerptName | 1sample_encrypted |
---|
|
Code Block |
---|
MerchantID=yourMerchantId&Len= |
|
...
...
fb0f6ee9876fea46f0c9da4224b3559fc316aa2a25334716c5ae40987a9c1c39d4ce95305a65583dd48fc7bf3f5f16e62148191fb636e79574d9e298cc36ef15e56834da45705f220e51ff19cadf957d7841584277d3291d6349593368d3f0e0a242ad1129c70e1754de3944f2a26a6013aeb986ec89985a5acf52f00875ecc10c8caa2678b40fdd10253ab9e017891755f2d8872a0430f0bc8903a57e18bbd65b85d9d1becafcf1dc569b465182c1630c8caa2678b40fdd10253ab9e0178917c0906e6b0f44a2eb01bf04f5dec731cd6a22e817cbdd8632882e76d1f99be8fddbd9cc830472ecebe4b4d9b086efb879e0b51ccd7c1ccf48fcf94f0d7dedbf334592297796d416131b157ba1e2212bda322c3635d28da9e5f2da6cd629b3102552fbee92890381ae497f67886b95dac890791166a31269b53b893fdcb25cacf3789bc7b98c8b96ad1a8867058e1846b5fe32e3a17bb6535cea1b9533c4840e43af6e00bb0b709eda16f5948af965f5b411c5eb51226e08c611d4e2e27ae5f4931ba58e1d5b6ae6cb38488f2ceafc390160d723d28acabfafd587725e06dc18fd |
|
b) Add to the encrypted data (Len+Data) additional plain parameters if required
- Add additional parameters like Template-names, UrlBack,
...
Multiexcerpt |
---|
MultiExcerptName | 1sample_plusplain |
---|
|
Code Block |
---|
MerchantID=yourMerchantId&Len= |
|
...
...
fb0f6ee9876fea46f0c9da4224b3559fc316aa2a25334716c5ae40987a9c1c39d4ce95305a65583dd48fc7bf3f5f16e62148191fb636e79574d9e298cc36ef15e56834da45705f220e51ff19cadf957d7841584277d3291d6349593368d3f0e0a242ad1129c70e1754de3944f2a26a6013aeb986ec89985a5acf52f00875ecc10c8caa2678b40fdd10253ab9e017891755f2d8872a0430f0bc8903a57e18bbd65b85d9d1becafcf1dc569b465182c1630c8caa2678b40fdd10253ab9e0178917c0906e6b0f44a2eb01bf04f5dec731cd6a22e817cbdd8632882e76d1f99be8fddbd9cc830472ecebe4b4d9b086efb879e0b51ccd7c1ccf48fcf94f0d7dedbf334592297796d416131b157ba1e2212bda322c3635d28da9e5f2da6cd629b3102552fbee92890381ae497f67886b95dac890791166a31269b53b893fdcb25cacf3789bc7b98c8b96ad1a8867058e1846b5fe32e3a17bb6535cea1b9533c4840e43af6e00bb0b709eda16f5948af965f5b411c5eb51226e08c611d4e2e27ae5f4931ba58e1d5b6ae6cb38488f2ceafc390160d723d28acabfafd587725e06dc18fd&Language=en&Template=HPP_Template&CCTemplate=SSL_Template&SDDTemplate=SDD_Template |
|
...
&URLBack=https://www.yourshop.com/back.url |
|
2. Use Link to Hosted Payment Page to create PbLId via PayByLink.aspx
...
...
...
|
Code Block |
---|
MerchantID=yourMerchantId&Len= |
|
...
...
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 |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | BaseURL |
---|
PageWithExcerpt | Wording |
---|
|
PayByLink.aspx
...
...
- &MerchantID=yourMerchantId&Len=1064&Data=fb0f6ee9876fea46f0c9da4224b3559fc316aa2a25334716efaf244b907c1cab68f1b5f4d87235db85f929704bef40c18f4c2c2c9c30b3e8dbf3a26817fc731350b83d612cdd9a6bf86ee1725a5620dd454382f7489551ab257f3757065293dd98660c22d472dcd71ef3bbf7514e3ecdf9529b385bf54ab7b975c1df5e88e831ddec73e7b7384590b3c31cd6c3c9c7553ecada7cb132c7bf5c41ebd7e443ea9c16f2b2c87570e8fdea572cb7d8fa1702e8edbdaf0fbd2ce9c9f0fa409a980eb3f552863668ce275861db0f101c50c22bd07e89dcf42503c2d65fbd28b5ca5895ec0510334bff65ecf919552feda8a8ba8f062e56159dc02cfaf5588558408c30fe0141fd0dbf1feb7be3b20bd4a500fc706137c1fe12688580dd00e3017d9854202e6ce58fa6eeb4c57f65509173a98a1eeea31ea53c0aa0f57c9ac685b8a5eef42f3327806a9a3a020bedb0590d7754a54b82b4846c10c53ce3365fbbcc15ef7f9d6e7b8df646d7ab78d250992f954353e6cf9d14b5e4f3f359aaf1d08461696f9a07f725603be4c57f65509173a98a1eeea31ea53c0aa0f57c9ac685b8a5ee2ea5c301ea1bf06ddc25cbd507750f81b4f4a7a923ff1d18c64fd7b13cea86e89bb1862539ea9168e3aa14567546de92ed609e7dacf4b492113bbc287ad49b31521a088fdb3eef1931f52ad35b0d2accefc9c19ff0248f1992e2f74fe690f750f4fb415a8522736afd7a0b01f2e97f3ffe6da7dc471270df58c4714bf2fcb8068bc4c17cedcdb7e40fcec89f2bf701326ed798835a76b6431b01c0ba3b221b1ec57795da9568416b1bab685d2388768b357ef73c766068ea39e642a41efe4490a453b2167394d6a03609ff04236e65fbe289d98c9635ce4efb18c9ded50cc5d709a0722131d55bdcdfb17aeeec94633da5ab952b88be619ec78375370ae70bb4893dbaf5dc2b24fef95582bb594a6c215c1a5c0f388f10e40dc05e17963026d36c5382b050e5ed54b3eae15a0cc7c64860881486db892a7fa0c436fcbec7d9a3209a6a9d31e349039e76447d43d8ce874de8cdd1bf5517881bd887bdf0c9cb8d5aaca15659d6efd59da05416e49e31f20fccbee695a33f5c11061d8111e2bd7b858e81ae75bbf16436a63a9d265a73abc1586ca71393a16b743a576c460369f5e193a42052cf75fbb668ebe78b20f7934b4913d570f9276c30f182edc6b07ab02b93d58823ad27ec497f67886b95dac83f167a0a1c5f7084a960692b17567f82e15676c9a6310d12f42e5d567f33e107022f389cbdf790ede15676c9a6310d120d032e5d8e4301c2187c58c4de7a4ca117526ea868bc010c1029848bbf8a5fbbfdbb58bf5dd6dd660c8caa2678b40fdd10253ab9e0178917241b890944d9adae2433e7ea6c92707f810d75f6ffce9addbbf6840a064c5c52ab23481b612706e1db5e42a5db0c9617ee31b189c3b8945b9aaa25a7949acdd30bec84ccd912df0d53be785897ddae60
- The response will be a URL like "
Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | BaseURL |
---|
PageWithExcerpt | Wording |
---|
|
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.