telr payment python
1.0.0
Este módulo é um pacote PIP para o serviço de pagamento da API da implementação da Telr. Para usar este módulo, você deve instalá -lo por comando pip ou por meio de configuração.
pip install telr_paymentImportar pacote para o seu projeto:
from telr_payment.api import TelrPara usar o módulo, considere examinar exemplos e documentações.
Para implementações fáceis, forneci dois exemplos simples, um para criar a transação e outro para verificar que é assim
# 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 )A tabela de status da transação de verificação
| Status do pedido | Descrição |
|---|---|
| 1 | Pendente |
| 2 | Autorizado (transação não capturada, como uma transação de autenticação ou uma venda transação que foi colocada em espera) |
| 3 | Pago (transação capturada, transação de venda, não colocada em espera) |
| -1 | Expirado |
| -2 | Cancelado |
| -3 | Recusou |
| Número do cartão | Tipo | Cvv | MPI |
|---|---|---|---|
| 4000 0000 0000 0002 | Visa | 123 | Não |
| 4111 1111 1111 1111 | Visa | 123 | Sim |
| 4444 3333 2222 1111 | Visa | 123 | Sim |
| 4444 4244 4444 4440 | Visa | 123 | Sim |
| 4444 4444 4444 4448 | Visa | 123 | Sim |
| 4012 8888 8888 1881 | Visa | 123 | Sim |
| 5105 1051 0510 5100 | MasterCard | 123 | Não |
| 5454 5454 5454 5454 | MasterCard | 123 | Sim |
| 5555 5555 5555 4444 | MasterCard | 123 | Sim |
| 5555 5555 5555 5557 | MasterCard | 123 | Sim |
| 5581 5822 2222 2229 | MasterCard | 123 | Sim |
| 5641 8209 0009 7002 | Maestro Reino Unido | 123 | Sim |
| 6767 0957 4000 0005 | Solo | 123 | Não |
| 3434 343434 34343 | American Express | 1234 | Não |
| 3566 0020 2014 0006 | JCB | 123 | Não |
| 3111 1111 1111 1111 | Mada | 123 | Não |
O código de segurança do cartão (CVV) para usar com os cartões de teste é 123 (exceto o American Express, que deve ser 1234) para uma resposta autorizada, outros códigos serão recusados.
Os cartões que mostram 'sim' na coluna MPI usarão uma página de autenticação segura 3D simulada, permitindo que você teste o fluxo de transações quando verificado por Visa ou MasterCard SecureCode.
{ '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' }
