POST
/cards/v1/batchesCrear Lote de Tarjetas Innominadas
El endpoint /cards/v1/batches te permite crear un lote de tarjetas innominadas.
Validaremos que cumplas los requisitos que detallamos en la documentación.
Consideraciones
- Cada lote tiene un máximo de 1.000 tarjetas.
- La dirección de envío es obligatoria si el tipo de distribución es
CLIENT. - Procesaremos la llamada de forma asincrónica, es decir que es posible que las tarjetas no estén disponibles inmediatamente.
Parámetros disponibles
Header Parameters
AuthorizationStringrequired
x-idempotency-keyStringrequired
Cuerpo de solicitud
application/jsonaffinity_group_idstringrequired
quantitynumberrequired
distribution_typeenumrequired
addressobject10 propiedades
receiverobject5 propiedades
Detalle de respuestas
401
No autorizado
403
Acceso denegado
Ejemplo de solicitud
{
"affinity_group_id": "afg-20MpN8vmIPj77ujhb9cS8ctstN2",
"quantity": 100,
"distribution_type": "CLIENT",
"address": {
"street_name": "Street",
"street_number": "123",
"floor": "5",
"apartment": "A",
"city": "Buenos Aires",
"region": "Buenos Aires",
"country": "Argentina",
"zip_code": "5653",
"neighborhood": "Palermo",
"additional_info": "Torre 2. Casa amarilla"
},
"receiver": {
"full_name": "Gonzalo Iglesias",
"email": "[email protected]",
"document_type": "DNI",
"document_number": "35354896",
"telephone_number": "1132421452"
}
}Ejemplo de código
curl -X POST "https://api.pomelo.la/cards/v1/batches" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-idempotency-key: fRwX12Dg3345AD" \
-d '{
"affinity_group_id": "afg-20MpN8vmIPj77ujhb9cS8ctstN2",
"quantity": 100,
"distribution_type": "CLIENT",
"address": {
"street_name": "Street",
"street_number": "123",
"floor": "5",
"apartment": "A",
"city": "Buenos Aires",
"region": "Buenos Aires",
"country": "Argentina",
"zip_code": "5653",
"neighborhood": "Palermo",
"additional_info": "Torre 2. Casa amarilla"
},
"receiver": {
"full_name": "Gonzalo Iglesias",
"email": "[email protected]",
"document_type": "DNI",
"document_number": "35354896",
"telephone_number": "1132421452"
}
}'Ejemplo de respuesta (202)Batch de tarjetas aceptado
{
"data": {
"shipment_id": "shi-16281925351057V5BKK",
"affinity_group_id": "afg-20MpN8vmIPj77ujhb9cS8ctstN2",
"card_type": "PHYSICAL",
"quantity": 100,
"distribution_type": "CLIENT"
}
}