Lo primero es validar el o los sets de atributos personalizados para ventas que el merchant tenga creados esto se puede realizar mediante el endpoint Get Checkout Custom Attribute Sets.
Request:
{
"entries":
[
{
"_id":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"name":"Set_API_Multivende",
"position":0
}
],
"pagination":
{
"offset":0,
"limit":50,
"total_pages":1,
"current_page":1,
"next_page":0,
"previous_page":0,
"total_items":1
}
}
Una vez obtenido el set de atributos, podrás consultar los atributos que contiene utilizando el endpoint Get Checkouts Custom Attributes, el cual te mostrará todos los atributos personalizados de venta asociados a dicho set.
{
"entries":
[
{
"_id":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"name":"Atributo_API",
"code":"atributo_api",
"description":null,
"position":0,
"tags":null,
"status":"created",
"createdAt":"2025-11-10T15:37:25.000Z",
"updatedAt":"2025-11-10T15:37:25.000Z",
"MerchantId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"CustomAttributeSetId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"CustomAttributeScopeId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"CustomAttributeTypeId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"CustomAttributeSpecificityId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"CreatedById":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"UpdatedById":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"CustomAttributeOptions":[]
}
],
"pagination":{
"offset":0,
"limit":50,
"total_pages":1,
"current_page":1,
"next_page":0,
"previous_page":0,
"total_items":1
}
}
Si deseas editar o asignar un valor a un atributo dentro de una venta, puedes hacerlo a través del endpoint Update Checkout Custom Attribute Values.
En este caso, deberás enviar en el body el CustomAttributeId del atributo que quieres modificar y el CustomAttributeOptionId correspondiente a la opción que deseas asignar.
curl--location--requestPUT
\'https://app.multivende.com/api/checkouts/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/custom-attributes-values/upsert'\
--header'Content-Type: application/json'
\
--header'Authorization: Bearer (TOKEN)'
\
--data'{
"CustomAttributeValues":
{
"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX":"Texto Simple"
}}'
[
{
"_id":
"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"position":
0,
"status":
"created",
"CustomAttributeId":
"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"MerchantId":
"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"CreatedById":
"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"UpdatedById":
"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"CheckoutId":
"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"text":
"Texto Simple",
"updatedAt":
"2025-11-10T15:41:00.000Z",
"createdAt":
"2025-11-10T15:41:00.000Z"
}]
Equipo Integraciones API Multivende
0 comentarios
El artículo está cerrado para comentarios.