Todito Cash is a pre-paid card in Mexico that works as an alternative payment method to buy goods, content and services online and offline.
API Url
Environment | Url | Method | Version |
---|---|---|---|
Production | https://api.payxpert.com/transaction/sale/todito | POST | >= 0200 |
Todito Sale Request
Field | Type | Max Length | Requirement | Description | Version |
---|---|---|---|---|---|
customerIP | IP | 40 | M | Customer request IP | |
amount | N | 10 | M | Number in minor unit, e.g. cents; 100 dollar cent equals to 1 dollar | |
currency | C | 3 | M | ISO-4217 currency codes | |
orderID | S | 100 | M | Unique reference to current transaction request | |
Payment type fields (todito card) | |||||
Field | Type | Max Length | Requirement | Description | Version |
cardNumber | S | 40 | M | Todito card number | |
cardNIP | D | 4 | M | Todito Pin number | |
Optional Shopper fields | |||||
Field | Type | Max Length | Requirement | Description | Version |
shopperName | S | 35 | M | Use ‘NA’ if unavailable | |
shopperAddress | S | 255 | M | Use ‘NA’ if unavailable | |
shopperZipcode | S | 10 | M | Use ‘NA’ if unavailable | |
shopperCity | S | 50 | M | Use ‘NA’ if unavailable | |
shopperState | C | 30 | M | ISO 3166-2 country subdivision codes if exist; 2 letters in USA, 3 letters in Australia, etc. Use ‘NA’ if unavailable | |
shopperCountryCode | C | 2 | M | ISO-3166-1 country codes. Use “ZZ” if the country is unknown | |
shopperPhone | S | 20 | M | Use ‘NA’ if unavailable | |
shopperEmail | E | 100 | M | Use ‘NA’ if unavailable | |
Optional e-commerce fields | |||||
Field | Type | Max Length | Requirement | Description | Version |
orderAmount | N | 10 | O | Number in minor unit, e.g. cents; 100 dollar cent equals to 1 dollar | |
productID | S | 32 | O | ||
comment | S | 255 | O | Merchant comments | |
shipToName | S | 80 | R | Name of shipping address | |
shipToAddress | S | 255 | R | Address of shipping address | |
shipToZipcode | S | 10 | R | Zip code of shipping address | |
shipToCity | S | 50 | R | City of shipping address | |
shipToState | C | 30 | R | ISO 3166-2 country subdivision codes if exist; 2 letters in USA, 3 letters in Australia, etc | |
shipToCountryCode | C | 2 | R | ISO-3166-1 country codes. | |
shipToPhone | S | 20 | R | Phone of shipping address | |
orderDescription | S | 500 | R | Order description | |
Optional affiliate fields | |||||
Field | Type | Max Length | Requirement | Description | Version |
affiliateID | D | 16 | R | This is the affiliate id from your affiliate program. This variable help you and the Risk Management team to manage the transactions coming from your affiliates. | |
campaignName | S | 128 | O | Affiliate campaign name | |
Optional fraud fields | |||||
Field | Type | Max Length | Requirement | Description | Version |
threatmetrixSession | S | 100 | R | Threatmetrix session id generated on the payment page |
Todito Sale Response
Field | Type | Max Length | Requirement | Description | Version |
---|---|---|---|---|---|
transactionID | N | 20 | M | Transaction reference returned by the system | |
errorCode | D | 3 | M | See Messages and error codes | |
errorMessage | S | 100 | M | See Messages and error codes |
PHP Gateway Client
Transaction name : ToditoSale
PHP Methods
Method name | Requirement |
---|---|
setTransactionInformation | M |
setToditoCardInformation | M |
setShopperInformation | M |
setOrder | O |
setShippingAddress | O |
setAffiliate | O |
PHP Example
<?php
$client = new GatewayClient();
$transaction = $client->newTransaction('ToditoSale', 'testMerchant', 'testPassword');
$transaction->setTransactionInformation(2000, 'MXN', 'order1456', '10.10.254.10');
$transaction->setToditoCardInformation('1111111111', '0000');
$transaction->setShopperInformation('John Smith', '334 Some Drive', '90001', 'Los Angeles', 'CA', 'US', '+1 213-XXX-XXXX', 'test@mail.com');
$response = $transaction->send();
if ('000' === $response->errorCode) {
$transactionID = $response->transactionID;
} else {
echo "Error {$response->errorCode} with message {$response->errorMessage}";
}
?>
Java Gateway Client
Java Methods
Connector method | doToditoSaleTransaction |
---|---|
Request class | ToditoSaleRequest |
Response class | ToditoSaleResponse |
Java Examples
PaymentGatewayConnector connector = new PaymentGatewayConnector(API_URL, ORIGINATOR, PASSWORD);
ToditoSaleResponse response = null;
ToditoSaleRequest request = new ToditoSaleRequest();
request.setOrderId("order1456");
request.setCustomerIP("10.10.254.10");
request.setAmount(2000).setCurrency("MXN");
request.setShopperName("John Smith").setShopperAddress("334 Some Drive");
request.setShopperZipcode("90001").setShopperCity("Los Angeles").setShopperState("CA").setShopperCountryCode("US");
request.setShopperPhone("+1 213-XXX-XXXX");
request.setShopperEmail("test@mail.com");
request.setCardNumber("1111111111").setCardNIP("0000");
try {
response = connector.doToditoSaleTransaction(request);
} catch (Exception e) {
e.printStackTrace();
}
if (response != null) {
if (TransactionResultCode.TRANSACTION_SUCCESSFULLY.equals(response.getErrorCode()) {
System.out.println("Success: " + response.getErrorMessage());
} else {
System.out.println("Failure: " + response.getErrorMessage());
}
}