Consultar

Consulta los detalles de una orden registrada.

Producción: https://api.payvalida.com/api/v3/porders/{order}​
Sandbox: https://api-test.payvalida.com/api/v3/porders/{order}​
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
curl --location --request GET 'https://api-test.payvalida.com/api/v3/porders/9022932?merchant=kuanto&checksum=7CA708050F7F5B3EB5B9FD271D375DCEFCA71BDEFDF91C96A4C38F906EFA133E95675D332279C89F999B1909ECF2EBCA7EC177ACED6EA56D1A72244145E377B7'
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
​Tipo de moneda de pago.​
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.
RESPONSE_CODE
DATA-TRANSACTION
string
Respuesta del procesamiento de la transacción.
QUOTES
DATA-TRANSACTION
string
Numero de cuotas en las que se realizo el pago.
ACCOUNT_TYPE
DATA-TRANSACTION
string
Tipo de cuenta con la que se realizo el pago.
CUS
DATA-TRANSACTION
string
Código único identificador de la transacción desde el recaudo.
INVOICE_NUMBER
DATA-TRANSACTION
string
Numero de factura generado.
FRANCHISE
DATA-TRANSACTION
string
Franquicia por la cual se realizo el pago.
RESPONSE
DATA-TRANSACTION
string
Respuesta del procesador de pago.
CARD_NUMBER
DATA-TRANSACTION
string
CVV1 o 4 últimos dígitos de la tarjeta si el pago fue por TC.
ERROR
DATA-TRANSACTION
string
Mensaje de error o aprobación al efectuar la compra.
ADITIONAL_INFO
DATA
string
Este arreglo es enviado únicamente cuando el campo aditionalinfo está presente en el request
CUS
DATA-ADITIONAL_INFO
string
Si el medio de pago fue PSE y fue una orden aprobada, este campo llegará con el código CUS de la transacción. De lo contrario, si se envía el campo aditionalinfo pero no cumple con las condiciones anteriores, llegará vacío.
{
    "CODE": "0000",
    "DESC": "OK",
    "DATA": {
        "CURRENCY": "COP",
        "NOTIFICATION_RESPONSE": "{\"CODE\":\"0002\",\"DESC\":\"Checksum diferente\"}",
        "UDPATE_DATE": "2020-11-27 15:29:35",
        "CREATION_DATE": "2020-11-27 15:20:55",
        "STATE": "APROBADA",
        "PAYMNENT_METHOD": "Tarjeta de Credito",
        "EMAIL": "[email protected]",
        "LIFE_TIME": "75h",
        "ORDER": "9022932",
        "CODE": 1934038,
        "AMOUNT": "200.00",
        "DESCRIPTION": "TEST TRANSACTION AT",
        "REFERENCE": "43568287",
        "checkout": "sandbox-checkout.payvalida.com?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJNRVJDSEFOVF9DRUwiOiIzMTYzODg3MzQwIiwiTUVSQ0hBTlRfQ09ERSI6NzMsIk9SREVSX0NPREUiOjE5MzQwMzgsIk1FUkNIQU5UX0VNQUlMIjoiZWZyYW5jb0BwYXl2YWxpZGEuY29tIiwiTUVSQ0hBTlRfTE9HTyI6Imh0dHBzOi8vdGVzdC1pbWFnZXMucGF5dmFsaWRhLmNvbS92YWxpZGRhd2ViL2xvZ29fbWVyY2hhbnQva3VhbnRvL2xvZ28xNTk4NTM4MTEyMjkyLmpwZyIsIk1FUkNIQU5UX1VSTF9SRVRVUk4iOiJodHRwczovL3BsdXMuZ29vZ2xlLmNvbS8rZ29vZ2xlIiwiTUVSQ0hBTlRfTkFNRSI6Ikt1YW50byBUZXN0IiwiRVhQSVJBVElPTiI6IjMwLzExLzIwMjAiLCJPUkRFUl9CUklFRiI6IlRFU1QgVFJBTlNBQ1RJT04gQVQiLCJNRVJDSEFOVF9URUwiOiI0NDQ5OTY5IiwiT1JERVJfQ1VSUkVOQ1kiOiJDT1AiLCJPUkRFUl9BTU9VVCI6IjIwMC4wMCIsIk1FUkNIQU5UX0lEIjoia3VhbnRvIiwiT1JERVJfUkVGRVJFTkNFIjoiNDM1NjgyODciLCJPUkRFUl9NRVRIT0QiOiIiLCJVU0VSX0RJIjoiIiwiVVNFUl9UWVBFX0RJIjoiIiwiVVNFUl9OQU1FIjoiIiwiUkVESVJFQ1RfVElNRU9VVCI6IiIsIk1FUkNIQU5UX1RFTVBMQVRFIjoidjQiLCJleHAiOjE2MDY3Nzg0NTUsImlzcyI6ImF1dGgwIn0.G-hqojyCQVss3aYILwwZY-vtz2O5v9jF0T0_MWA-mwQ",
        "TRANSACTION": {
            "DATE": "2020-11-27T20:28:58Z",
            "RESPONSE_CODE": "APROBADA",
            "QUOTES": "2",
            "ACCOUNT_TYPE": "CREDITO",
            "CUS": "_12757866",
            "INVOICE_NUMBER": "12757866",
            "FRANCHISE": "MasterCard",
            "RESPONSE": "Aprobada",
            "CARD_NUMBER": "************8783",
            "ERROR": ""
        }
    }
}
curl --location --request GET 'https://api-test.payvalida.com/api/v3/porders/prue303459?merchant=kuanto&checksum=cheksuminvalido&aditionalinfo=cuspse'
{
  "CODE": "0000",
  "DESC": "OK",
  "DATA": {
    "CURRENCY": "COP",
    "NOTIFICATION_RESPONSE": "Error al procesar los datos",
    "UDPATE_DATE": "2022-02-07 10:48:21",
    "CREATION_DATE": "2022-02-07 10:45:57",
    "STATE": "APROBADA",
    "PAYMNENT_METHOD": "PSE",
    "EMAIL": "[email protected]",
    "LIFE_TIME": "445h",
    "ORDER": "prue303459",
    "CODE": 2202776,
    "AMOUNT": "120.00",
    "DESCRIPTION": "prueb040",
    "REFERENCE": "80011572",
    "checkout": "sandbox-checkout.payvalida.com?token=tokencheckout",
    "TRANSACTION": {},
    "ADITIONAL_INFO": {
      "CUS": "2539443"
    }
  }
}
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
package main
import (
  "fmt"
  "net/http"
  "io/ioutil"
)
func main() {
  url := "https://api-test.payvalida.com/api/v3/porders/9022932?merchant=kuanto&checksum=7CA708050F7F5B3EB5B9FD271D375DCEFCA71BDEFDF91C96A4C38F906EFA133E95675D332279C89F999B1909ECF2EBCA7EC177ACED6EA56D1A72244145E377B7"
  method := "GET"
  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)
  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()
