Payments SDK - Chile
To integrate with Payments SDK Chile, target the requests to the following URLs:
// URL for test: https://sandbox.api.payulatam.com/payments-api/
PayU.paymentsUrl = “https://api.payulatam.com/payments-api/”;
// URL for test: https://sandbox.api.payulatam.com/reports-api/
PayU.reportsUrl = “https://api.payulatam.com/reports-api/”;
// URL for test: https://sandbox.api.payulatam.com/payments-api/4.0/service.cgi
Environment::setPaymentsCustomUrl(“https://api.payulatam.com/payments-api/4.0/service.cgi”);
// URL for test: https://sandbox.api.payulatam.com/reports-api/4.0/service.cgi
Environment::setReportsCustomUrl(“https://api.payulatam.com/reports-api/4.0/service.cgi”);
Available methods
Payments SDK includes the following methods:
Note
To confirm the status of a transaction, you can use the Queries SDK.Submit transaction with credit, debit or prepaid cards
This method lets you process the payments performed by your customers using credit, debit or prepaid cards. For Chile, you can perform the two-step flows (Authorization, Capture), and one-step flows (Charge). For more information, refer to Payment flows.
Note
Transactions with credit card using two-step flows are available under demand. Contact your Sales representative for more information.Considerations
- Send a valid Credit card Payment Method in the request, see the available Payment Methods for Chile.
- For payments with credit card tokens, set the parameters
TOKEN_ID
andCREDIT_CARD_SECURITY_CODE
(if you process with security code) replacing the information of the credit card. For more information, refer to Tokenization SDK. - Transactions in CHILEAN PESOS with decimal amounts are not allowed.
- Transactions with credit card using two-step flows are available under demand and for single installment payments. Contact your Sales representative for more information.
- By default, processing credit cards without security code is not enabled. If you want to enable this feature, contact your Sales representative. After this feature is enabled for you, set the parameter
PROCESS_WITHOUT_CVV2
as true and remove the parameterCREDIT_CARD_SECURITY_CODE
.
Authorization
Use this method to perform the Authorization step of a two-step flow. In this step, you authorize the payment but the amount is not debited until you capture the funds.
The following examples show how to call the method for this transaction type according to the programming language.
String reference = "payment_test_00000001";
String value= "1000";
Map<String, String> parameters = new HashMap<String, String>();
// Enter the account’s identifier here.
parameters.put(PayU.PARAMETERS.ACCOUNT_ID, "512325");
// Enter the reference code here.
parameters.put(PayU.PARAMETERS.REFERENCE_CODE, ""+reference);
// Enter the description here.
parameters.put(PayU.PARAMETERS.DESCRIPTION, "payment test");
// Enter the transaction language here.
parameters.put(PayU.PARAMETERS.LANGUAGE, "Language.es");
// -- Values --
// Enter the value here.
parameters.put(PayU.PARAMETERS.VALUE, ""+value);
// Enter the currency here.
parameters.put(PayU.PARAMETERS.CURRENCY, ""+Currency.CLP.name());
// -- Buyer --
// Enter the buyer Id here.
parameters.put(PayU.PARAMETERS.BUYER_ID, "1");
// Enter the buyer's name here.
parameters.put(PayU.PARAMETERS.BUYER_NAME, "First name and second buyer name");
// Enter the buyer's e-mail here
parameters.put(PayU.PARAMETERS.BUYER_EMAIL, "buyer_test@test.com");
// Enter the buyer's contact phone here.
parameters.put(PayU.PARAMETERS.BUYER_CONTACT_PHONE, "7563126");
// Enter the buyer's contact document here.
parameters.put(PayU.PARAMETERS.BUYER_DNI, "123456789");
// Enter the buyer's address here.
parameters.put(PayU.PARAMETERS.BUYER_STREET, "Autopista Del Sol, 0 - Km.43 Costado Sur");
parameters.put(PayU.PARAMETERS.BUYER_STREET_2, "5555487");
parameters.put(PayU.PARAMETERS.BUYER_CITY, "RM");
parameters.put(PayU.PARAMETERS.BUYER_STATE, "Talagante");
parameters.put(PayU.PARAMETERS.BUYER_COUNTRY, "CL");
parameters.put(PayU.PARAMETERS.BUYER_POSTAL_CODE, "000000");
parameters.put(PayU.PARAMETERS.BUYER_PHONE, "7563126");
// -- Payer --
// Enter the payer's ID here.
parameters.put(PayU.PARAMETERS.PAYER_ID, "1");
// Enter the payer's name here.
parameters.put(PayU.PARAMETERS.PAYER_NAME, "First name and second payer name");
// Enter the payer's e-mail here.
parameters.put(PayU.PARAMETERS.PAYER_EMAIL, "payer_test@test.com");
// Enter the payer's contact phone here.
parameters.put(PayU.PARAMETERS.PAYER_CONTACT_PHONE, "7563126");
// Enter the payer's contact document here.
parameters.put(PayU.PARAMETERS.PAYER_DNI, "5415668464654");
// Enter the payer's address here.
parameters.put(PayU.PARAMETERS.PAYER_STREET, "Autopista Del Sol, 0 - Km.43 Costado Sur");
parameters.put(PayU.PARAMETERS.PAYER_STREET_2, "5555487");
parameters.put(PayU.PARAMETERS.PAYER_CITY, "RM");
parameters.put(PayU.PARAMETERS.PAYER_STATE, "Talagante");
parameters.put(PayU.PARAMETERS.PAYER_COUNTRY, "CL");
parameters.put(PayU.PARAMETERS.PAYER_POSTAL_CODE, "000000");
parameters.put(PayU.PARAMETERS.PAYER_PHONE, "7563126");
// -- Credit card data --
// Enter the number of the credit card here
parameters.put(PayU.PARAMETERS.CREDIT_CARD_NUMBER, "4097440000000004");
// Enter expiration date of the credit card here
parameters.put(PayU.PARAMETERS.CREDIT_CARD_EXPIRATION_DATE, "2022/12");
// Enter the security code of the credit card here
parameters.put(PayU.PARAMETERS.CREDIT_CARD_SECURITY_CODE, "777");
// Enter the name of the credit card here
parameters.put(PayU.PARAMETERS.PAYMENT_METHOD, "VISA");
// Enter the number of installments here.
parameters.put(PayU.PARAMETERS.INSTALLMENTS_NUMBER, "1");
// Enter the name of the country here.
parameters.put(PayU.PARAMETERS.COUNTRY, PaymentCountry.CL.name());
// Device Session ID
parameters.put(PayU.PARAMETERS.DEVICE_SESSION_ID, "vghs6tvkcle931686k1900o6e1");
// Payer IP
parameters.put(PayU.PARAMETERS.IP_ADDRESS, "127.0.0.1");
// Cookie of the current session.
parameters.put(PayU.PARAMETERS.COOKIE, "pt1t38347bs6jc9ruv2ecpv7o2");
// User agent of the current session.
parameters.put(PayU.PARAMETERS.USER_AGENT, "Mozilla/5.0 (Windows NT 5.1; rv:18.0) Gecko/20100101 Firefox/18.0");
// Authorization request
TransactionResponse response = PayUPayments.doAuthorization(parameters);
// You can obtain the properties in the response
if(response != null){
response.getOrderId();
response.getTransactionId();
response.getState();
if(response.getState().toString().equalsIgnoreCase("PENDING")){
response.getPendingReason();
}
response.getPaymentNetworkResponseCode();
response.getPaymentNetworkResponseErrorMessage();
response.getTrazabilityCode();
response.getResponseCode();
response.getResponseMessage();
}
$reference = "payment_test_00000001";
$value = "1000";
$parameters = array(
// Enter the account’s identifier here
PayUParameters::ACCOUNT_ID => "512325",
// Enter the reference code here.
PayUParameters::REFERENCE_CODE => $reference,
// Enter the description here.
PayUParameters::DESCRIPTION => "payment test",
// -- Values --
// Enter the value here.
PayUParameters::VALUE => $value,
// Enter the currency here.
PayUParameters::CURRENCY => "CLP",
// -- Buyer --
// Enter the buyer Id here.
PayUParameters::BUYER_ID => "1",
// Enter the buyer's name here.
PayUParameters::BUYER_NAME => "First name and second buyer name",
// Enter the buyer's e-mail here.
PayUParameters::BUYER_EMAIL => "buyer_test@test.com",
// Enter the buyer's contact phone here.
PayUParameters::BUYER_CONTACT_PHONE => "7563126",
// Enter the buyer's contact document here.
PayUParameters::BUYER_DNI => "5415668464654",
// Enter the buyer's address here.
PayUParameters::BUYER_STREET => "Autopista Del Sol, 0 - Km.43 Costado Sur",
PayUParameters::BUYER_STREET_2 => "5555487",
PayUParameters::BUYER_CITY => "RM",
PayUParameters::BUYER_STATE => "Talagante",
PayUParameters::BUYER_COUNTRY => "CL",
PayUParameters::BUYER_POSTAL_CODE => "000000",
PayUParameters::BUYER_PHONE => "7563126",
// -- Payer --
// Enter the payer's ID here.
PayUParameters::PARAMETERS.PAYER_ID => "1",
/// Enter the payer's name here
PayUParameters::PAYER_NAME => "First name and second payer name",
// Enter the payer's e-mail here
PayUParameters::PAYER_EMAIL => "payer_test@test.com",
// Enter the payer's contact phone here.
PayUParameters::PAYER_CONTACT_PHONE => "7563126",
// Enter the payer's contact document here.
PayUParameters::PAYER_DNI => "5415668464654",
// Enter the payer's address here.
PayUParameters::PAYER_STREET => "Autopista Del Sol, 0 - Km.43 Costado Sur",
PayUParameters::PAYER_STREET_2 => "5555487",
PayUParameters::PAYER_CITY => "RM",
PayUParameters::PAYER_STATE => "Talagante",
PayUParameters::PAYER_COUNTRY => "CL",
PayUParameters::PAYER_POSTAL_CODE => "000000",
PayUParameters::PAYER_PHONE => "7563126",
// -- Credit card data --
// Enter the number of the credit card here
PayUParameters::CREDIT_CARD_NUMBER => "4097440000000004",
// Enter expiration date of the credit card here
PayUParameters::CREDIT_CARD_EXPIRATION_DATE => "2022/12",
// Enter the security code of the credit card here
PayUParameters::CREDIT_CARD_SECURITY_CODE=> "777",
// Enter the name of the credit card here
PayUParameters::PAYMENT_METHOD => "VISA",
// Enter the number of installments here.
PayUParameters::INSTALLMENTS_NUMBER => "1",
// Enter the name of the country here.
PayUParameters::COUNTRY => PayUCountries::CL,
// Device Session ID
PayUParameters::DEVICE_SESSION_ID => "vghs6tvkcle931686k1900o6e1",
// Payer IP
PayUParameters::IP_ADDRESS => "127.0.0.1",
// Cookie of the current session
PayUParameters::PAYER_COOKIE=>"pt1t38347bs6jc9ruv2ecpv7o2",
// User agent of the current session
PayUParameters::USER_AGENT=>"Mozilla/5.0 (Windows NT 5.1; rv:18.0) Gecko/20100101 Firefox/18.0"
);
// Authorization request
$response = PayUPayments::doAuthorization($parameters);
// You can obtain the properties in the response
if ($response) {
$response->transactionResponse->orderId;
$response->transactionResponse->transactionId;
$response->transactionResponse->state;
if ($response->transactionResponse->state=="PENDING"){
$response->transactionResponse->pendingReason;
}
$response->transactionResponse->paymentNetworkResponseCode;
$response->transactionResponse->paymentNetworkResponseErrorMessage;
$response->transactionResponse->trazabilityCode;
$response->transactionResponse->responseCode;
$response->transactionResponse->responseMessage;
}
Capture
Use this method to perform the Capture step of a two-step flow. In this step, you capture the funds previously Authorized to transfer them to your PayU account.
Considerations
Take into account the following considerations for capture.
- The maximum time to capture an approved transaction is 7 days. After this time, the transaction is auto-voided.
- Only the parameters displayed in the request body are mandatory to invoke a Capture transaction. Recall that the order and transaction ids must meet with a currently authorized transaction.
- Captures are only allowed for transactions in one installment.
The following examples show how to call the method for this transaction type according to the programming language.
Map<String, String> parameters = new HashMap<String, String>();
// Enter the order identifier here.
parameters.put(PayU.PARAMETERS.ORDER_ID, "1400468293");
// Enter the transaction identifier here.
parameters.put(PayU.PARAMETERS.TRANSACTION_ID, "ad6940f1-cf8b-474a-a69d-00382084d16c");
// Enter the transaction language here.
parameters.put(PayU.PARAMETERS.LANGUAGE, "Language.es");
// Capture Request
TransactionResponse response = PayUPayments.doCapture(parameters);
// Response
if(response != null){
response.getOrderId();
response.getTransactionId();
response.getState();
response.getPaymentNetworkResponseCode();
response.getPaymentNetworkResponseErrorMessage();
response.getTrazabilityCode();
response.getResponseCode();
response.getResponseMessage();
}
$parameters = array(
// Enter the account’s identifier here.
PayUParameters::ACCOUNT_ID => "512327",
// Enter the order identifier here.
PayUParameters::ORDER_ID => "1400468293",
// Enter the transaction identifier here.
PayUParameters::TRANSACTION_ID => "ad6940f1-cf8b-474a-a69d-00382084d16c",
);
$response = PayUPayments::doCapture($parameters);
if ($response) {
$response->transactionResponse->orderId;
$response->transactionResponse->transactionId;
$response->transactionResponse->state;
$response->transactionResponse->paymentNetworkResponseCode;
$response->transactionResponse->paymentNetworkResponseErrorMessage;
$response->transactionResponse->trazabilityCode;
$response->transactionResponse->responseCode;
$response->transactionResponse->responseMessage;
}
Charge
Use this method to perform a one-step flow, namely a charge. In this step, both steps of the two-step flow are combined in a single transaction and the funds are transferred from the customers account to your PayU account once they have been approved:
The following examples show how to call the method for this transaction type according to the programming language.
String reference = "payment_test_00000001";
String value= "1000";
Map<String, String> parameters = new HashMap<String, String>();
// Enter the account’s identifier here.
parameters.put(PayU.PARAMETERS.ACCOUNT_ID, "512325");
// Enter the reference code here.
parameters.put(PayU.PARAMETERS.REFERENCE_CODE, ""+reference);
// Enter the description here.
parameters.put(PayU.PARAMETERS.DESCRIPTION, "payment test");
// Enter the transaction language here.
parameters.put(PayU.PARAMETERS.LANGUAGE, "Language.es");
// -- Values --
// Enter the value here.
parameters.put(PayU.PARAMETERS.VALUE, ""+value);
// Enter the currency here.
parameters.put(PayU.PARAMETERS.CURRENCY, ""+Currency.CLP.name());
// -- Buyer --
// Enter the buyer Id here.
parameters.put(PayU.PARAMETERS.BUYER_ID, "1");
// Enter the buyer's name here.
parameters.put(PayU.PARAMETERS.BUYER_NAME, "First name and second buyer name");
// Enter the buyer's e-mail here
parameters.put(PayU.PARAMETERS.BUYER_EMAIL, "buyer_test@test.com");
// Enter the buyer's contact phone here.
parameters.put(PayU.PARAMETERS.BUYER_CONTACT_PHONE, "7563126");
// Enter the buyer's contact document here.
parameters.put(PayU.PARAMETERS.BUYER_DNI, "123456789");
// Enter the buyer's address here.
parameters.put(PayU.PARAMETERS.BUYER_STREET, "Autopista Del Sol, 0 - Km.43 Costado Sur");
parameters.put(PayU.PARAMETERS.BUYER_STREET_2, "5555487");
parameters.put(PayU.PARAMETERS.BUYER_CITY, "RM");
parameters.put(PayU.PARAMETERS.BUYER_STATE, "Talagante");
parameters.put(PayU.PARAMETERS.BUYER_COUNTRY, "CL");
parameters.put(PayU.PARAMETERS.BUYER_POSTAL_CODE, "000000");
parameters.put(PayU.PARAMETERS.BUYER_PHONE, "7563126");
// -- Payer --
// Enter the payer's ID here.
parameters.put(PayU.PARAMETERS.PAYER_ID, "1");
// Enter the payer's name here.
parameters.put(PayU.PARAMETERS.PAYER_NAME, "First name and second payer name");
// Enter the payer's e-mail here.
parameters.put(PayU.PARAMETERS.PAYER_EMAIL, "payer_test@test.com");
// Enter the payer's contact phone here.
parameters.put(PayU.PARAMETERS.PAYER_CONTACT_PHONE, "7563126");
// Enter the payer's contact document here.
parameters.put(PayU.PARAMETERS.PAYER_DNI, "5415668464654");
// Enter the payer's address here.
parameters.put(PayU.PARAMETERS.PAYER_STREET, "Autopista Del Sol, 0 - Km.43 Costado Sur");
parameters.put(PayU.PARAMETERS.PAYER_STREET_2, "5555487");
parameters.put(PayU.PARAMETERS.PAYER_CITY, "RM");
parameters.put(PayU.PARAMETERS.PAYER_STATE, "Talagante");
parameters.put(PayU.PARAMETERS.PAYER_COUNTRY, "CL");
parameters.put(PayU.PARAMETERS.PAYER_POSTAL_CODE, "000000");
parameters.put(PayU.PARAMETERS.PAYER_PHONE, "7563126");
// -- Credit card data --
// Enter the number of the credit card here
parameters.put(PayU.PARAMETERS.CREDIT_CARD_NUMBER, "4037997623271984");
// Enter expiration date of the credit card here
parameters.put(PayU.PARAMETERS.CREDIT_CARD_EXPIRATION_DATE, "2030/12");
// Enter the security code of the credit card here
parameters.put(PayU.PARAMETERS.CREDIT_CARD_SECURITY_CODE, "321");
// Enter the name of the credit card here
parameters.put(PayU.PARAMETERS.PAYMENT_METHOD, "VISA");
// Enter the number of installments here.
parameters.put(PayU.PARAMETERS.INSTALLMENTS_NUMBER, "1");
// Enter the name of the country here.
parameters.put(PayU.PARAMETERS.COUNTRY, PaymentCountry.CL.name());
// Device Session ID
parameters.put(PayU.PARAMETERS.DEVICE_SESSION_ID, "vghs6tvkcle931686k1900o6e1");
// Payer IP
parameters.put(PayU.PARAMETERS.IP_ADDRESS, "127.0.0.1");
// Cookie of the current session.
parameters.put(PayU.PARAMETERS.COOKIE, "pt1t38347bs6jc9ruv2ecpv7o2");
// User agent of the current session.
parameters.put(PayU.PARAMETERS.USER_AGENT, "Mozilla/5.0 (Windows NT 5.1; rv:18.0) Gecko/20100101 Firefox/18.0");
// Authorization request
TransactionResponse response = PayUPayments.doAuthorizationAndCapture(parameters);
// You can obtain the properties in the response
if(response != null){
response.getOrderId();
response.getTransactionId();
response.getState();
if(response.getState().toString().equalsIgnoreCase("PENDING")){
response.getPendingReason();
}
response.getPaymentNetworkResponseCode();
response.getPaymentNetworkResponseErrorMessage();
response.getTrazabilityCode();
response.getResponseCode();
response.getResponseMessage();
}
$reference = "payment_test_00000001";
$value = "1000";
$parameters = array(
// Enter the account’s identifier here
PayUParameters::ACCOUNT_ID => "512325",
// Enter the reference code here.
PayUParameters::REFERENCE_CODE => $reference,
// Enter the description here.
PayUParameters::DESCRIPTION => "payment test",
// -- Values --
// Enter the value here.
PayUParameters::VALUE => $value,
// Enter the currency here.
PayUParameters::CURRENCY => "CLP",
// -- Buyer --
// Enter the buyer Id here.
PayUParameters::BUYER_ID => "1",
// Enter the buyer's name here.
PayUParameters::BUYER_NAME => "First name and second buyer name",
// Enter the buyer's e-mail here.
PayUParameters::BUYER_EMAIL => "buyer_test@test.com",
// Enter the buyer's contact phone here.
PayUParameters::BUYER_CONTACT_PHONE => "7563126",
// Enter the buyer's contact document here.
PayUParameters::BUYER_DNI => "5415668464654",
// Enter the buyer's address here.
PayUParameters::BUYER_STREET => "Autopista Del Sol, 0 - Km.43 Costado Sur",
PayUParameters::BUYER_STREET_2 => "5555487",
PayUParameters::BUYER_CITY => "RM",
PayUParameters::BUYER_STATE => "Talagante",
PayUParameters::BUYER_COUNTRY => "CL",
PayUParameters::BUYER_POSTAL_CODE => "000000",
PayUParameters::BUYER_PHONE => "7563126",
// -- Payer --
// Enter the payer's ID here.
PayUParameters::PARAMETERS.PAYER_ID => "1",
/// Enter the payer's name here
PayUParameters::PAYER_NAME => "First name and second payer name",
// Enter the payer's e-mail here
PayUParameters::PAYER_EMAIL => "payer_test@test.com",
// Enter the payer's contact phone here.
PayUParameters::PAYER_CONTACT_PHONE => "7563126",
// Enter the payer's contact document here.
PayUParameters::PAYER_DNI => "5415668464654",
// Enter the payer's address here.
PayUParameters::PAYER_STREET => "Autopista Del Sol, 0 - Km.43 Costado Sur",
PayUParameters::PAYER_STREET_2 => "5555487",
PayUParameters::PAYER_CITY => "RM",
PayUParameters::PAYER_STATE => "Talagante",
PayUParameters::PAYER_COUNTRY => "CL",
PayUParameters::PAYER_POSTAL_CODE => "000000",
PayUParameters::PAYER_PHONE => "7563126",
// -- Credit card data --
// Enter the number of the credit card here
PayUParameters::CREDIT_CARD_NUMBER => "4037997623271984",
// Enter expiration date of the credit card here
PayUParameters::CREDIT_CARD_EXPIRATION_DATE => "2030/12",
// Enter the security code of the credit card here
PayUParameters::CREDIT_CARD_SECURITY_CODE=> "321",
// Enter the name of the credit card here
PayUParameters::PAYMENT_METHOD => "VISA",
// Enter the number of installments here.
PayUParameters::INSTALLMENTS_NUMBER => "1",
// Enter the name of the country here.
PayUParameters::COUNTRY => PayUCountries::CL,
// Device Session ID
PayUParameters::DEVICE_SESSION_ID => "vghs6tvkcle931686k1900o6e1",
// Payer IP
PayUParameters::IP_ADDRESS => "127.0.0.1",
// Cookie of the current session
PayUParameters::PAYER_COOKIE=>"pt1t38347bs6jc9ruv2ecpv7o2",
// User agent of the current session
PayUParameters::USER_AGENT=>"Mozilla/5.0 (Windows NT 5.1; rv:18.0) Gecko/20100101 Firefox/18.0"
);
// Authorization request
$response = PayUPayments::doAuthorizationAndCapture($parameters);
// You can obtain the properties in the response
if ($response) {
$response->transactionResponse->orderId;
$response->transactionResponse->transactionId;
$response->transactionResponse->state;
if ($response->transactionResponse->state=="PENDING"){
$response->transactionResponse->pendingReason;
}
$response->transactionResponse->paymentNetworkResponseCode;
$response->transactionResponse->paymentNetworkResponseErrorMessage;
$response->transactionResponse->trazabilityCode;
$response->transactionResponse->responseCode;
$response->transactionResponse->responseMessage;
}
Available payment methods query
This method returns a list of the payment methods available in all countries.
Method call
The following examples show how to call the method for this transaction type according to the programming language.
List<PaymentMethodComplete> response = PayUPayments.getPaymentMethods();
LoggerUtil.info("{0}", response);
$array=PayUPayments::getPaymentMethods();
$payment_methods=$array->paymentMethods;
foreach ($payment_methods as $payment_method){
$payment_method->country;
$payment_method->description;
$payment_method->id;
}
Ping
The PING
method lets you verify the connection to our platform.
Method call
The following examples show how to call the method for this transaction type according to the programming language.
boolean response = PayUPayments.doPing();
LoggerUtil.info("{0}", response);
$response = PayUPayments::doPing();
$response->code;