telr payment python
1.0.0
Modul ini adalah paket PIP untuk mengimplementasikan layanan pembayaran API dari Telr. Untuk menggunakan modul ini, Anda harus menginstalnya dengan perintah PIP atau melalui pengaturan.
pip install telr_paymentImpor paket ke proyek Anda oleh:
from telr_payment.api import TelrUntuk menggunakan modul, harap pertimbangkan untuk melihat contoh dan dokumentasi.
Untuk implementasi yang mudah saya telah memberikan dua contoh sederhana, satu untuk membuat transaksi dan satu untuk memeriksa yang seperti ini
# 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 )Tabel Status Pemeriksaan Transaksi
| Status pesanan | Keterangan |
|---|---|
| 1 | Tertunda |
| 2 | Resmi (transaksi tidak ditangkap, seperti transaksi auth atau penjualan transaksi yang telah ditahan) |
| 3 | Berbayar (transaksi ditangkap, transaksi penjualan, tidak ditahan) |
| -1 | Kedaluwarsa |
| -2 | Dibatalkan |
| -3 | Ditolak |
| Nomor kartu | Jenis | CVV | MPI |
|---|---|---|---|
| 4000 0000 0000 0002 | Visa | 123 | TIDAK |
| 4111 1111 1111 1111 | Visa | 123 | Ya |
| 4444 3333 2222 1111 | Visa | 123 | Ya |
| 4444 4244 4444 4440 | Visa | 123 | Ya |
| 4444 4444 4444 4448 | Visa | 123 | Ya |
| 4012 8888 8888 1881 | Visa | 123 | Ya |
| 5105 1051 0510 5100 | MasterCard | 123 | TIDAK |
| 5454 5454 5454 5454 | MasterCard | 123 | Ya |
| 5555 5555 5555 4444 | MasterCard | 123 | Ya |
| 5555 5555 5555 5557 | MasterCard | 123 | Ya |
| 5581 5822 2222 2229 | MasterCard | 123 | Ya |
| 5641 8209 0009 7002 | Maestro UK | 123 | Ya |
| 6767 0957 4000 0005 | Solo | 123 | TIDAK |
| 3434 343434 34343 | American Express | 1234 | TIDAK |
| 3566 0020 2014 0006 | JCB | 123 | TIDAK |
| 3111 1111 1111 1111 | Mada | 123 | TIDAK |
Kode Keamanan Kartu (CVV) untuk digunakan dengan kartu uji adalah 123 (kecuali untuk American Express, yang seharusnya 1234) untuk respons resmi, kode lain akan ditolak.
Kartu yang menunjukkan 'ya' di kolom MPI akan menggunakan halaman otentikasi aman 3D simulasi, yang memungkinkan Anda untuk menguji aliran transaksi ketika diverifikasi dengan visa atau mastercard securecode digunakan.
{ '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' }
