> For the complete documentation index, see [llms.txt](https://docs.payvalida.com/api-suscripciones/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payvalida.com/api-suscripciones/suscripciones/cancelar-suscripcion.md). # Cancelar Suscripción {% hint style="info" %} Método: **DELETE** {% endhint %} {% hint style="success" %} **Producción:** {% endhint %} {% hint style="success" %} **Sandbox:** {% endhint %} {% tabs %} {% tab title="Request" %}
CampoTipoRequeridoDescripción
merchantstringsíNombre asignado para el comercio en Payválida. Se entrega con las credenciales.
idstringsíid de la suscripción que se quiere cancelar
checksumstringsí

Cadena de comprobación con SHA512 (merchant+id+FIXED_HASH)


{% endtab %} {% tab title="Request (ejemplo)" %} ```bash curl --location --request DELETE 'https://api-test.payvalida.com/v4/subscriptions' \ --header 'Content-Type: application/json' \ --data-raw '{ "id":"bbc10ac0-81f2-405b-9357-97a435800e95", "timestamp":1686943428, "merchant":"kuanto", "checksum":"31d056705df5318578bb923cced69edeb1e38fd394ac44498363f984256a7fe0fd8563f6ca736ecc8ad12cfddd38ba870755afd594c907e0771fb368329bed2e" }' ``` {% endtab %} {% tab title="Response" %} | Campo | Estructura | Tipo | Descripción | | ------------ | ---------- | ------ | ----------------------------------------- | | CODE | - | string | Código de respuesta **0000** para **OK.** | | DESC | - | string | Descripción de la respuesta. | | {% endtab %} | | | | {% tab title="Response (ejemplo)" %} ```json { "CODE": "0000", "DESC": "OK", } ``` {% endtab %} {% tab title="Cabeceras" %} | Cabecera | Valor | | ------------- | ---------------- | | Content-Type | application/json | | {% endtab %} | | | {% endtabs %} | | ## Ejemplos * Go ```go package main import ( "crypto/sha512" "encoding/hex" "fmt" "io/ioutil" "net/http" "strings" "time" ) func main() { url := "https://api-test.payvalida.com/v4/subscriptions" // Prepare the request payload payload := `{ "id":"bbc10ac0-81f2-405b-9357-97a435800e95", "merchant":"kuanto", "checksum":"31d056705df5318578bb923cced69edeb1e38fd394ac44498363f984256a7fe0fd8563f6ca736ecc8ad12cfddd38ba870755afd594c907e0771fb368329bed2e" }` // Create a new SHA-512 hasher hasher := sha512.New() // Concatenate the values to create the checksum hasher.Write([]byte("kuanto")) hasher.Write([]byte("bbc10ac0-81f2-405b-9357-97a435800e95")) hasher.Write([]byte("FIXED_HASH")) checksum := hex.EncodeToString(hasher.Sum(nil)) // Update the checksum value in the request payload payload = strings.Replace(payload, "31d056705df5318578bb923cced69edeb1e38fd394ac44498363f984256a7fe0fd8563f6ca736ecc8ad12cfddd38ba870755afd594c907e0771fb368329bed2e", checksum, 1) // Create an HTTP DELETE request req, err := http.NewRequest("DELETE", url, strings.NewReader(payload)) if err != nil { fmt.Println("Error creating request:", err) return } // Set the request headers req.Header.Set("Content-Type", "application/json") // Send the request and get the response client := &http.Client{} resp, err := client.Do(req) if err != nil { fmt.Println("Error sending request:", err) return } defer resp.Body.Close() // Read the response body body, err := ioutil.ReadAll(resp.Body) if err != nil { fmt.Println("Error reading response body:", err) return } // Print the response body fmt.Println("Response Body:", string(body)) } ``` * PHP ```php 'bbc10ac0-81f2-405b-9357-97a435800e95', 'merchant' => 'kuanto', 'checksum' => '31d056705df5318578bb923cced69edeb1e38fd394ac44498363f984256a7fe0fd8563f6ca736ecc8ad12cfddd38ba870755afd594c907e0771fb368329bed2e' ); // Create the checksum $data = $payload['merchant'] . $payload['id'] . 'FIXED_HASH'; $checksum = hash('sha512', $data); // Update the checksum value in the payload $payload['checksum'] = $checksum; // Convert the payload to JSON $jsonPayload = json_encode($payload); // Create cURL resource $ch = curl_init($url); // Set the request method to DELETE curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE'); // Set the request headers curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json')); // Set the request payload curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonPayload); // Set the option to receive the response as a string curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // Send the request and get the response $response = curl_exec($ch); // Close cURL resource curl_close($ch); // Print the response body echo 'Response Body: ' . $response . PHP_EOL; ?> ``` * Javascript ```javascript const https = require('https'); const crypto = require('crypto'); const url = 'https://api-test.payvalida.com/v4/subscriptions'; const merchant = 'kuanto'; const fixedHash = 'FIXED_HASH'; const checksum = createChecksum(merchant, fixedHash); const data = { id: 'bbc10ac0-81f2-405b-9357-97a435800e95', merchant: merchant, checksum: checksum }; const payload = JSON.stringify(data); const options = { method: 'POST', headers: { 'Content-Type': 'application/json' } }; const req = https.request(url, options, (res) => { let body = ''; res.on('data', (chunk) => { body += chunk; }); res.on('end', () => { console.log('Response:', body); }); }); req.on('error', (error) => { console.error('Failed to send request:', error); }); req.write(payload); req.end(); function createChecksum(merchant, fixedHash) { const data = merchant + fixedHash; const checksum = crypto.createHash('sha512').update(data).digest('hex'); return checksum; } ``` * Java ```java import java.io.BufferedReader; import java.io.IOException; import java.io.InputStreamReader; import java.io.OutputStream; import java.net.HttpURLConnection; import java.net.URL; import java.nio.charset.StandardCharsets; import java.security.MessageDigest; import java.security.NoSuchAlgorithmException; import java.time.Instant; public class Main { public static void main(String[] args) { String url = "https://api-test.payvalida.com/v4/subscriptions"; // Prepare the request payload String payload = "{\n" + " \"id\":\"bbc10ac0-81f2-405b-9357-97a435800e95\",\n" + " \"merchant\":\"kuanto\",\n" + " \"checksum\":\"31d056705df5318578bb923cced69edeb1e38fd394ac44498363f984256a7fe0fd8563f6ca736ecc8ad12cfddd38ba870755afd594c907e0771fb368329bed2e\"\n" + "}"; // Create the checksum String data = "kuanto" + "bbc10ac0-81f2-405b-9357-97a435800e95" + "FIXED_HASH"; String checksum = calculateSHA512(data); // Update the checksum value in the payload payload = payload.replace("31d056705df5318578bb923cced69edeb1e38fd394ac44498363f984256a7fe0fd8563f6ca736ecc8ad12cfddd38ba870755afd594c907e0771fb368329bed2e", checksum); try { // Create the DELETE request URL requestUrl = new URL(url); HttpURLConnection connection = (HttpURLConnection) requestUrl.openConnection(); connection.setRequestMethod("DELETE"); connection.setRequestProperty("Content-Type", "application/json"); connection.setDoOutput(true); // Set the request payload OutputStream outputStream = connection.getOutputStream(); byte[] payloadBytes = payload.getBytes(StandardCharsets.UTF_8); outputStream.write(payloadBytes); outputStream.close(); // Send the request and get the response int responseCode = connection.getResponseCode(); // Read the response body BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream())); String line; StringBuilder responseBody = new StringBuilder(); while ((line = reader.readLine()) != null) { responseBody.append(line); } reader.close(); // Print the response body System.out.println("Response Body: " + responseBody.toString()); // Close the connection connection.disconnect(); } catch (IOException e) { System.out.println("Error sending request: " + e.getMessage()); } } private static String calculateSHA512(String data) { try { MessageDigest digest = MessageDigest.getInstance("SHA-512"); byte[] hash = digest.digest(data.getBytes(StandardCharsets.UTF_8)); return bytesToHex(hash); } catch (NoSuchAlgorithmException e) { e.printStackTrace(); return null; } } private static String bytesToHex(byte[] bytes) { StringBuilder result = new StringBuilder(); for (byte b : bytes) { result.append(String.format("%02x", b)); } return result.toString(); } } ``` * Python ```python import hashlib import json import requests import time url = 'https://api-test.payvalida.com/v4/subscriptions' # Prepare the request payload payload = { 'id': 'bbc10ac0-81f2-405b-9357-97a435800e95', 'merchant': 'kuanto', 'checksum': '31d056705df5318578bb923cced69edeb1e38fd394ac44498363f984256a7fe0fd8563f6ca736ecc8ad12cfddd38ba870755afd594c907e0771fb368329bed2e' } # Create the checksum data = payload['merchant'] + payload['id'] + 'FIXED_HASH' checksum = hashlib.sha512(data.encode()).hexdigest() # Update the checksum value in the payload payload['checksum'] = checksum # Send the DELETE request headers = {'Content-Type': 'application/json'} response = requests.delete(url, headers=headers, json=payload) # Print the response body print('Response Body:', response.text) ```