pythepeer 0.0.1

official python sdk for interacting with thepeer payment processing infrastructure

thepeer python-sdk

Thepeer's official python sdk for developers to use in their python projects.

• To start using this SDK, create an account at https://thepeer.co/ if you haven't already.
• You can then retrieve your API keys from your dashboard

Installation

To install this sdk, run the command:

pip install pythepeer

Usage

Instantiate the ThepeerInit class like so:

import thepeer
from thepeer.main import ThepeerInit

# create an instance of ThepeerInit class

thepeer_instance = ThepeerInit("YOUR_API_KEY_HERE")

Available Methods Exposed By the SDK

Note:

• For More info about the exposed methods, please refer to the general documentation
• Be sure to keep your API Credentials securely in environment variables

Indexing A User

This describes how to index a user on your account (this is usually the first step before using other methods)

test = thepeer_instance.index_user("Osagie Iyayi", "[e-mail]", "[e-mail]")

Parameters supported

Parameters	Data Type	Required	Description
name	string	true	The name of user to be indexed.
identifier	string	true	the identifier of the account(either email or username).
email	string	true	the email of the user

Validating a HMAC signature

This method validates incoming an hmac signature with the payload and credentials that was passed with it

Pro Tip: it is used to verify that an incoming webhook event/response is coming from thepeer's servers

test = thepeer_instance.validate_signature(data,signature)

Parameters supported

Parameters	Data Type	Required	Description
data	dictionary	true	the payload containing the data to be authenticated
signature	string	true	The HMAC signature

Get an Indexed User

This method gets the information of an indexed user

test = thepeer_instance.view_user("3bbb0fbf-82fa-48a0-80eb-d2c0338fe7dd")

Parameters supported

Parameters	Data Type	Required	Description
reference	string	true	the unique reference returned when the user was indexed

Get All Indexed Users

This method returns all indexed users for a specific account

test = thepeer_instance.all_users(1,15)

Parameters supported

Parameters	Data Type	Required	Description
page	integer	false	the first page displaying all the indexed users. defaults to 1
per_page	integer	false	The number of users to display per page. defaults to 15

Update an Indexed User

This methods helps to update the details of an indexed user

test = thepeer_instance.update_user(reference,**data)

Parameters supported

Parameters	Data Type	Required	Description
reference	string	true	the unique reference returned when the user was indexed
data	Any	true	A keyword argument which contains on or more of the indexed user's email, name or identifier

Sample

test = thepeer_instance.update_user("3bbb0fbf-82fa-48a0-80eb-d2c0338fe7dd", identifier="[e-mail]",
    name="Edmond Kirsch",
    email="[e-mail]")

Remove an Indexed User

This methods helps to remove the details of an indexed user from a specific account

test = thepeer_instance.delete_user("3bbb0fbf-82fa-48a0-80eb-d2c0338fe7dd")

Parameters supported

Parameters	Data Type	Required	Description
reference	string	true	the unique reference returned when the user was indexed

Get User Links

This method gets all payment links associated to an indexed user

test = thepeer_instance.get_user_links("3bbb0fbf-82fa-48a0-80eb-d2c0338fe7dd")

Parameters Required

Parameters	Data Type	Required	Description
reference	string	true	the unique reference returned when the user was indexed

Get Single Link

This method gets the payment information located in a payment link

test = thepeer_instance.get_single_link("da14a90c-61c2-4cf7-a837-e3112a2d0c3d")

Parameters Required

Parameters	Data Type	Required	Description
link_id	string	true	the unique link_id containing the payment information

Charge A Link

This method allows a business to charge a user via their linked account

test = thepeer_instance.charge_link(link_id, amount, remark, currency)

Parameters Required

Parameters	Data Type	Required	Description
link_id	string	true	the unique link_id containing the payment information
amount	integer	true	the amount of the whole transaction
remark	string	true	short detail about the transaction
currency	string	false	The denomination medium of paying (either one of NGN and USD). defaults to NGN

Authorize Direct Charge

This method allows a business to authorize a direct charge request made by a user

test = thepeer_instance.authorize_direct_charge(auth_charge_reference, event)

Parameters Required

Parameters	Data Type	Required	Description
auth_charge_reference	string	true	the reference associated to a pending charge request
event	string	true	the type of webhook event

Pro Tip: the various types of webhook events are available here

Get Transaction Detail

This method gets the details of a transaction

test = thepeer_instance.get_transaction_detail("eda58ee3-4f2c-4aa4-9da7-10a2b8ced453")

Parameters Required

Parameters	Data Type	Required	Description
transaction_id	string	true	the unique transaction identifier

Refund Transaction

This method allows a business to refund a transaction back to the user for obvious reasons

test = thepeer_instance.refund_transaction("28e52edf-16d9-4921-8a54-ef34d7029707", "possible threat actor"):

Parameters Required

Parameters	Data Type	Required	Description
transaction_id	string	true	the unique transaction identifier
reason	string	false	a short sentence explaining reasons for the refund

License

This project is MIT Licensed (MIT). Please see the License File for more information.