API CashIn
Buscar…
Consultar
Consulta los detalles de una orden registrada.
Request
Request (ejemplo)
Response
Response(ejemplo)
Request (ejemplo aditionalinfo)
Response (ejemplo aditionalinfo)
Campo
Tipo
Requerido
Descripción
order
string (pathParam)
si
Identificador de la orden único en el comercio.
merchant
string (queryParam)
si
Identificador del comercio en Payvalida.
checksum
string (queryParam)
si
Cadena consultada con SHA512(order + merchant + FIXED_HASH).
aditionalinfo
string (queryParam)
no
Valor para obtener informacion adicional en el campo ADITIONAL_INFO dentro de la DATA del response. Actualmente solo se puede enviar cuspse
1
curl --location --request GET 'https://api-test.payvalida.com/api/v3/porders/9022932?merchant=kuanto&checksum=7CA708050F7F5B3EB5B9FD271D375DCEFCA71BDEFDF91C96A4C38F906EFA133E95675D332279C89F999B1909ECF2EBCA7EC177ACED6EA56D1A72244145E377B7'
Copied!
Campo
Estructura
Tipo
Descripción
CODE
-
string
Código de respuesta 0000 para OK.
DESC
-
string
Descripción de la respuesta.
DATA
-
-
Datos de la respuesta.
CURRENCY
DATA
string
NOTIFICATION_RESPONSE
DATA
string
Respuesta del comercio una vez realizada la notificación de pago.
UDPATE_DATE
DATA
string
Fecha de ultima actualización sobre la orden.
CREATION_DATE
DATA
string
Fecha de creación de la orden.
STATE
DATA
string
Estado actual de la orden.
PAYMNENT_METHOD
DATA
string
Método de pago escogido para la orden.
EMAIL
DATA
string
Correo del cliente registrado en la orden.
LIFE_TIME
DATA
string
Tiempo de expiración en horas
ORDER
DATA
string
Numero de la orden.
CODE
DATA
int
Código único de la orden en Payvalida.
AMOUNT
DATA
string
Monto de la orden.
DESCRIPTION
DATA
string
Descripción de la orden.
REFERENCE
DATA
string
Numero de referencia de la orden
checkout
DATA
string
Link de checkout generado para esta orden.
TRANSACTION
DATA
-
Información adicional de la transacción si esta aprobada y fue pagada con tarjeta de crédito.
DATE
DATA-TRANSACTION
string
Fecha de la transacción.
1
{
2
"CODE": "0000",
3
"DESC": "OK",
4
"DATA": {
5
"CURRENCY": "COP",
6
"NOTIFICATION_RESPONSE": "{\"CODE\":\"0002\",\"DESC\":\"Checksum diferente\"}",
7
"UDPATE_DATE": "2020-11-27 15:29:35",
8
"CREATION_DATE": "2020-11-27 15:20:55",
9
"STATE": "APROBADA",
10
"PAYMNENT_METHOD": "Tarjeta de Credito",
11
"EMAIL": "[email protected]",
12
"LIFE_TIME": "75h",
13
"ORDER": "9022932",
14
"CODE": 1934038,
15
"AMOUNT": "200.00",
16
"DESCRIPTION": "TEST TRANSACTION AT",
17
"REFERENCE": "43568287",
18
"checkout": "sandbox-checkout.payvalida.com?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJNRVJDSEFOVF9DRUwiOiIzMTYzODg3MzQwIiwiTUVSQ0hBTlRfQ09ERSI6NzMsIk9SREVSX0NPREUiOjE5MzQwMzgsIk1FUkNIQU5UX0VNQUlMIjoiZWZyYW5jb0BwYXl2YWxpZGEuY29tIiwiTUVSQ0hBTlRfTE9HTyI6Imh0dHBzOi8vdGVzdC1pbWFnZXMucGF5dmFsaWRhLmNvbS92YWxpZGRhd2ViL2xvZ29fbWVyY2hhbnQva3VhbnRvL2xvZ28xNTk4NTM4MTEyMjkyLmpwZyIsIk1FUkNIQU5UX1VSTF9SRVRVUk4iOiJodHRwczovL3BsdXMuZ29vZ2xlLmNvbS8rZ29vZ2xlIiwiTUVSQ0hBTlRfTkFNRSI6Ikt1YW50byBUZXN0IiwiRVhQSVJBVElPTiI6IjMwLzExLzIwMjAiLCJPUkRFUl9CUklFRiI6IlRFU1QgVFJBTlNBQ1RJT04gQVQiLCJNRVJDSEFOVF9URUwiOiI0NDQ5OTY5IiwiT1JERVJfQ1VSUkVOQ1kiOiJDT1AiLCJPUkRFUl9BTU9VVCI6IjIwMC4wMCIsIk1FUkNIQU5UX0lEIjoia3VhbnRvIiwiT1JERVJfUkVGRVJFTkNFIjoiNDM1NjgyODciLCJPUkRFUl9NRVRIT0QiOiIiLCJVU0VSX0RJIjoiIiwiVVNFUl9UWVBFX0RJIjoiIiwiVVNFUl9OQU1FIjoiIiwiUkVESVJFQ1RfVElNRU9VVCI6IiIsIk1FUkNIQU5UX1RFTVBMQVRFIjoidjQiLCJleHAiOjE2MDY3Nzg0NTUsImlzcyI6ImF1dGgwIn0.G-hqojyCQVss3aYILwwZY-vtz2O5v9jF0T0_MWA-mwQ",
19
"TRANSACTION": {
20
"DATE": "2020-11-27T20:28:58Z",
21
"RESPONSE_CODE": "APROBADA",
22
"QUOTES": "2",
23
"ACCOUNT_TYPE": "CREDITO",
24
"CUS": "_12757866",
25
"INVOICE_NUMBER": "12757866",
26
"FRANCHISE": "MasterCard",
27
"RESPONSE": "Aprobada",
28
"CARD_NUMBER": "************8783",
29
"ERROR": ""
30
}
31
}
32
}
Copied!
1
curl --location --request GET 'https://api-test.payvalida.com/api/v3/porders/prue303459?merchant=kuanto&checksum=cheksuminvalido&aditionalinfo=cuspse'
Copied!
1
{
2
"CODE": "0000",
3
"DESC": "OK",
4
"DATA": {
5
"CURRENCY": "COP",
6
"NOTIFICATION_RESPONSE": "Error al procesar los datos",
7
"UDPATE_DATE": "2022-02-07 10:48:21",
8
"CREATION_DATE": "2022-02-07 10:45:57",
9
"STATE": "APROBADA",
10
"PAYMNENT_METHOD": "PSE",
11
"EMAIL": "[email protected]",
12
"LIFE_TIME": "445h",
13
"ORDER": "prue303459",
14
"CODE": 2202776,
15
"AMOUNT": "120.00",
16
"DESCRIPTION": "prueb040",
17
"REFERENCE": "80011572",
18
"checkout": "sandbox-checkout.payvalida.com?token=tokencheckout",
19
"TRANSACTION": {},
20
"ADITIONAL_INFO": {
21
"CUS": "2539443"
22
}
23
}
24
}
Copied!
Si el campo aditionalinfo no es enviado en el request, no aparecerá el campo ADITIONAL_INFO en el response. Si este campo es enviado, llegará vacío junto con el campo CUS dentro de éste por defecto, a excepción de un pago exitoso con PSE en el cual se enviará el número del cus.
La identificación del comercio (merchant) y FIXED_HASH, se proporcionan al momento de crear una cuenta en nuestra plataforma.

