API Reference

16 - PayCash (MXN, COP, CRC, GTQ, HNL, USD)

Channel: 16

Provider: Paycash

Payment Method: APM

Available Currencies

NameCodeCountry
Mexican pesoMXNMexico
Colombian PesosCOPColombia
Costa Rican colónCRCCosta Rica
Guatemalan QuetzalGTQGuatemala
Honduran LempirasHNLHonduras
United State DollarsUSDPanama

Request example

curl --request POST \
  --url https://paymentscert.alps.cl/justpay/check-out/SecurePayment \
  --data public_key=adasdyuuudauysd67677ASDA766776sada \
  --data time=2023-10-27T13:22:50 \
  --data channel=16 \
  --data amount=4000 \
  --data currency=MXN \
  --data trans_id=3050525119 \
  --data time_expired=120 \
  --data url_ok=http://bit.ly/3S4I7iR \
  --data url_error=https://bit.ly/3S5aOwc \
  --data signature=3686f2b21439a52652e6f79c0394be4d0d56f7d805c48ec96cde238a760f217b \
  --data 'shopper_information={"name_shopper": "Test","last_name_Shopper": "User","type_doc_identi": "RUT","Num_doc_identi": "12345678901","email": "[email protected]", "country_code": "593","Phone": "123763456", "country": "MEX"}' \
  --data filter_by= \
  --data direct_integration=0

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://paymentscert.alps.cl/justpay/check-out/SecurePayment",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "public_key=dasdasda7d8as87d87as78d78as87d87a&time=2023-10-27T13%3A22%3A50&channel=16&amount=4000&currency=MXN&trans_id=3050525119&time_expired=120&url_ok=http%3A%2F%2Fbit.ly%2F3S4I7iR&url_error=https%3A%2F%2Fbit.ly%2F3S5aOwc&signature=3686f2b21439a52652e6f79c0394be4d0d56f7d805c48ec96cde238a760f217b&shopper_information=%7B%22name_shopper%22%3A%20%22Test%22%2C%22last_name_Shopper%22%3A%20%22User%22%2C%22type_doc_identi%22%3A%20%22RUT%22%2C%22Num_doc_identi%22%3A%20%2212345678901%22%2C%22email%22%3A%20%22no-reply%40alps.cl%22%2C%20%22country_code%22%3A%20%22593%22%2C%22Phone%22%3A%20%22123763456%22%2C%20%22country%22%3A%20%22MEX%22%7D&filter_by=&direct_integration=0",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import requests

url = "https://paymentscert.alps.cl/justpay/check-out/SecurePayment"

payload = "public_key=asdasd6a7d76a67d67a76d67as67da&time=2023-10-27T13%3A22%3A50&channel=16&amount=4000&currency=MXN&trans_id=3050525119&time_expired=120&url_ok=http%3A%2F%2Fbit.ly%2F3S4I7iR&url_error=https%3A%2F%2Fbit.ly%2F3S5aOwc&signature=3686f2b21439a52652e6f79c0394be4d0d56f7d805c48ec96cde238a760f217b&shopper_information=%7B%22name_shopper%22%3A%20%22Test%22%2C%22last_name_Shopper%22%3A%20%22User%22%2C%22type_doc_identi%22%3A%20%22RUT%22%2C%22Num_doc_identi%22%3A%20%2212345678901%22%2C%22email%22%3A%20%22no-reply%40alps.cl%22%2C%20%22country_code%22%3A%20%22593%22%2C%22Phone%22%3A%20%22123763456%22%2C%20%22country%22%3A%20%22MEX%22%7D&filter_by=&direct_integration=0"
response = requests.request("POST", url, data=payload)

print(response.text)

const request = require('request');

const options = {
  method: 'POST',
  url: 'https://paymentscert.alps.cl/justpay/check-out/SecurePayment',
  form: {
    public_key: 'dasd788d87as87d87a78sd78a87dsaasdasdas',
    time: '2023-10-27T13:22:50',
    channel: '16',
    amount: '4000',
    currency: 'MXN',
    trans_id: '3050525119',
    time_expired: '120',
    url_ok: 'http://bit.ly/3S4I7iR',
    url_error: 'https://bit.ly/3S5aOwc',
    signature: '3686f2b21439a52652e6f79c0394be4d0d56f7d805c48ec96cde238a760f217b',
    shopper_information: '{"name_shopper": "Test","last_name_Shopper": "User","type_doc_identi": "RUT","Num_doc_identi": "12345678901","email": "[email protected]", "country_code": "593","Phone": "123763456", "country": "MEX"}',
    filter_by: '',
    direct_integration: '0'
  }
};

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

Mandatory Data

AttributeMandatoryData typeDescription
public_keyTrueString (255)Public key, unique value that identifies the commerce
timeTrueDatetimeRequest data time
channelTrueIntegerPayment Channel
amountTrueDoubleThe amount of the transaction. Use 2 decimals.
currencyTrueString (3)Transaction currency code
trans_idTrueString (255)Transaction id
time_expiredTrueString (255)Time in minutes to expire the token. Value given in minutes. Minimum Suggested: Online: 1440 minutes
url_okTrueString (255)URL where shopper will be redirected from the online banking if payment was successful (Must be Https)
url_errorTrueString (255)URL where shopper will be redirected from the online banking if payment was wrong.(Must be Https)
signatureTrueString (255)Signature hash256: Review signature calculation
shopper_informationTrueJSON StringJSON String Data: Review JSON index & format

shopper_information JSON format

📘

Field shopper_information must be send in string format (JSON encode).

'{"name_shopper": "Test","last_name_Shopper": "User","type_doc_identi": "RUT","Num_doc_identi": "12345678901","email": "[email protected]", "country_code": "593","Phone": "123763456", "country": "MEX"}'

The shopper_information field is a column corresponding to a json with the next keys:

ParameterMandatoryData TypeDescription
name_shopperTrueString (255)Shopper's name
last_name_ShopperTrueString (255)Shopper's last name
type_doc_identiTrueString (3)Identification document
Num_doc_identiTrueString (12)Identification document number
emailTrueString (255)Shopper's email
country_codeTrueString (4)Country's phone code [+57]
PhoneTrueString (12)Shopper's phone number
countryTrueString (3)Country ISO code [MEX]

Errors

This payment integration only sends notifications for successfully completed transactions. This means that error messages will not be generated for failed transactions.