PHP 7.1+ Payment processing server. Setup once and rule them all

Installs: 314

Dependents: 0

Suggesters: 0

Security: 0

Stars: 114

Watchers: 12

Forks: 34

Open Issues: 4


1.0.0-alpha1 2015-11-11 22:05 UTC


Payum is an MIT-licensed open source project with its ongoing development made possible entirely by the support of community and our customers. If you'd like to join them, please consider:


Join the chat at Build Status Total Downloads Latest Stable Version

PHP 7.1+ Payment processing server. Setup once and rule them all. Here you can find a good introduction to what it does and what problems it solves.

Try it online:

Run local server

Create docker-compose.yml file:

version: '2'
    image: payum/server
      - PAYUM_MONGO_URI=mongodb://mongo:27017/payum_server
      - PAYUM_DEBUG=1
      - mongo
      - "8080:80"

    image: mongo

and run docker-compose up. You server will be at localhost:8080 port.

Test local server

  1. Copy .test.env.dist to .test.env
  2. Run bin/phpunit

Docker registry

The payum/server image and payum/server-ui are built automatically on success push to the master branch.

Setup & Run

$ php composer.phar create-project payum/payum-server --stability=dev
$ cd payum-server
$ php -S web/app.php

An example on javascript:

  // do new payment
  var payum = new Payum('http://localhost:8000');
  var payment = {totalAmount: 100, currencyCode: 'USD'};

  payum.payment.create(payment, function(payment) {
    var token = {
        type: 'capture',
        afterUrl: 'http://afterPaymentIsDoneUrl'

    payum.token.create(token, function(token) {
      // do redirect to token.targetUrl or process at the same page like this:
      payum.execute(token.targetUrl, '#payum-container');

Note: You might need a web client to manage payments gateways or you can use REST API.


Developed by Forma-Pro

Forma-Pro is a full stack development company which interests also spread to open source development. Being a team of strong professionals we have an aim an ability to help community by developing cutting edge solutions in the areas of e-commerce, docker & microservice oriented architecture where we have accumulated a huge many-years experience. Our main specialization is Symfony framework based solution, but we are always looking to the technologies that allow us to do our job the best way. We are committed to creating solutions that revolutionize the way how things are developed in aspects of architecture & scalability.

If you have any questions and inquires about our open source development, this product particularly or any other matter feel free to contact at


Code MIT licensed.