Telebirr

This is a python helper package for Telebirr H5 Web payment integration helper. The use case for this interface is payment via web. Third party system will invoke the interface upon payment issue by the customer and a redirect page will be return to the third party system from telebirr platform.

Logical specification

![alt text](img/logical design.png "Logical spacification")

Platform Authentication Rule

  1. Telebirr platform allocate appId and appKey to the corresponding third party client. Each third party will have a unique appId and appKey.
  2. Third party source IP addresses should be added on the trust list. Those IP addresses of clients that are not in the trust list will not access telebirr system.
  3. The time of the timestamp is consistent with that of the server (within one minute). If they are inconsistent, the access is considered illegal.
  4. Check whether the signature entered by the client is consistent with the signature generated by the system. If they are inconsistent, the access is considered illegal.

Interface Description

Parameter Data Type Mandatory or Optional Description Example
appId String M Indicates the appID provided from telebirr platform. It uniquely identify the third party. ce83aaa3dedd42 ab88bd017ce1ca
appKey String M Indicates the appKey provided by telebirr platform a8955b02b5df475882038616d5448d43
nonce String M Indicates a unique random string generated by third party system. The value of nonce for each request should be unique. ER33419df678o8bb
notifyUrl String O Indicates the end point URL from third party which will be used by telebirr platform to respond the Payment result. Telebirr platform uses this third party end point to proactively notify third party server for payment request result. If this parameter is empty, payment result notification will not be sent. https://mmpay.trade.pay/notifyUrl/
outTradeNo String M Indicates the third party payment transaction order number that will be generated by third party system and it shall be unique. Supported contents for outTradeNo parameter value is digits, letters, and underscores. T0533111222S001114129
returnUrl String M Indicates third party redirect page URL after the payment completed. https://mmpay.trade.pay/T0533111222S001114129
shortCode String M Indicates third party Short Code provided from telebirr. 8000001
subject String M Indicates the item or any other name for the payment that is being issued by the customer.
Note: Special characters such as /, =, & are not allowed. Book
timeoutExpress String M Indicates the payment Order request timeout from third party, which indicates the time for payment process to be ended. After this time the payment will not be processed and third party system can reinitiate again. Note: the parameter value unit is Minutes 30
timestamp String M Indicates the time stamp on the request message. The timestamp should be in milliseconds. Python code：str(int(datetime.datetime.now().timestamp() * 1000)) Note: Use unix timestamp 1624546517701
totalAmount String M Indicates the order amount in ETB. The value ranges from 0.01 to 100000000.00 and is accurate to two decimal places. Note: The value will be authenticated by telebirr platform depending on the limit rule assigned to the customer. For instance, if the allowed daily limit transaction for a customer is 10,000 ETB then those transactions against this rule will be failed. 9.00
receiveName String O Indicates the transaction receiver name. Ethiopian airlines

Interface Description

Response message element is described below

Parameter Data Type Mandatory or Optional Description Example
code String M Indicates the Status Code for payment request 0
msg String M Indicates the Status Code Description for payment request success
data Object M Indicates the Data Object that consists the toPayURL
toPayUrl String M Indicates telebirr payment landing page URL to redirect the customer to H5 Web Payment. https://h5pay.trade.pay/payId=RE9879T0972S

Getting started

pip install telebirr

from telebirr import Telebirr
private_key = "YOUR PUBLIC KEY FORM TELEBIRR ADMIN"
telebirr = Telebirr(
    app_id="YOUR APP ID FROM TELEBIRR ADMIN",
    app_key="YOUR APP KEY FROM TELEBIRR ADMIN",
    public_key=private_key,
    notify_url="https://example.com/telebirr/121232",
    receive_name="Your company name",
    return_url="https://example.com/",
    short_code="SHORT CODE FROM TELEBIRR ADMIN",
    subject="Test",
    timeout_express="30",
    total_amount="10",
    nonce="UNIQUE",
    out_trade_no="UNIQUE"
)
response = telebirr.send_request()

Decryption

After the payment is successfully completed telebirr will send you notification through the notification url you have set on payment request. Here is how you can decrypt the payload coming from telebirr.

from telebirr import Telebirr
public_key = "YOUR PUBLIC KEY FORM TELEBIRR ADMIN"
payload = "Payload coming from telebirr" // If you are using django it means request.body

decrypted_data = Telebirr.decrypt(public_key=public_key, payload=payload)
// Do what every you need to do with your data eg: update your order status

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for eba-alemayehu from gravatar.com eba-alemayehu

Credits

Author: Eba Alemayehu

Tags

python telebirr payment ethiopia ethio telecom

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

telebirr-0.26.1.tar.gz (9.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

telebirr-0.26.1-py3-none-any.whl (7.9 kB view details)

Uploaded Python 3

File details

Details for the file telebirr-0.26.1.tar.gz.

File metadata

  • Download URL: telebirr-0.26.1.tar.gz
  • Upload date:
  • Size: 9.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for telebirr-0.26.1.tar.gz
Algorithm Hash digest
SHA256 2cc0bc0fbec7b607213bf6492a3aa456e934feeb613849127536dd9509a43cec
MD5 f3e5a4f8e582ee1bbe9afe93127cf4ed
BLAKE2b-256 a24102aa9c7c1a626183c0dbd97e11ba60ab2a2f1f9d44d0e57183807acde437

See more details on using hashes here.

File details

Details for the file telebirr-0.26.1-py3-none-any.whl.

File metadata

  • Download URL: telebirr-0.26.1-py3-none-any.whl
  • Upload date:
  • Size: 7.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for telebirr-0.26.1-py3-none-any.whl
Algorithm Hash digest
SHA256 709d59d4a22965b41597042bd8ee2b6ed76c8eae1ee5fe1a9c086207d94285d7
MD5 68b1b6702809db68aa19259ce82ccd77
BLAKE2b-256 f4ea84e68ac049aedd8a1360f873e74b29b3b1506448ca9b03fbbff84d3da141

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.26.1 This release

2 files

0.26

2 files

0.2.8

2 files

0.2.7

2 files

0.2.5

2 files

0.2.4

2 files

0.2.2

2 files

0.2.1

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

0.0.7

2 files

0.0.6

2 files

0.0.4

2 files

0.0.3

1 file

0.0.2

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page