PHPackages                             baltpeter/internetmarke-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. baltpeter/internetmarke-php

AbandonedArchivedLibrary[API Development](/categories/api)

baltpeter/internetmarke-php
===========================

A simple PHP wrapper for the Deutsche Post Internetmarke web service

v0.5.0(6y ago)3760.7k↓48.4%8[1 issues](https://github.com/baltpeter/internetmarke-php/issues)[1 PRs](https://github.com/baltpeter/internetmarke-php/pulls)MITPHP

Since Mar 27Pushed 8mo ago1 watchersCompare

[ Source](https://github.com/baltpeter/internetmarke-php)[ Packagist](https://packagist.org/packages/baltpeter/internetmarke-php)[ RSS](/packages/baltpeter-internetmarke-php/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependencies (1)Versions (7)Used By (0)

internetmarke-php – Simple PHP wrapper for the Internetmarke API
================================================================

[](#internetmarke-php--simple-php-wrapper-for-the-internetmarke-api)

> Simple PHP wrapper for the 1C4A (“OneClickForApplikation”) web service for the Internetmarke provided by Deutsche Post (DPAG).

Caution

Deutsche Post will [sunset](https://developer.dhl.com/api-reference/deutsche-post-internetmarke-post-parcel-germany?lang=en#additional-information-section/deprecation-schedule) the SOAP API that this library uses on December 31, 2025. Afterwards, this library will stop working. It won't be maintained anymore.

[![Ordering a stamp using internetmarke-php](https://camo.githubusercontent.com/f963467dd700e88bfe60b24f6dbbf44d168c89c07f03aee9882308e9abd8279d/68747470733a2f2f7374617469632e626e2e616c2f696d672f696e7465726e65746d61726b652d7068702d6865726f2e737667)](https://camo.githubusercontent.com/f963467dd700e88bfe60b24f6dbbf44d168c89c07f03aee9882308e9abd8279d/68747470733a2f2f7374617469632e626e2e616c2f696d672f696e7465726e65746d61726b652d7068702d6865726f2e737667)

This project’s main purpose is to be able to order Deutsche Post stamps directly from your own applications. The payment is handled via the Portokasse, a prepaid wallet service also by Deutsche Post.

The web service by Deutsche Post is a custom SOAP API (see the WSDL here: ). This project aims to abstract the SOAP nature away and provide a PHP API, while still adhering to the structure defined by DPAG. Do note that this is only a very thin wrapper around the SOAP API and the user still has to follow DPAG’s [specification](https://www.deutschepost.de/de/i/internetmarke-porto-drucken/downloads.html).

Requirements
------------

[](#requirements)

To access the web service, you will need to register as a partner with DPAG. This can either be done via their [website](https://www.deutschepost.de/de/i/internetmarke-porto-drucken/geschaeftskunden.html) (German only) or by contacting . They ask you to fill out following [form](https://www.deutschepost.de/content/dam/dpag/images/i_i/Internetmarke/partnerwerden/dp-internetmarke-anmeldebogen-api-anbindung.pdf). So keep in mind to fill it out first. (German only).
They will send you the documentation for the web service and create your personal credentials (consisting of: your partner ID, a secret key called `SCHLUESSEL_DPWN_MARKTPLATZ`, and a key phase which is usually `1`).

In addition, you will need to have an account for the [Portokasse service](https://portokasse.deutschepost.de/portokasse/#!/). This is a prepaid wallet from which your purchase totals will be deducted.
After registering, you can access the service with your username (email address) and password.

Installation
------------

[](#installation)

The package is available via Composer. To install the latest version from Packagist, run:

```
composer require baltpeter/internetmarke-php

```

Basic Usage
-----------

[](#basic-usage)

All actions provided by the web service are implemented in the `baltpeter\Internetmarke\Service` class.

This example shows you how to order a single stamp for a domestic letter. Other actions and parameters are documented with phpDoc. For more examples, please refer to the [wiki](https://github.com/baltpeter/internetmarke-php/wiki/Examples).

```
// The `PartnerInformation` object is used to authenticate you as a partner with DPAG.
$partner_info = new \baltpeter\Internetmarke\PartnerInformation('ABCDE', 1, 'yoursecretkey');
// The `Service` object provides an interface for all actions in the web service.
$service = new \baltpeter\Internetmarke\Service($partner_info);

// First, we need to get a token for our Portokasse user.
$user_token = $service->authenticateUser('portokasse@yourmailserver.tld', 'yourpassword')->getUserToken();

// Next, we create an `OrderItem` which holds the details of the stamp we want to purchase.
$order_item = new \baltpeter\Internetmarke\OrderItem(1, null, null,
    new \baltpeter\Internetmarke\Position(1, 1, 1), 'FrankingZone');

// Finally, we call `checkoutShoppingCartPdf()` which creates the order and actually
// deducts the money from your Portokasse.
// The last parameter in this example is the total cost in eurocents, which you have to calculate
// manually. This value *has* to be correct, it is checked on the server side.
var_dump($service->checkoutShoppingCartPdf($user_token, 1, array($order_item), 80));
```

Running this code will print a result similar to this:

```
object(stdClass)#10 (3) {
  ["link"]=>
  string(111) "https://internetmarke.deutschepost.de/PcfExtensionWeb/document?keyphase=0&data=abcdefghijklmopqrstuvwxyz"
  ["walletBallance"]=>
  int(236725)
  ["shoppingCart"]=>
  object(stdClass)#11 (2) {
    ["shopOrderId"]=>
    string(9) "12345678"
    ["voucherList"]=>
    object(stdClass)#12 (1) {
      ["voucher"]=>
      array(1) {
        [0]=>
        object(stdClass)#13 (1) {
          ["voucherId"]=>
          string(20) "A0011E78E1000001234A"
        }
      }
    }
  }
}
```

Note how we wrapped the `$order_item` in an array. If you want to order multiple stamps, just include more `OrderItem`s in that array.

The stamp in the linked PDF will look something like this:

[![The generated stamp](https://camo.githubusercontent.com/44ca8aae32571c4426bb352d14eb58aaf4ec7e9537e50ec9a2fc7507f11eaea3/68747470733a2f2f7374617469632e626e2e616c2f696d672f696e7465726e65746d61726b652d7068702d7374616d702d6578616d706c652e706e67)](https://camo.githubusercontent.com/44ca8aae32571c4426bb352d14eb58aaf4ec7e9537e50ec9a2fc7507f11eaea3/68747470733a2f2f7374617469632e626e2e616c2f696d672f696e7465726e65746d61726b652d7068702d7374616d702d6578616d706c652e706e67)

Again, please refer to the [wiki](https://github.com/baltpeter/internetmarke-php/wiki/Examples) for more examples.

License
-------

[](#license)

internetmarke-php is licensed under the MIT license, see the `LICENSE` file for details. Pull requests are welcome!

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance42

Moderate activity, may be stable

Popularity42

Moderate usage in the ecosystem

Community14

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 70% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~171 days

Recently: every ~213 days

Total

6

Last Release

2530d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9f32209200fa6ad616d06094246385a16b9b68ad214763cc0b8978b5c1816a60?d=identicon)[baltpeter](/maintainers/baltpeter)

---

Top Contributors

[![baltpeter](https://avatars.githubusercontent.com/u/4048809?v=4)](https://github.com/baltpeter "baltpeter (14 commits)")[![niels-numbers](https://avatars.githubusercontent.com/u/1765602?v=4)](https://github.com/niels-numbers "niels-numbers (5 commits)")[![Deltachaos](https://avatars.githubusercontent.com/u/679561?v=4)](https://github.com/Deltachaos "Deltachaos (1 commits)")

---

Tags

1c4adeprecateddeutsche-posthacktoberfestinternetmarkephpstamp

### Embed Badge

![Health badge](/badges/baltpeter-internetmarke-php/health.svg)

```
[![Health](https://phpackages.com/badges/baltpeter-internetmarke-php/health.svg)](https://phpackages.com/packages/baltpeter-internetmarke-php)
```

###  Alternatives

[phpunit/phpunit

The PHP Unit Testing framework.

20.0k955.1M155.1k](/packages/phpunit-phpunit)[dedoc/scramble

Automatic generation of API documentation for Laravel applications.

2.1k11.2M100](/packages/dedoc-scramble)[pimcore/pimcore

Content & Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.8M508](/packages/pimcore-pimcore)[spiral/framework

Spiral, High-Performance PHP/Go Framework

2.1k2.2M66](/packages/spiral-framework)[oro/platform

Business Application Platform (BAP)

645143.5k115](/packages/oro-platform)[open-dxp/opendxp

Content & Product Management Framework (CMS/PIM)

9421.6k61](/packages/open-dxp-opendxp)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)