
Dieses Modul ist ein PIP -Paket zum Implementieren von API -Zahlungsdienst von Telr. Um dieses Modul zu verwenden, müssen Sie es per PIP -Befehl oder per Setup installieren.
pip install telr_paymentPaket in Ihr Projekt importieren von:
from telr_payment.api import TelrUm das Modul zu verwenden, sollten Sie sich die Beispiele und Dokumentationen ansehen.
Für einfache Implementierungen habe ich zwei einfache Beispiele geliefert, eine zum Erstellen der Transaktion und eine zum Überprüfen, was so ist
# 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 )Die Tabelle des Status der Überprüfung der Transaktion
| Bestellstatus | Beschreibung |
|---|---|
| 1 | Ausstehend |
| 2 | Autorisiert (Transaktion nicht erbeutet, z. B. eine Auth -Transaktion oder ein Verkauf Transaktion, die auf Eis gelegt wurde) |
| 3 | Bezahlt (Transaktion erfasst, Verkaufstransaktion, nicht in die Warteschleife) |
| -1 | Abgelaufen |
| -2 | Abgesagt |
| -3 | Abgelehnt |
| Kartennummer | Typ | CVV | Mpi |
|---|---|---|---|
| 4000 0000 0000 0002 | Visum | 123 | NEIN |
| 4111 1111 1111 1111 | Visum | 123 | Ja |
| 4444 3333 2222 1111 | Visum | 123 | Ja |
| 4444 4244 4444 4440 | Visum | 123 | Ja |
| 4444 4444 4444 4448 | Visum | 123 | Ja |
| 4012 8888 8888 1881 | Visum | 123 | Ja |
| 5105 1051 0510 5100 | MasterCard | 123 | NEIN |
| 5454 5454 5454 5454 | MasterCard | 123 | Ja |
| 5555 5555 5555 4444 | MasterCard | 123 | Ja |
| 5555 5555 5555 5557 | MasterCard | 123 | Ja |
| 5581 5822 2222 2229 | MasterCard | 123 | Ja |
| 5641 8209 0009 7002 | Maestro UK | 123 | Ja |
| 6767 0957 4000 0005 | Solo | 123 | NEIN |
| 3434 343434 34343 | American Express | 1234 | NEIN |
| 3566 0020 2014 0006 | JCB | 123 | NEIN |
| 3111 1111 1111 1111 | Mada | 123 | NEIN |
Der Card Security Code (CVV), der mit den Testkarten verwendet werden soll, beträgt 123 (mit Ausnahme von American Express, die 1234) für eine autorisierte Antwort werden, andere Codes werden abgelehnt.
Karten, die in der MPI -Spalte "Ja" anzeigen, verwenden eine simulierte 3D -Secure -Authentifizierungsseite, mit der Sie den Transaktionsfluss testen können, wenn sie durch Visa oder MasterCard Securse verwendet werden.
{ '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' }