Sumar puntos a un cliente por una compra
curl --request POST \
--url https://api.tiendadepuntos.com/external/tags/add \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"amount": 50,
"client": {
"email": "juanma@mailinator.com",
"dni": "40100800",
"first_name": "Juan Manuel",
"last_name": "Pérez",
"phone": "+541164593678",
"birthday": "1990-01-01T00:00:00.000Z",
"gender": 0
},
"branch_id": 1972,
"external_id": "FAC-A-0001-00012345",
"reason": "Suma por compra de 2 medialunas y un cafe latte",
"giftCards": [
{
"clientMail": "exampleMail@tiendadepuntos.com",
"points": {
"selectedRewardType": "points",
"amount": 50,
"pointItemsIds": [
123
],
"pointsToGive": 100,
"reason": "Se entregan 500 puntos por comprar un cafe cuyo valor fue de $50"
},
"applyBonus": {
"applyLevelPointsBonus": true,
"applyPointRulesBonus": true
}
}
],
"ignoreCreateClient": false,
"origin": "external-integration"
}
'import requests
url = "https://api.tiendadepuntos.com/external/tags/add"
payload = {
"amount": 50,
"client": {
"email": "juanma@mailinator.com",
"dni": "40100800",
"first_name": "Juan Manuel",
"last_name": "Pérez",
"phone": "+541164593678",
"birthday": "1990-01-01T00:00:00.000Z",
"gender": 0
},
"branch_id": 1972,
"external_id": "FAC-A-0001-00012345",
"reason": "Suma por compra de 2 medialunas y un cafe latte",
"giftCards": [
{
"clientMail": "exampleMail@tiendadepuntos.com",
"points": {
"selectedRewardType": "points",
"amount": 50,
"pointItemsIds": [123],
"pointsToGive": 100,
"reason": "Se entregan 500 puntos por comprar un cafe cuyo valor fue de $50"
},
"applyBonus": {
"applyLevelPointsBonus": True,
"applyPointRulesBonus": True
}
}
],
"ignoreCreateClient": False,
"origin": "external-integration"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 50,
client: {
email: 'juanma@mailinator.com',
dni: '40100800',
first_name: 'Juan Manuel',
last_name: 'Pérez',
phone: '+541164593678',
birthday: '1990-01-01T00:00:00.000Z',
gender: 0
},
branch_id: 1972,
external_id: 'FAC-A-0001-00012345',
reason: 'Suma por compra de 2 medialunas y un cafe latte',
giftCards: [
{
clientMail: 'exampleMail@tiendadepuntos.com',
points: {
selectedRewardType: 'points',
amount: 50,
pointItemsIds: [123],
pointsToGive: 100,
reason: 'Se entregan 500 puntos por comprar un cafe cuyo valor fue de $50'
},
applyBonus: {applyLevelPointsBonus: true, applyPointRulesBonus: true}
}
],
ignoreCreateClient: false,
origin: 'external-integration'
})
};
fetch('https://api.tiendadepuntos.com/external/tags/add', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tiendadepuntos.com/external/tags/add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'amount' => 50,
'client' => [
'email' => 'juanma@mailinator.com',
'dni' => '40100800',
'first_name' => 'Juan Manuel',
'last_name' => 'Pérez',
'phone' => '+541164593678',
'birthday' => '1990-01-01T00:00:00.000Z',
'gender' => 0
],
'branch_id' => 1972,
'external_id' => 'FAC-A-0001-00012345',
'reason' => 'Suma por compra de 2 medialunas y un cafe latte',
'giftCards' => [
[
'clientMail' => 'exampleMail@tiendadepuntos.com',
'points' => [
'selectedRewardType' => 'points',
'amount' => 50,
'pointItemsIds' => [
123
],
'pointsToGive' => 100,
'reason' => 'Se entregan 500 puntos por comprar un cafe cuyo valor fue de $50'
],
'applyBonus' => [
'applyLevelPointsBonus' => true,
'applyPointRulesBonus' => true
]
]
],
'ignoreCreateClient' => false,
'origin' => 'external-integration'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tiendadepuntos.com/external/tags/add"
payload := strings.NewReader("{\n \"amount\": 50,\n \"client\": {\n \"email\": \"juanma@mailinator.com\",\n \"dni\": \"40100800\",\n \"first_name\": \"Juan Manuel\",\n \"last_name\": \"Pérez\",\n \"phone\": \"+541164593678\",\n \"birthday\": \"1990-01-01T00:00:00.000Z\",\n \"gender\": 0\n },\n \"branch_id\": 1972,\n \"external_id\": \"FAC-A-0001-00012345\",\n \"reason\": \"Suma por compra de 2 medialunas y un cafe latte\",\n \"giftCards\": [\n {\n \"clientMail\": \"exampleMail@tiendadepuntos.com\",\n \"points\": {\n \"selectedRewardType\": \"points\",\n \"amount\": 50,\n \"pointItemsIds\": [\n 123\n ],\n \"pointsToGive\": 100,\n \"reason\": \"Se entregan 500 puntos por comprar un cafe cuyo valor fue de $50\"\n },\n \"applyBonus\": {\n \"applyLevelPointsBonus\": true,\n \"applyPointRulesBonus\": true\n }\n }\n ],\n \"ignoreCreateClient\": false,\n \"origin\": \"external-integration\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.tiendadepuntos.com/external/tags/add")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 50,\n \"client\": {\n \"email\": \"juanma@mailinator.com\",\n \"dni\": \"40100800\",\n \"first_name\": \"Juan Manuel\",\n \"last_name\": \"Pérez\",\n \"phone\": \"+541164593678\",\n \"birthday\": \"1990-01-01T00:00:00.000Z\",\n \"gender\": 0\n },\n \"branch_id\": 1972,\n \"external_id\": \"FAC-A-0001-00012345\",\n \"reason\": \"Suma por compra de 2 medialunas y un cafe latte\",\n \"giftCards\": [\n {\n \"clientMail\": \"exampleMail@tiendadepuntos.com\",\n \"points\": {\n \"selectedRewardType\": \"points\",\n \"amount\": 50,\n \"pointItemsIds\": [\n 123\n ],\n \"pointsToGive\": 100,\n \"reason\": \"Se entregan 500 puntos por comprar un cafe cuyo valor fue de $50\"\n },\n \"applyBonus\": {\n \"applyLevelPointsBonus\": true,\n \"applyPointRulesBonus\": true\n }\n }\n ],\n \"ignoreCreateClient\": false,\n \"origin\": \"external-integration\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tiendadepuntos.com/external/tags/add")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 50,\n \"client\": {\n \"email\": \"juanma@mailinator.com\",\n \"dni\": \"40100800\",\n \"first_name\": \"Juan Manuel\",\n \"last_name\": \"Pérez\",\n \"phone\": \"+541164593678\",\n \"birthday\": \"1990-01-01T00:00:00.000Z\",\n \"gender\": 0\n },\n \"branch_id\": 1972,\n \"external_id\": \"FAC-A-0001-00012345\",\n \"reason\": \"Suma por compra de 2 medialunas y un cafe latte\",\n \"giftCards\": [\n {\n \"clientMail\": \"exampleMail@tiendadepuntos.com\",\n \"points\": {\n \"selectedRewardType\": \"points\",\n \"amount\": 50,\n \"pointItemsIds\": [\n 123\n ],\n \"pointsToGive\": 100,\n \"reason\": \"Se entregan 500 puntos por comprar un cafe cuyo valor fue de $50\"\n },\n \"applyBonus\": {\n \"applyLevelPointsBonus\": true,\n \"applyPointRulesBonus\": true\n }\n }\n ],\n \"ignoreCreateClient\": false,\n \"origin\": \"external-integration\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"status": 201,
"message": "Request was successful",
"data": {
"pointOperationId": 998877,
"clientId": 84213,
"points": {
"amount": 50,
"totalPointsToGive": 55,
"initialPointsToGive": 50
}
}
}{
"statusCode": 400,
"timestamp": "2026-07-31T14:05:12.431Z",
"path": "/external/tags/add",
"method": "POST",
"message": "Error de validación",
"errors": [
{}
],
"data": {}
}{
"statusCode": 403,
"timestamp": "2026-07-31T14:05:12.431Z",
"path": "/external/tags/add",
"method": "POST",
"message": "Branch with id 1972 does not belong to business with id 42",
"errors": [
{}
],
"data": {}
}{
"statusCode": 404,
"timestamp": "2026-07-31T14:05:12.431Z",
"path": "/external/tags/add",
"method": "POST",
"message": "Api Key is required",
"errors": [
{}
],
"data": {}
}{
"statusCode": 409,
"timestamp": "2026-07-31T14:05:12.431Z",
"path": "/external/tags/add",
"method": "POST",
"message": "Ya existe una operación de puntos con el externalId FAC-A-0001-00012345 para este negocio",
"errors": [
{}
],
"data": {}
}Puntos
Sumar puntos a un cliente por una compra
Acredita puntos de forma inmediata a partir del monto de una compra. Es el endpoint principal para integrar un POS o ERP.
El cliente se identifica por email o dni. Si no existe, se crea automáticamente, salvo que se mande ignoreCreateClient: true.
Idempotencia: mandá siempre external_id con el identificador de la venta en tu sistema (número de factura, id de ticket). Si llega un external_id que ya tiene una operación activa, la API responde 409 en vez de duplicar los puntos. Ese mismo external_id es el que se usa para cancelar la operación después.
POST
/
external
/
tags
/
add
Sumar puntos a un cliente por una compra
curl --request POST \
--url https://api.tiendadepuntos.com/external/tags/add \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"amount": 50,
"client": {
"email": "juanma@mailinator.com",
"dni": "40100800",
"first_name": "Juan Manuel",
"last_name": "Pérez",
"phone": "+541164593678",
"birthday": "1990-01-01T00:00:00.000Z",
"gender": 0
},
"branch_id": 1972,
"external_id": "FAC-A-0001-00012345",
"reason": "Suma por compra de 2 medialunas y un cafe latte",
"giftCards": [
{
"clientMail": "exampleMail@tiendadepuntos.com",
"points": {
"selectedRewardType": "points",
"amount": 50,
"pointItemsIds": [
123
],
"pointsToGive": 100,
"reason": "Se entregan 500 puntos por comprar un cafe cuyo valor fue de $50"
},
"applyBonus": {
"applyLevelPointsBonus": true,
"applyPointRulesBonus": true
}
}
],
"ignoreCreateClient": false,
"origin": "external-integration"
}
'import requests
url = "https://api.tiendadepuntos.com/external/tags/add"
payload = {
"amount": 50,
"client": {
"email": "juanma@mailinator.com",
"dni": "40100800",
"first_name": "Juan Manuel",
"last_name": "Pérez",
"phone": "+541164593678",
"birthday": "1990-01-01T00:00:00.000Z",
"gender": 0
},
"branch_id": 1972,
"external_id": "FAC-A-0001-00012345",
"reason": "Suma por compra de 2 medialunas y un cafe latte",
"giftCards": [
{
"clientMail": "exampleMail@tiendadepuntos.com",
"points": {
"selectedRewardType": "points",
"amount": 50,
"pointItemsIds": [123],
"pointsToGive": 100,
"reason": "Se entregan 500 puntos por comprar un cafe cuyo valor fue de $50"
},
"applyBonus": {
"applyLevelPointsBonus": True,
"applyPointRulesBonus": True
}
}
],
"ignoreCreateClient": False,
"origin": "external-integration"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 50,
client: {
email: 'juanma@mailinator.com',
dni: '40100800',
first_name: 'Juan Manuel',
last_name: 'Pérez',
phone: '+541164593678',
birthday: '1990-01-01T00:00:00.000Z',
gender: 0
},
branch_id: 1972,
external_id: 'FAC-A-0001-00012345',
reason: 'Suma por compra de 2 medialunas y un cafe latte',
giftCards: [
{
clientMail: 'exampleMail@tiendadepuntos.com',
points: {
selectedRewardType: 'points',
amount: 50,
pointItemsIds: [123],
pointsToGive: 100,
reason: 'Se entregan 500 puntos por comprar un cafe cuyo valor fue de $50'
},
applyBonus: {applyLevelPointsBonus: true, applyPointRulesBonus: true}
}
],
ignoreCreateClient: false,
origin: 'external-integration'
})
};
fetch('https://api.tiendadepuntos.com/external/tags/add', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tiendadepuntos.com/external/tags/add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'amount' => 50,
'client' => [
'email' => 'juanma@mailinator.com',
'dni' => '40100800',
'first_name' => 'Juan Manuel',
'last_name' => 'Pérez',
'phone' => '+541164593678',
'birthday' => '1990-01-01T00:00:00.000Z',
'gender' => 0
],
'branch_id' => 1972,
'external_id' => 'FAC-A-0001-00012345',
'reason' => 'Suma por compra de 2 medialunas y un cafe latte',
'giftCards' => [
[
'clientMail' => 'exampleMail@tiendadepuntos.com',
'points' => [
'selectedRewardType' => 'points',
'amount' => 50,
'pointItemsIds' => [
123
],
'pointsToGive' => 100,
'reason' => 'Se entregan 500 puntos por comprar un cafe cuyo valor fue de $50'
],
'applyBonus' => [
'applyLevelPointsBonus' => true,
'applyPointRulesBonus' => true
]
]
],
'ignoreCreateClient' => false,
'origin' => 'external-integration'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tiendadepuntos.com/external/tags/add"
payload := strings.NewReader("{\n \"amount\": 50,\n \"client\": {\n \"email\": \"juanma@mailinator.com\",\n \"dni\": \"40100800\",\n \"first_name\": \"Juan Manuel\",\n \"last_name\": \"Pérez\",\n \"phone\": \"+541164593678\",\n \"birthday\": \"1990-01-01T00:00:00.000Z\",\n \"gender\": 0\n },\n \"branch_id\": 1972,\n \"external_id\": \"FAC-A-0001-00012345\",\n \"reason\": \"Suma por compra de 2 medialunas y un cafe latte\",\n \"giftCards\": [\n {\n \"clientMail\": \"exampleMail@tiendadepuntos.com\",\n \"points\": {\n \"selectedRewardType\": \"points\",\n \"amount\": 50,\n \"pointItemsIds\": [\n 123\n ],\n \"pointsToGive\": 100,\n \"reason\": \"Se entregan 500 puntos por comprar un cafe cuyo valor fue de $50\"\n },\n \"applyBonus\": {\n \"applyLevelPointsBonus\": true,\n \"applyPointRulesBonus\": true\n }\n }\n ],\n \"ignoreCreateClient\": false,\n \"origin\": \"external-integration\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.tiendadepuntos.com/external/tags/add")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 50,\n \"client\": {\n \"email\": \"juanma@mailinator.com\",\n \"dni\": \"40100800\",\n \"first_name\": \"Juan Manuel\",\n \"last_name\": \"Pérez\",\n \"phone\": \"+541164593678\",\n \"birthday\": \"1990-01-01T00:00:00.000Z\",\n \"gender\": 0\n },\n \"branch_id\": 1972,\n \"external_id\": \"FAC-A-0001-00012345\",\n \"reason\": \"Suma por compra de 2 medialunas y un cafe latte\",\n \"giftCards\": [\n {\n \"clientMail\": \"exampleMail@tiendadepuntos.com\",\n \"points\": {\n \"selectedRewardType\": \"points\",\n \"amount\": 50,\n \"pointItemsIds\": [\n 123\n ],\n \"pointsToGive\": 100,\n \"reason\": \"Se entregan 500 puntos por comprar un cafe cuyo valor fue de $50\"\n },\n \"applyBonus\": {\n \"applyLevelPointsBonus\": true,\n \"applyPointRulesBonus\": true\n }\n }\n ],\n \"ignoreCreateClient\": false,\n \"origin\": \"external-integration\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tiendadepuntos.com/external/tags/add")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 50,\n \"client\": {\n \"email\": \"juanma@mailinator.com\",\n \"dni\": \"40100800\",\n \"first_name\": \"Juan Manuel\",\n \"last_name\": \"Pérez\",\n \"phone\": \"+541164593678\",\n \"birthday\": \"1990-01-01T00:00:00.000Z\",\n \"gender\": 0\n },\n \"branch_id\": 1972,\n \"external_id\": \"FAC-A-0001-00012345\",\n \"reason\": \"Suma por compra de 2 medialunas y un cafe latte\",\n \"giftCards\": [\n {\n \"clientMail\": \"exampleMail@tiendadepuntos.com\",\n \"points\": {\n \"selectedRewardType\": \"points\",\n \"amount\": 50,\n \"pointItemsIds\": [\n 123\n ],\n \"pointsToGive\": 100,\n \"reason\": \"Se entregan 500 puntos por comprar un cafe cuyo valor fue de $50\"\n },\n \"applyBonus\": {\n \"applyLevelPointsBonus\": true,\n \"applyPointRulesBonus\": true\n }\n }\n ],\n \"ignoreCreateClient\": false,\n \"origin\": \"external-integration\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"status": 201,
"message": "Request was successful",
"data": {
"pointOperationId": 998877,
"clientId": 84213,
"points": {
"amount": 50,
"totalPointsToGive": 55,
"initialPointsToGive": 50
}
}
}{
"statusCode": 400,
"timestamp": "2026-07-31T14:05:12.431Z",
"path": "/external/tags/add",
"method": "POST",
"message": "Error de validación",
"errors": [
{}
],
"data": {}
}{
"statusCode": 403,
"timestamp": "2026-07-31T14:05:12.431Z",
"path": "/external/tags/add",
"method": "POST",
"message": "Branch with id 1972 does not belong to business with id 42",
"errors": [
{}
],
"data": {}
}{
"statusCode": 404,
"timestamp": "2026-07-31T14:05:12.431Z",
"path": "/external/tags/add",
"method": "POST",
"message": "Api Key is required",
"errors": [
{}
],
"data": {}
}{
"statusCode": 409,
"timestamp": "2026-07-31T14:05:12.431Z",
"path": "/external/tags/add",
"method": "POST",
"message": "Ya existe una operación de puntos con el externalId FAC-A-0001-00012345 para este negocio",
"errors": [
{}
],
"data": {}
}Authorizations
API key del comercio. Se genera desde el panel de Tienda de Puntos, en Configuración → Integraciones.
Body
application/json
Monto de la compra en pesos. La conversión a puntos la define la regla de puntos configurada por el comercio.
Example:
50
Datos del cliente que hizo la compra.
Show child attributes
Show child attributes
Datos del operador o cajero que registró la venta.
Show child attributes
Show child attributes
ID de la sucursal donde se hizo la compra. Se obtiene de GET /external/branch. Debe pertenecer al comercio de la API key.
Example:
1972
Identificador de la transacción en tu sistema (número de factura, id de ticket). Es la clave de idempotencia: si repetís un external_id que ya tiene una operación activa, la API responde 409 en vez de duplicar los puntos. También es el identificador con el que después se cancela la operación.
Example:
"FAC-A-0001-00012345"
Observaciones de la suma de puntos.
Example:
"Suma por compra de 2 medialunas y un cafe latte"
Bonificaciones a aplicar sobre los puntos base. Si se omite, no se aplica ninguna.
Show child attributes
Show child attributes
Gift cards de regalo para otro cliente.
Show child attributes
Show child attributes
Si llega en true y el cliente no existe, la operación falla en vez de darlo de alta automáticamente.
Example:
false
Sistema desde el que se originó la operación. Se usa para trazabilidad en los reportes. Si integrás un sistema propio, usá external-integration.
Available options:
external-integration, dragonfish, fudo, centum, contabilium, tiendanube, woocommerce, shopify, desktop-app, dux Example:
"external-integration"
⌘I