Transacción

Esta operación consiste en realizar el registro de la transacción consultada. Para esta operación solo realizara el registro y para que se haga efectiva se debe realizar la confirmación.

Producción: https://cashin.payvalida.com/v1/transactions/

Sandbox: https://sandbox-cashin.payvalida.com/v1/transactions/

Request

Campo	Tipo	Requerido	Descripción
name	string	si	Nombre de la Red de Recaudo.
checksum	string	si	Cadena de comprobación, calculada con SHA512(name + reference + amount + transaction + FIXED_HASH)
reference	string	si	Referencia de pago.
amount	string	si	Monto de la transacción. Debe ser igual al monto retornado en la consulta. a menos que la consulta sea de monto abierto (0) en cuyo caso este monto debe ser mayor.
transaction	string	si	ID único de transacción para la red de recaudo
commerce	string	no	Nombre del comercio sobre el que se esta realizando la transacción.
teller	string	si	Identificación del punto de recaudo. (ip o punto de venta).
money	string	si	Moneda de la transacción (Moneda - ISO) **
nombres	string	no	nombre del usuario.
apellido1	string	no	apellido 1 del usuario.
apellido2	string	no	apellido 2 del usuario.

Request (ejemplo)

curl --location --request POST 'https://sandbox-cashin.payvalida.com/v1/transactions/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "BEVALIDA_343",
    "reference": "9999999999",
    "amount": "45000",
    "transaction": "129999999",
    "commerce": "Payvalida",
    "teller": "1.1.1.1",
    "money": "COP",
    "checksum": "11C4152A38CFE360EE83AB6B991B715774DCE6810BB4DF9F8A91FD79BFC20235CBCD107BC1DC392A43E5D185174978CBAA0874C207CFBDF02D0D63FD504A7E43"
}'

Response

Campo	Estructura	Tipo	Descripción
CODE	-	string	Código de respuesta 0000 para OK.
TEXT	-	string	Descripción de la respuesta.
DATA	-	-	Contiene los datos de la transacción
AMOUNT	DATA	double	Confirmación del monto de la transacción.
DESCRIPTION	DATA	string	Descripción de la transacción (datos del cliente para recaudos o descripción del producto para compras).
REFERENCE	DATA	string	Confirmación del número de referencia.
IDTRANSACTION	DATA	string	Confirmación del id de transacción enviado por la red.
IDPAYVALIDA	DATA	string	código de la operación en Payvalida.
COMMERCE	DATA	string	Nombre del comercio que registra la transacción

Response (ejemplo)

{
    "CODE": "0000",
    "TEXT": "OK",
    "DATA": {
        "AMOUNT": 45000.0,
        "DESCRIPTION": "Cliente Payvalida Test([e-mail])",
        "REFERENCE": "9999999999",
        "IDTRANSACTION": "129999999",
        "IDPAYVALIDA": "47961",
        "COMMERCE": "Payvalida"
    }
}

Cabeceras

Cabecera	Valor
Content-Type	application/json

** Los códigos de moneda:

Código de moneda	Moneda - ISO	Pais
343	COP	🇨🇴 Colombia
314	CRC	🇨🇷 Costa Rica
345	USD	🇪🇨 Ecuador
348	PEN	🇵🇪 Perú

Ejemplos:

• GO

package main
import (
	"bytes"
	"crypto/sha512"
	"encoding/hex"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)
type Request struct {
	Name        string `json:"name,omitempty"`
	Checksum    string `json:"checksum,omitempty"`
	Reference   string `json:"reference,omitempty"`
	Amount      string `json:"amount,omitempty"`
	Transaction string `json:"transaction,omitempty"`
	Commerce    string `json:"commerce,omitempty"`
	Teller      string `json:"teller,omitempty"`
	Money       string `json:"money,omitempty"`
	Nombres     string `json:"nombres,omitempty"`
	Apellido1   string `json:"apellido1,omitempty"`
	Apellido2   string `json:"apellido2,omitempty"`
}
func main() {
	url := "https://sandbox-cashin.payvalida.com/v1/transactions/"
	method := "POST"
	red := "BEVALIDA_343" //cambiar por el nombre de la red
	amount := "45000"
	reference := "9999999999"
	transaction := "129999999"
	fixedHash := "COMPLETAR" //Completar con la credencial asignada por payvalida
	key := sha512.Sum512([]byte(red + reference + amount + transaction + fixedHash))
	checksum := hex.EncodeToString(key[:])
	request := Request{
		Name:        red,
		Checksum:    checksum,
		Reference:   reference,
		Amount:      amount,
		Transaction: transaction,
		Commerce:    "Payvalida",
		Teller:      "1.1.1.1",
		Money:       "COP",
		Nombres:     "nombre1",
		Apellido1:   "apellido1",
		Apellido2:   "apellido2",
	}
	json, err := json.Marshal(request)
	if err != nil {
		fmt.Println(err)
		return
	}
	client := &http.Client{}
	req, err := http.NewRequest(method, url, bytes.NewBuffer(json))
	if err != nil {
		fmt.Println(err)
		return
	}
	req.Header.Add("Content-Type", "application/json")
	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://sandbox-cashin.payvalida.com/v1/transactions/",
  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 =>"{\n    \"name\": \"BEVALIDA_343\",\n    \"reference\": \"9999999999\",\n    \"amount\": \"45000\",\n    \"transaction\": \"129999999\",\n    \"commerce\": \"Payvalida\",\n    \"teller\": \"1.1.1.1\",\n    \"money\": \"COP\",\n    \"checksum\": \"11C4152A38CFE360EE83AB6B991B715774DCE6810BB4DF9F8A91FD79BFC20235CBCD107BC1DC392A43E5D185174978CBAA0874C207CFBDF02D0D63FD504A7E43\"\n}",
  CURLOPT_HTTPHEADER => array(
    "Content-Type: application/json"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

• JAVA

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n    \"name\": \"BEVALIDA_343\",\n    \"reference\": \"9999999999\",\n    \"amount\": \"45000\",\n    \"transaction\": \"129999999\",\n    \"commerce\": \"Payvalida\",\n    \"teller\": \"1.1.1.1\",\n    \"money\": \"COP\",\n    \"checksum\": \"11C4152A38CFE360EE83AB6B991B715774DCE6810BB4DF9F8A91FD79BFC20235CBCD107BC1DC392A43E5D185174978CBAA0874C207CFBDF02D0D63FD504A7E43\"\n}");
Request request = new Request.Builder()
  .url("https://sandbox-cashin.payvalida.com/v1/transactions/")
  .method("POST", body)
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

• PYTHON

import http.client
import mimetypes
conn = http.client.HTTPSConnection("sandbox-cashin.payvalida.com")
payload = "{\n    \"name\": \"BEVALIDA_343\",\n    \"reference\": \"9999999999\",\n    \"amount\": \"45000\",\n    \"transaction\": \"129999999\",\n    \"commerce\": \"Payvalida\",\n    \"teller\": \"1.1.1.1\",\n    \"money\": \"COP\",\n    \"checksum\": \"11C4152A38CFE360EE83AB6B991B715774DCE6810BB4DF9F8A91FD79BFC20235CBCD107BC1DC392A43E5D185174978CBAA0874C207CFBDF02D0D63FD504A7E43\"\n}"
headers = {
  'Content-Type': 'application/json'
}
conn.request("POST", "/v1/transactions/", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))