Ejemplos

  • GO
1
package main
2
import (
3
"fmt"
4
"net/http"
5
"io/ioutil"
6
)
7
func main() {
8
url := "https://api-test.payvalida.com/api/v3/porders/9022932?merchant=kuanto&checksum=7CA708050F7F5B3EB5B9FD271D375DCEFCA71BDEFDF91C96A4C38F906EFA133E95675D332279C89F999B1909ECF2EBCA7EC177ACED6EA56D1A72244145E377B7"
9
method := "GET"
10
client := &http.Client {
11
}
12
req, err := http.NewRequest(method, url, nil)
13
if err != nil {
14
fmt.Println(err)
15
return
16
}
17
res, err := client.Do(req)
18
if err != nil {
19
fmt.Println(err)
20
return
21
}
22
defer res.Body.Close()
23
24
body, err := ioutil.ReadAll(res.Body)
25
if err != nil {
26
fmt.Println(err)
27
return
28
}
29
fmt.Println(string(body))
30
}
Copied!
  • PHP
1
<?php
2
$curl = curl_init();
3
curl_setopt_array($curl, array(
4
CURLOPT_URL => "https://api-test.payvalida.com/api/v3/porders/9022932?merchant=kuanto&checksum=7CA708050F7F5B3EB5B9FD271D375DCEFCA71BDEFDF91C96A4C38F906EFA133E95675D332279C89F999B1909ECF2EBCA7EC177ACED6EA56D1A72244145E377B7",
5
CURLOPT_RETURNTRANSFER => true,
6
CURLOPT_ENCODING => "",
7
CURLOPT_MAXREDIRS => 10,
8
CURLOPT_TIMEOUT => 0,
9
CURLOPT_FOLLOWLOCATION => true,
10
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
11
CURLOPT_CUSTOMREQUEST => "GET",
12
));
13
$response = curl_exec($curl);
14
curl_close($curl);
15
echo $response;
Copied!
  • Java
1
OkHttpClient client = new OkHttpClient().newBuilder()
2
.build();
3
Request request = new Request.Builder()
4
.url("https://api-test.payvalida.com/api/v3/porders/9022932?merchant=kuanto&checksum=7CA708050F7F5B3EB5B9FD271D375DCEFCA71BDEFDF91C96A4C38F906EFA133E95675D332279C89F999B1909ECF2EBCA7EC177ACED6EA56D1A72244145E377B7")
5
.method("GET", null)
6
.build();
7
Response response = client.newCall(request).execute();
Copied!
  • Python
1
import http.client
2
import mimetypes
3
conn = http.client.HTTPSConnection("api-test.payvalida.com")
4
payload = ''
5
headers = {}
6
conn.request("GET", "/api/v3/porders/9022932?merchant=kuanto&checksum=7CA708050F7F5B3EB5B9FD271D375DCEFCA71BDEFDF91C96A4C38F906EFA133E95675D332279C89F999B1909ECF2EBCA7EC177ACED6EA56D1A72244145E377B7", payload, headers)
7
res = conn.getresponse()
8
data = res.read()
9
print(data.decode("utf-8"))
Copied!
  • JavaScript
1
var myHeaders = new Headers();
2
var requestOptions = {
3
method: 'GET',
4
headers: myHeaders,
5
redirect: 'follow'
6
};
7
fetch("https://api-test.payvalida.com/api/v3/porders/9022932?merchant=kuanto&checksum=7CA708050F7F5B3EB5B9FD271D375DCEFCA71BDEFDF91C96A4C38F906EFA133E95675D332279C89F999B1909ECF2EBCA7EC177ACED6EA56D1A72244145E377B7", requestOptions)
8
.then(response => response.text())
9
.then(result => console.log(result))
10
.catch(error => console.log('error', error));
Copied!
Copiar enlace
Contenidos
Ejemplos