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:
Newer release available (0.26.1)

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.2.4.tar.gz (9.4 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.2.4-py3-none-any.whl (7.6 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for telebirr-0.2.4.tar.gz
Algorithm Hash digest
SHA256 4a68d3b8bbbfe0bc759b942643062419afe278bee7c34922a9455b70f45c3f2b
MD5 1c3062b4441e23c524c9e04668fdc0d3
BLAKE2b-256 1f2c169856ce497d1dcc333c3d8837350d6d0acff95782f671daa71be9c538fb

See more details on using hashes here.

File details

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

File metadata

  • Download URL: telebirr-0.2.4-py3-none-any.whl
  • Upload date:
  • Size: 7.6 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.2.4-py3-none-any.whl
Algorithm Hash digest
SHA256 42f9a1993b363aeb0f3289fdba005bb6aafcddcf40dc3602d7d8dd2aaadf414d
MD5 fb0d406b18daa007ef4896c214e80b66
BLAKE2b-256 3f18777c74a18d372f7b6e81d108b6b14b3ae129a21a5c9e687490095adbfa64

See more details on using hashes here.

Release history Release notifications | RSS feed

0.26.1

2 files

0.26

2 files

0.2.8

2 files

0.2.7

2 files

0.2.5

2 files

This release

0.2.4 This release

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