API Reference
Start typing to search…

22 - BCI - MACH (CLP)

Channel: 22

Provider: BCI

Payment Method: MACH

Available Currencies

NameCodeCountry
Chilean PesosCLPChile

Request example

curl --location 'http://paymentscert.alps.cl/justpay/check-out/SecurePayment' \
--form 'public_key="zyssglikvtltbd2se2hudwl50jjomil2uytp7tpvjtxyfdw469jagk8yvnex9jks"' \
--form 'time="2024-07-17 16:33:11"' \
--form 'amount="500"' \
--form 'currency="CLP"' \
--form 'trans_id="1"' \
--form 'time_expired="120"' \
--form 'url_ok="https://bit.ly/3S4I7iR"' \
--form 'url_error="https://bit.ly/3S4I7iR"' \
--form 'channel="22"' \
--form 'signature="5ba9e2e4a24e2b38e8f8768aa090aeb15f61ed9249c03f42f64c05c62797a03b"' \
--form 'shopper_information="{\"Phone\": \"999999999\", \"email\": \"[email protected]\", \"name_shopper\": \"\", \"Num_doc_identi\": \"234112345678\", \"type_doc_identi\": \"ci\", \"last_name_Shopper\": \"\", \"country\":\"ECU\", \"country_code\":\"+593\"}"'
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://paymentscert.alps.cl/justpay/check-out/SecurePayment',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('public_key' => 'zyssglikvtltbd2se2hudwl50jjomil2uytp7tpvjtxyfdw469jagk8yvnex9jks','time' => '2024-07-17 16:33:11','amount' => '500','currency' => 'CLP','trans_id' => '1','time_expired' => '120','url_ok' => 'https://bit.ly/3S4I7iR','url_error' => 'https://bit.ly/3S4I7iR','channel' => '22','signature' => '5ba9e2e4a24e2b38e8f8768aa090aeb15f61ed9249c03f42f64c05c62797a03b','shopper_information' => '{"Phone": "999999999", "email": "[email protected]", "name_shopper": "", "Num_doc_identi": "234112345678", "type_doc_identi": "ci", "last_name_Shopper": "", "country":"ECU", "country_code":"+593"}'),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

import requests

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

payload = {'public_key': 'zyssglikvtltbd2se2hudwl50jjomil2uytp7tpvjtxyfdw469jagk8yvnex9jks',
'time': '2024-07-17 16:33:11',
'amount': '500',
'currency': 'CLP',
'trans_id': '1',
'time_expired': '120',
'url_ok': 'https://bit.ly/3S4I7iR',
'url_error': 'https://bit.ly/3S4I7iR',
'channel': '22',
'signature': '5ba9e2e4a24e2b38e8f8768aa090aeb15f61ed9249c03f42f64c05c62797a03b',
'shopper_information': '{"Phone": "999999999", "email": "[email protected]", "name_shopper": "", "Num_doc_identi": "234112345678", "type_doc_identi": "ci", "last_name_Shopper": "", "country":"ECU", "country_code":"+593"}'}
files=[

]
headers = {}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'http://paymentscert.alps.cl/justpay/check-out/SecurePayment',
  'headers': {
  },
  formData: {
    'public_key': 'zyssglikvtltbd2se2hudwl50jjomil2uytp7tpvjtxyfdw469jagk8yvnex9jks',
    'time': '2024-07-17 16:33:11',
    'amount': '500',
    'currency': 'CLP',
    'trans_id': '1',
    'time_expired': '120',
    'url_ok': 'https://bit.ly/3S4I7iR',
    'url_error': 'https://bit.ly/3S4I7iR',
    'channel': '22',
    'signature': '5ba9e2e4a24e2b38e8f8768aa090aeb15f61ed9249c03f42f64c05c62797a03b',
    'shopper_information': '{"Phone": "999999999", "email": "[email protected]", "name_shopper": "", "Num_doc_identi": "234112345678", "type_doc_identi": "ci", "last_name_Shopper": "", "country":"ECU", "country_code":"+593"}'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.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: 30 minutes Cash: 2 hours For Brazil: Online: 2 hours Cash 24 hrs
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 [CI, RUT, PAS, DNI]
Num_doc_identiTrueString (12)Identification document number
emailTrueString (255)Shopper's email
country_codeTrueString (4)Country's phone code [+59]
PhoneTrueString (12)Shopper's phone number
countryTrueString (3)Country ISO code [CHL]

Direct integration

You have the option to create a direct checkout, for this integration you'll receive a JSON Object instead of the checkout url.

Aditional fields for direct integration

AttributeMandatoryData typeDescription
direct_integrationTrueIntegerSend 1 for direct integration

Errors

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