API Reference

10 - Debit / Credit Card (PEN, COP)

Channel: 10

Provider: Nuvei

Payment Method: Debit / Credit Card

Available Currencies

NameCodeCountry
Peruvian SolPENPeru
Colombian PesosCOLColombia

Request example

curl --request POST \
  --url http://paymentscert.alps.cl/justpay/check-out/SecurePayment \
  --data public_key=zyssglikvtltbd2se2hudwl50jjomil2uytp7tpvjtxyfdw469jagk8yvnex9jks \
  --data time=2022-10-13T14:39:09 \
  --data channel=10 \
  --data amount=10 \
  --data currency=PEN \
  --data trans_id=1 \
  --data time_expired=120 \
  --data url_ok=https://bit.ly/3S4I7iR \
  --data url_error=https://bit.ly/3S5aOwc \
  --data signature=50743f5c8b768be0e336f2f08b057dbc587c2cf2186554ff4992e27c73e73e3c
   --data 'shopper_information={"Phone": "1122223333","email": "[email protected]","country_code": "+51", "name_shopper": "Fulano","Num_doc_identi": "41579263","type_doc_identi": "DNI", "last_name_Shopper": "Da Silva","country":"PER"}'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://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=zyssglikvtltbd2se2hudwl50jjomil2uytp7tpvjtxyfdw469jagk8yvnex9jks&time=2022-10-13T14%3A39%3A09&channel=10&amount=10&currency=PEN&trans_id=1&time_expired=120&url_ok=https%3A%2F%2Fbit.ly%2F3S4I7iR&url_error=https%3A%2F%2Fbit.ly%2F3S5aOwc&signature=50743f5c8b768be0e336f2f08b057dbc587c2cf2186554ff4992e27c73e73e3c&shopper_information=%7B%27Phone%27%3A%20%271122223333%27%2C%20%27email%27%3A%20%27teste%40email.com%27%2C%20%27country_code%27%3A%20%27%2B51%27%2C%20%27name_shopper%27%3A%20%27Fulano%27%2C%20%27Num_doc_identi%27%3A%20%2741579263%27%2C%20%27type_doc_identi%27%3A%20%27DNI%27%2C%20%27last_name_Shopper%27%3A%20%27Da+Silva%27%2C%20%27country%27%3A%20%27PER%27%7D",
]);

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

curl_close($curl);

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

import requests

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

payload = "public_key=zyssglikvtltbd2se2hudwl50jjomil2uytp7tpvjtxyfdw469jagk8yvnex9jks&time=2022-10-13T14%3A39%3A09&channel=10&amount=10&currency=PEN&trans_id=1&time_expired=120&url_ok=https%3A%2F%2Fbit.ly%2F3S4I7iR&url_error=https%3A%2F%2Fbit.ly%2F3S5aOwc&signature=50743f5c8b768be0e336f2f08b057dbc587c2cf2186554ff4992e27c73e73e3c&shopper_information=%7B%27Phone%27%3A%20%271122223333%27%2C%20%27email%27%3A%20%27teste%40email.com%27%2C%20%27country_code%27%3A%20%27%2B51%27%2C%20%27name_shopper%27%3A%20%27Fulano%27%2C%20%27Num_doc_identi%27%3A%20%2741579263%27%2C%20%27type_doc_identi%27%3A%20%27DNI%27%2C%20%27last_name_Shopper%27%3A%20%27Da+Silva%27%2C%20%27country%27%3A%20%27PER%27%7D"
response = requests.request("POST", url, data=payload)

print(response.text)

const qs = require("querystring");
const http = require("http");

const options = {
  "method": "POST",
  "hostname": "paymentscert.alps.cl",
  "port": null,
  "path": "/justpay/check-out/SecurePayment",
  "headers": {}
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.write(qs.stringify({
  public_key: 'zyssglikvtltbd2se2hudwl50jjomil2uytp7tpvjtxyfdw469jagk8yvnex9jks',
  time: '2022-10-13T14:39:09',
  channel: '10',
  amount: '10',
  currency: 'PEN',
  trans_id: '1',
  time_expired: '120',
  url_ok: 'https://bit.ly/3S4I7iR',
  url_error: 'https://bit.ly/3S5aOwc',
  signature: '50743f5c8b768be0e336f2f08b057dbc587c2cf2186554ff4992e27c73e73e3c',
  shopper_information:'{"Phone": "1122223333","email": "[email protected]","country_code": "+51", "name_shopper": "Fulano","Num_doc_identi": "41579263","type_doc_identi": "DNI", "last_name_Shopper": "Da Silva","country":"PER"}'
}));
req.end();

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_expiredTrueIntegerTime in minutes to expire the token. Value given in minutes. Minimum Suggested: 30 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).

'{"Phone": "1122223333","email": "[email protected]","country_code": "+51", "name_shopper": "Fulano","Num_doc_identi": "41579263","type_doc_identi": "DNI", "last_name_Shopper": "Da Silva","country":"PER"}'

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 (255)Identification document [RUT,DNI,CI, ID etc.]
Num_doc_identiTrueString (255)Identification document number
emailTrueString (255)Shopper's e-mail
country_codeTrueString (10)Country's phone code (Ex. +57)
PhoneTrueString (20)Shopper's phone number
countryTrueString (3)Shopper's country [MEX, PER, ECU, COL]

Testing Cards

Cards that Return APPROVED

VISAMASTERCARDAMEX
47613441361413905101081046006034375510513169537
47612013814752975101084411423750375510288656924
41591292524580865333304500657872375510379996452
41234074390430515333308664112277375510082116984
40018886874124695550345228382224
44444933182468925550347471347813

Cards that Return DECLINED

DECLINE REASONVISAMASTERCARD
Decline40083708966623695333418445863914
Soft Decline - Authentication is Advised42176413299724695109486948867999
External Error in Processing40001284494982045333423768173347
Insufficient Funds40083844243708905333475572200849

Errors

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