​
  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
PHP
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api-test.payvalida.com/api/v3/porders/9022932?merchant=kuanto&checksum=7CA708050F7F5B3EB5B9FD271D375DCEFCA71BDEFDF91C96A4C38F906EFA133E95675D332279C89F999B1909ECF2EBCA7EC177ACED6EA56D1A72244145E377B7",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
Java
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://api-test.payvalida.com/api/v3/porders/9022932?merchant=kuanto&checksum=7CA708050F7F5B3EB5B9FD271D375DCEFCA71BDEFDF91C96A4C38F906EFA133E95675D332279C89F999B1909ECF2EBCA7EC177ACED6EA56D1A72244145E377B7")
  .method("GET", null)
  .build();
Response response = client.newCall(request).execute();
Python
import http.client
import mimetypes
conn = http.client.HTTPSConnection("api-test.payvalida.com")
payload = ''
headers = {}
conn.request("GET", "/api/v3/porders/9022932?merchant=kuanto&checksum=7CA708050F7F5B3EB5B9FD271D375DCEFCA71BDEFDF91C96A4C38F906EFA133E95675D332279C89F999B1909ECF2EBCA7EC177ACED6EA56D1A72244145E377B7", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
JavaScript
var myHeaders = new Headers();
var requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
};
fetch("https://api-test.payvalida.com/api/v3/porders/9022932?merchant=kuanto&checksum=7CA708050F7F5B3EB5B9FD271D375DCEFCA71BDEFDF91C96A4C38F906EFA133E95675D332279C89F999B1909ECF2EBCA7EC177ACED6EA56D1A72244145E377B7", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

Registrar Información adicional

Próximo - ÓRDENES DE COMPRA

Actualizar

Última actualización 9mo ago

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

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	Tipo de moneda de pago.
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.
RESPONSE_CODE	DATA-TRANSACTION	string	Respuesta del procesamiento de la transacción.
QUOTES	DATA-TRANSACTION	string	Numero de cuotas en las que se realizo el pago.
ACCOUNT_TYPE	DATA-TRANSACTION	string	Tipo de cuenta con la que se realizo el pago.
CUS	DATA-TRANSACTION	string	Código único identificador de la transacción desde el recaudo.
INVOICE_NUMBER	DATA-TRANSACTION	string	Numero de factura generado.
FRANCHISE	DATA-TRANSACTION	string	Franquicia por la cual se realizo el pago.
RESPONSE	DATA-TRANSACTION	string	Respuesta del procesador de pago.
CARD_NUMBER	DATA-TRANSACTION	string	CVV1 o 4 últimos dígitos de la tarjeta si el pago fue por TC.
ERROR	DATA-TRANSACTION	string	Mensaje de error o aprobación al efectuar la compra.
ADITIONAL_INFO	DATA	string	Este arreglo es enviado únicamente cuando el campo aditionalinfo está presente en el request
CUS	DATA-ADITIONAL_INFO	string	Si el medio de pago fue PSE y fue una orden aprobada, este campo llegará con el código CUS de la transacción. De lo contrario, si se envía el campo aditionalinfo pero no cumple con las condiciones anteriores, llegará vacío.