telr payment python
1.0.0
Ce module est un package PIP pour implémenter le service de paiement de l'API de Telr. Afin d'utiliser ce module, vous devez l'installer par commande PIP ou par configuration.
pip install telr_paymentImportez un package dans votre projet par:
from telr_payment.api import TelrAfin d'utiliser le module, veuillez envisager d'examiner des exemples et des documents.
Pour des implémentations faciles, j'ai fourni deux exemples simples, un pour la création de la transaction et un pour la vérification, ce qui est comme ça
# order_sample.py
from telr_payment . api import Telr
from pprint import pprint
# if you dont want it to run in test mode change the test option according to docs
telr = Telr ( auth_key = "YOUR_AUTH_KEY" , store_id = "YOUR_STORE_ID" , test = 1 )
order_response = telr . order (
order_id = "ORDER_ID_TOKEN" ,
amount = 54.5 ,
return_url = "http://domain.com/path/to/url" ,
return_decl = "http://domain.com/path/to/url" ,
return_can = "http://domain.com/path/to/url" ,
description = "testing"
)
pprint ( order_response ) # check_sample.py
from telr_payment . api import Telr
from pprint import pprint
# if you dont want it to run in test mode change the test option according to docs
telr = Telr ( auth_key = "YOUR_AUTH_KEY" , store_id = "YOUR_STORE_ID" , test = 1 )
status_response = telr . status (
order_reference = "ORDER_REF_TOKEN"
)
pprint ( status_response )La table de l'état de la transaction de vérification
| Statut de commande | Description |
|---|---|
| 1 | En attente |
| 2 | Autorisé (transaction non capturée, comme une transaction Auth ou une vente transaction qui a été mise en attente) |
| 3 | Payé (transaction capturée, transaction de vente, non en attente) |
| -1 | Expiré |
| -2 | Annulé |
| -3 | Refusé |
| Numéro de carte | Taper | CVC | MPI |
|---|---|---|---|
| 4000 0000 0000 0002 | Visa | 123 | Non |
| 4111 1111 1111 1111 | Visa | 123 | Oui |
| 4444 3333 2222 1111 | Visa | 123 | Oui |
| 4444 4244 4444 4440 | Visa | 123 | Oui |
| 4444 4444 4444 4448 | Visa | 123 | Oui |
| 4012 8888 8888 1881 | Visa | 123 | Oui |
| 5105 1051 0510 5100 | MasterCard | 123 | Non |
| 5454 5454 5454 5454 | MasterCard | 123 | Oui |
| 5555 5555 5555 4444 | MasterCard | 123 | Oui |
| 5555 5555 5555 5557 | MasterCard | 123 | Oui |
| 5581 5822 2222 2229 | MasterCard | 123 | Oui |
| 5641 8209 0009 7002 | Maestro UK | 123 | Oui |
| 6767 0957 4000 0005 | Solo | 123 | Non |
| 3434 343434 34343 | American Express | 1234 | Non |
| 3566 0020 2014 0006 | JCB | 123 | Non |
| 3111 1111 1111 1111 | Mada | 123 | Non |
Le code de sécurité de la carte (CVV) à utiliser avec les cartes de test est de 123 (sauf pour American Express, qui devrait être 1234) pour une réponse autorisée, d'autres codes seront refusés.
Les cartes qui affichent «oui» dans la colonne MPI utiliseront une page d'authentification sécurisée 3D simulée, vous permettant de tester le flux de transaction lorsqu'il est vérifié par Visa ou MasterCard SecureCode est utilisé.
{ 'method' : 'create' ,
'order' : { 'ref' : 'ORDER_REF_TOKEN' ,
'url' : 'https://secure.telr.com/gateway/process.html?o=ORDER_REF_TOKEN' } ,
'trace' : 'xxxx/xxxx/xxxxxxxx' } {
"method" : "create" ,
"error" : {
"message" : "Exx: Error Name" ,
"note" : "Message according to error"
}
} { 'method' : 'check' ,
'order' : { 'amount' : '4.50' ,
'card' : { 'country' : 'AE' ,
'expiry' : { 'month' : x , 'year' : xxxx } ,
'first6' : 'xxxxxx' ,
'last4' : 'xxxx' ,
'type' : 'Visa Credit' } ,
'cartid' : 'ORDER_ID_TOKEN' ,
'currency' : 'AED' ,
'customer' : { 'address' : { 'city' : 'xxxxx' ,
'country' : 'AE' ,
'line1' : 'xxxx,xxx,xxx' ,
'mobile' : '1234567890' } ,
'email' : '[email protected]' ,
'name' : { 'forenames' : 'FIRST_NAME' , 'surname' : 'LAST_NAME' } } ,
'description' : 'testing' ,
'paymethod' : 'Card' ,
'ref' : 'ORDER_REF_TOKEN' ,
'status' : { 'code' : 3 , 'text' : 'Paid' } ,
'test' : 1 ,
'transaction' : { 'class' : 'ECom' ,
'code' : '924861' ,
'date' : '04 Aug 2022 12:56 GST' ,
'message' : 'Authorised' ,
'ref' : 'REF_TOKEN' ,
'status' : 'A' ,
'type' : 'sale' } } ,
'trace' : 'xxxx/xxxx/xxxxxxxx' } { 'method' : 'check' ,
'order' : { 'amount' : '54.50' ,
'cartid' : 'ORDER_ID_TOKEN' ,
'currency' : 'AED' ,
'description' : 'TRANSACTION_DESCRIPTION' ,
'ref' : 'ORDER_REF_TOKEN' ,
'status' : { 'code' : 1 , 'text' : 'Pending' } ,
'test' : 1 ,
'url' : 'https://secure.telr.com/gateway/process.html?o=ORDER_REF_TOKEN' } ,
'trace' : 'xxxx/xxxx/xxxxxxxx' } { 'method' : 'check' ,
'order' : { 'amount' : '54.50' ,
'cartid' : 'ORDER_ID_TOKEN' ,
'currency' : 'AED' ,
'description' : 'TRANSACTION_DESCRIPTION' ,
'ref' : 'ORDER_REF_TOKEN' ,
'status' : { 'code' : - 2 , 'text' : 'Cancelled' } ,
'test' : 1 } ,
'trace' : 'xxxx/xxxx/xxxxxxxx' }
