
Este módulo es un paquete PIP para implementar el servicio de pago de la API de Telr. Para usar este módulo, debe instalarlo por comando PIP o a través de la configuración.
pip install telr_paymentPaquete de importación en su proyecto por:
from telr_payment.api import TelrPara usar el módulo, considere mirar ejemplos y documentos.
Para implementaciones fáciles, he proporcionado dos ejemplos simples, uno para crear la transacción y otra para verificar que es así
# 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 tabla de estado de la transacción de verificación
| Estado de pedido | Descripción |
|---|---|
| 1 | Pendiente |
| 2 | Autorizado (transacción no capturada, como una transacción de autenticación o una venta transacción que se ha colocado en espera) |
| 3 | Pagado (transacción capturada, transacción de venta, no puesta en espera) |
| -1 | Venció |
| -2 | Cancelado |
| -3 | Rechazado |
| Número de tarjeta | Tipo | CVV | MPI |
|---|---|---|---|
| 4000 0000 0000 0002 | Visa | 123 | No |
| 4111 1111 1111 1111 | Visa | 123 | Sí |
| 4444 3333 2222 1111 | Visa | 123 | Sí |
| 4444 4244 4444 4440 | Visa | 123 | Sí |
| 4444 4444 4444 4448 | Visa | 123 | Sí |
| 4012 8888 8888 1881 | Visa | 123 | Sí |
| 5105 1051 0510 5100 | Tarjeta MasterCard | 123 | No |
| 5454 5454 5454 5454 | Tarjeta MasterCard | 123 | Sí |
| 5555 5555 5555 4444 | Tarjeta MasterCard | 123 | Sí |
| 5555 5555 5555 5557 | Tarjeta MasterCard | 123 | Sí |
| 5581 5822 2222 2229 | Tarjeta MasterCard | 123 | Sí |
| 5641 8209 0009 7002 | Maestro UK | 123 | Sí |
| 6767 0957 4000 0005 | Solo | 123 | No |
| 3434 343434 34343 | tarjeta American Express | 1234 | No |
| 3566 0020 2014 0006 | JCB | 123 | No |
| 311111111111 1111 | Mada | 123 | No |
El código de seguridad de la tarjeta (CVV) para usar con las tarjetas de prueba es 123 (excepto American Express, que debería ser 1234) para una respuesta autorizada, se rechazarán otros códigos.
Las tarjetas que muestran 'sí' en la columna MPI utilizarán una página de autenticación segura 3D simulada, lo que le permitirá probar el flujo de transacciones cuando se verifica por Visa o 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' }