Consultar

Consulta los detalles de una orden registrada.
Request
Request (ejemplo)
Response
Response(ejemplo)
Request

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).

Request (ejemplo)
curl --location --request GET 'https://api-test.payvalida.com/api/v3/porders/9022932?merchant=kuanto&checksum=7CA708050F7F5B3EB5B9FD271D375DCEFCA71BDEFDF91C96A4C38F906EFA133E95675D332279C89F999B1909ECF2EBCA7EC177ACED6EA56D1A72244145E377B7'
Response

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.

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.

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.

Response(ejemplo)
{
"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": "Aprobada"
}
}
}

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));