API Reference

21 - Payphone (USD)

Channel: 21

Provider: Payphone

Payment Method: Debit / Credit Card

Available Currencies

NameCodeCountry
US DollarUSDEcuador, Panama

Request example

curl --location 'http://localhost/justpay/check-out/SecurePayment.php' \
--form 'public_key="zyssglikvtltbd2se2hudwl50jjomil2uytp7tpvjtxyfdw469jagk8yvnex9jks"' \
--form 'time="2024-07-17 16:33:11"' \
--form 'amount="500"' \
--form 'currency="USD"' \
--form 'trans_id="1"' \
--form 'time_expired="120"' \
--form 'url_ok="http://127.0.0.1/justpay/Tests/Unit/test_successful_or_reject_webhook.php"' \
--form 'url_error="http://127.0.0.1/justpay/Tests/Unit/test_failure_webhook.php"' \
--form 'channel="21"' \
--form 'signature="1bcf8c3e5e6f43a3f301ef3af6d2ef91283247d14a30bc1c59ebfbb3ac0a8893"' \
--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://localhost/justpay/check-out/SecurePayment.php',
  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' => 'USD','trans_id' => '1','time_expired' => '120','url_ok' => 'http://127.0.0.1/justpay/Tests/Unit/test_successful_or_reject_webhook.php','url_error' => 'http://127.0.0.1/justpay/Tests/Unit/test_failure_webhook.php','channel' => '21','signature' => '1bcf8c3e5e6f43a3f301ef3af6d2ef91283247d14a30bc1c59ebfbb3ac0a8893','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://localhost/justpay/check-out/SecurePayment.php"

payload = {'public_key': 'zyssglikvtltbd2se2hudwl50jjomil2uytp7tpvjtxyfdw469jagk8yvnex9jks',
'time': '2024-07-17 16:33:11',
'amount': '500',
'currency': 'USD',
'trans_id': '1',
'time_expired': '120',
'url_ok': 'http://127.0.0.1/justpay/Tests/Unit/test_successful_or_reject_webhook.php',
'url_error': 'http://127.0.0.1/justpay/Tests/Unit/test_failure_webhook.php',
'channel': '21',
'signature': '1bcf8c3e5e6f43a3f301ef3af6d2ef91283247d14a30bc1c59ebfbb3ac0a8893',
'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://localhost/justpay/check-out/SecurePayment.php',
  'headers': {
  },
  formData: {
    'public_key': 'zyssglikvtltbd2se2hudwl50jjomil2uytp7tpvjtxyfdw469jagk8yvnex9jks',
    'time': '2024-07-17 16:33:11',
    'amount': '500',
    'currency': 'USD',
    'trans_id': '1',
    'time_expired': '120',
    'url_ok': 'http://127.0.0.1/justpay/Tests/Unit/test_successful_or_reject_webhook.php',
    'url_error': 'http://127.0.0.1/justpay/Tests/Unit/test_failure_webhook.php',
    'channel': '21',
    'signature': '1bcf8c3e5e6f43a3f301ef3af6d2ef91283247d14a30bc1c59ebfbb3ac0a8893',
    'shopper_information': '{\n            "Phone": "999999999", \n            "email": "[email protected]",  \n            "name_shopper": "", \n            "Num_doc_identi": "234112345678", \n            "type_doc_identi": "ci", \n            "last_name_Shopper": "",\n            "country":"ECU",\n            "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
filter_byTruestring(3-14)Payment method

shopper_information JSON format

📘

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

'{"Phone": "923423122", "email": "[email protected]", "name_shopper": "", "Num_doc_identi": "234112345678", "type_doc_identi": "ci", "last_name_Shopper": "", "country":"ECU", "country_code":"+593"}'

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, RUC, PAS]
Num_doc_identiTrueString (12)Identification document number
emailTrueString (255)Shopper's email
country_codeTrueString (4)Country's phone code [+593]
PhoneTrueString (12)Shopper's phone number
countryTrueString (3)Country ISO code [ECU]

Test Transactions

Simulate payments

Testing cards

BrandNumberExpiration dateCVV
Visa449743414928663812/30123

Errors

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