POST
/cards/v1/Crear Tarjeta
El endpoint /cards/v1/ permite crear una nueva tarjeta nominada que puede ser física o virtual.
Validaremos que cumplas los requisitos que detallamos en la documentación.
Parámetros disponibles
Header Parameters
AuthorizationStringrequired
x-idempotency-keyStringrequired
Cuerpo de solicitud
application/jsonuser_idstringrequired
affinity_group_idstringrequired
card_typestringrequired
addressobject10 propiedades
companystring
previous_card_idstring
parent_idstring
pinstring
name_on_cardstring
Detalle de respuestas
401
No autorizado
403
Acceso denegado
Ejemplo de solicitud
{
"user_id": "usr-5BERfwA0nyGFI4Wn8a5y3yv3IGW",
"affinity_group_id": "afg-20MpN8vmIPj77ujhb9cS8ctstN2",
"card_type": "PHYSICAL",
"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"
},
"company": "Pomelo",
"previous_card_id": "crd-20gRqyp809SvDzXzhSeG2w6UiO5",
"parent_id": "crd-20gRqyp809SvDzXzhSeG2w6UiO5",
"pin": "2023",
"name_on_card": "Dieguito"
}Ejemplo de código
curl -X POST "https://api.pomelo.la/cards/v1/" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-idempotency-key: fRwX12Dg3345AD" \
-d '{
"user_id": "usr-5BERfwA0nyGFI4Wn8a5y3yv3IGW",
"affinity_group_id": "afg-20MpN8vmIPj77ujhb9cS8ctstN2",
"card_type": "PHYSICAL",
"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"
},
"company": "Pomelo",
"previous_card_id": "crd-20gRqyp809SvDzXzhSeG2w6UiO5",
"parent_id": "crd-20gRqyp809SvDzXzhSeG2w6UiO5",
"pin": "2023",
"name_on_card": "Dieguito"
}'Ejemplo de respuesta (201)Tarjeta creada
{
"data": {
"id": "crd-20gRqyp809SvDzXzhSeG2w6UiO5",
"affinity_group_id": "afg-20MpN8vmIPj77ujhb9cS8ctstN2",
"card_type": "VIRTUAL",
"product_type": "PREPAID",
"status": "ACTIVE",
"status_detail": "CLIENT_INTERNAL_REASON",
"shipment_id": "shi-2VOLbX1fAeWAn1rABlorxBqRyGF",
"user_id": "usr-5BERfwA0nyGFI4Wn8a5y3yv3IGW",
"start_date": "2021-11-08",
"last_four": "1573",
"provider": "MASTERCARD",
"affinity_group_name": "VIRTUAL_TEST",
"company": "Pomelo",
"name_on_card": "Dieguito",
"parent_id": "crd-20gRqyp809SvDzXzhSeG2w6UiO5"
}
}