Servicio de consulta de tarjetas
Esta sección explica bajo el contexto de pago. Consulte el flujo para obtener más detalles.
A partir de un pago NIT con estado NOV (nuevo) , es posible consultar el BIN (primeros seis dígitos) de la tarjeta en SiTef para obtener datos sobre sus capacidades (posibilidad de pago a plazos, cuotas máximas, seguridad requisito de código, etc.), o incluso saber qué autoridad autorizadora de la tienda es la más adecuada para realizar el pago.
En el caso de transacciones de Visa Checkout, este servicio también devolverá los datos de la tarjeta y del usuario devueltos por Visa.
#
FlujoDescripción del flujo:
- El comerciante crea una transacción en Pagao Online, pasando información como el código de la tienda, el número de cuotas y el código de pedido y obtiene un NIT (Número de identificación de la transacción) en respuesta.
- El comerciante envía el NIT obtenido en el paso anterior y los datos de la tarjeta a consultar. Como resultado, Portal Carat devuelve datos sobre las capacidades de la tarjeta enviada.
- La tienda virtual luego procede a consumir el servicio de procesamiento de pagos, pasando el NIT y los datos de la tarjeta del comprador. Si tiene éxito, la transacción de pago cambiará su estado a "CON" (confirmado).
#
Detalles de la llamada- Recurso:
/ v1 / payments / {nit} / cards
- Método HTTP:
POST
- Formato de solicitud:
JSON
- Formato de respuesta:
JSON
- Parámetros de encabezado:
Parámetro | Descripción | Formato | Obligatorio |
---|---|---|---|
merchant_id | Código de tienda en el Portal Carat. Los códigos de producción y certificación serán diferentes. | < 15 AN | SI |
merchant_key | Clave de autenticación para la tienda de pagos online. Las claves de producción y certificación serán diferentes. | < 80 AN | SI |
Content-Type | Debe enviarse con el valor application / json . | = 15 AN | SI |
Obs.: a pesar de ser una consulta, se eligió el método POST por razones de seguridad.
#
EjemplosA continuación, se muestran algunos ejemplos de llamadas al servicio de búsqueda de tarjetas con la herramienta cURL.
#
Consulta de tarjeta con envío de autorizaciónSolicitud:
Respuesta:
#
Consulta de tarjeta sin envío de autorizaciónSolicitud:
Respuesta:
#
Consulta sobre la tarjeta Visa CheckoutSolicitud:
Respuesta:
#
Consulta de tarjetas con planes de financiaciónSolicitud:
Respuesta:
#
Búsqueda de tarjetas con datos adicionales para el enrutamiento de iCards a través de SiTefSolicitud:
Respuesta:
#
Consulta de tarjetas con datos adicionales para el enrutamiento de IPGSolicitud:
Respuesta:
Códigos de respuesta
Ver referencia en Códigos API - Códigos de respuesta
#
Parámetros de solicitudEn la siguiente tabla, hay una descripción de los parámetros de solicitud para el servicio de consultade tarjetas:
Parámetro | Descripción | Formato | Obligatorio |
---|---|---|---|
authorizer_id | Código de autorizador en el Portal Carat. [Más información.] (Authorizadoras.md) Este campo solo es obligatorio si se envía el campo wallet_transaction_id . Si este campo no se envía, Portal Carat asume que es una tarjeta de crédito | < 3 N | COND. |
routing_id | Código de ruta en el Portal Carat. Este campo solo es necesario para obtener datos adicionales de IPG. | < 3 N | COND. |
card | |||
number | Número de tarjeta del comprador (PAN). | < 19 N | SI |
token | HASH de una tarjeta almacenada en Portal Carat. No está permitido enviar un número de tarjeta abierta (campo number ) y una tarjeta almacenada (campo token ) en la misma solicitud. | = 88 AN | NO |
wallet_transaction_id | ID de una transacción de billetera digital. Por ahora, esta funcionalidad solo está disponible para el autorizador de Visa Checkout (authorizer_id : 406 ). No está permitido enviar un número de tarjeta abierta (campo number ), una tarjeta almacenada (campotoken ) y un wallet_transaction_id en la misma solicitud. | < 25 AN | NO |
do_par_inquiry | Informa si se realizará la llamada a la Consulta de VISA PAR. El valor de respuesta se devolverá en el campo par de callback.Valores permitidos: true - Se realizará la solicitud PAR false - No se realizará la solicitud PAR. Valor default: false | < 5 A | NO |
#
Parámetros de respuestaSi tiene éxito, el código de respuesta HTTP será "200". Cualquier otro código debe interpretarse como un error. En la siguiente tabla se muestra la descripción de los parámetros de respuesta del servicio de búsqueda de tarjetas:
Parámetro | Descripción | Formato |
---|---|---|
code | Código de respuesta de Portal Carat. Cualquier código que no sea "0" significa error. [Más información.] (Api-codes.md # response-codes) | < 4 N |
message | Mensaje de respuesta de pago oline. | < 500 AN |
payment | ||
status | Estado de la transacción de pago en Portal Carat. [Más información.] (codigos-da-api.md#status-de-transacões-do-e-sitef) | = 3 AN |
card | ||
authorizer_code | Código de respuesta del autorizador. | < 10 AN |
authorizer_message | Mensaje de respuesta del autorizador. | < 500 AN |
acquirer_name | Nombre de enrutamiento. Por ejemplo: Cielo | < 256 AN |
authorizer_id | Código de autorizador (utilice este ID al realizar el pago). | < 3 N |
is_customer_id_required | Indica la recogida obligatoria del documento del cliente. | < 5 T / F |
is_expiry_date_required | Indica la obligación de cobrar la fecha de caducidad de la tarjeta del comprador. | < 5 T / F |
is_installment_funding_enabled | Indica si el pago a plazos está habilitado. | < 5 T / F |
is_security_code_required | Indica la recopilación de códigos de seguridad obligatorios. | < 5 T / F |
is_spot_sale_enabled | Indica si el pago en efectivo está habilitado. | < 5 T / F |
is_with_interest_sale_enabled | Indica si el pago de intereses está habilitado. | < 5 T / F |
is_without_interest_sale_enabled | Indica se o pagamento sem juros está habilitado. | < 5 T/F |
max_installments_with_interest | Cuotas máximas con intereses. | < 2 N |
min_installments_with_interest | Cuota mínima con intereses. | < 2 N |
visa_checkout_data | Objeto con datos devueltos por Visa Checkout. | El |
financing_plan_list | Objeto consistente en una serie de planes de financiamiento presentados en el enrutamiento de Via Certa Financiadora. Un plan de financiación consta de los siguientes campos: plan_cod : código de identificación del plan de financiación, que debe enviarse en el momento del pago; tipo_plano : código de tipo de plan de financiación financiación; desc_plano : descripción del plan, que se puede presentar al comprador; parc_plano : número máximo de cuotas posibles del plan. | El |
is_customer_postal_code_required | Indica la recopilación obligatoria del código postal del usuario (código postal en Brasil). | < 5 T / F |
par | Valor PAR devuelto por VISA si se envía el campo do_par_inquiry con el valor true en la [solicitud] (# par% c3% a2metros-de-requisi% c3% a7% c3% a3o). | < 32 AN |
card.prefixes [] | Este campo contiene los prefijos (datos adicionales) devueltos por SiTef. | |
clave | Nombre de prefijo. | < 1024 AN |
valor | Valor de prefijo. | < 1024 AN |
details[] | Este campo contiene detalles devueltos por el enrutamiento IPG | |
brand | La marca de la tarjeta. La marca de la tarjeta. | < 1024 AN |
brand_product_id | ID de producto de de la de la tarjeta. El ID de producto de la marca. | < 1024 AN |
card_function | Función de tarjeta. Función de tarjeta. | CRÉDITO, DÉBITO, PREPAGO, VALE, INDEFINIDO |
commercialCard | Indica si la tarjeta es corporativa o no corporativa. Indica si es una tarjeta corporativa o no corporativa. | CORPORATIVO, NO_CORPORATIVO |
issuer_country | El país del emisor de la tarjeta. El país del emisor. | < 1024 AN |
issuer_name | El nombre del emisor de la tarjeta. El nombre del emisor. | < 1024 AN |
#
Enrutamientos que permiten la búsqueda de tarjetas.Cód | Enrutamiento | Tiene consulta de tarjeta |
---|---|---|
1004 | VisaNet via SiTef (rede:4) | |
1005 | Redecard via SiTef (rede:5) | |
1018 | Standby (Excard) via SiTef (rede:18) | |
1019 | Edmcard via SiTef (rede:19) | |
1021 | Vero via SiTef (rede:21) | |
1026 | CCCWeb (Master/Visa/Amex) via SiTef (rede:26) | |
1029 | Softway via SiTef (rede:29) | |
1030 | Multicheque via SiTef (rede:30) | |
70 | Ticket via SiTef (rede:41) | |
430 | Senff via SiTef (rede:43) | |
1045 | Coopercred via SiTef (rede:45) | |
1047 | Sorocred via SiTef (rede:47) | |
1051 | Hipercard via SiTef (rede:51) | |
1052 | Tricard via SiTef (rede:52) | |
1054 | Policard via SiTef (rede:54) | |
1057 | CCC (Master/Visa) via SiTef (rede:57) | |
1059 | Telenet via SiTef (rede:59) | |
1061 | Brasilcard via SiTef (rede:61) | |
1064 | CCC (Amex) via SiTef (rede:64) | |
1068 | Banese via SiTef (rede:68) | |
1072 | Bigcard via SiTef (rede:72) | |
1077 | Valecard via SiTef (rede:77) | |
1081 | Supercard via SiTef (rede:81) | |
1182 | GetNet via SiTef (rede:82) | |
1086 | Marisa via SiTef (rede:86) | |
1087 | Maxicred via SiTef (rede:87) | |
1089 | Expansiva via SiTef (rede:89) | |
1091 | Leader II via SiTef (rede:91) | |
1093 | Cetelem via SiTef (rede:93) | |
1094 | Cabal via SiTef (rede:94) | |
1095 | Credsystem via SiTef (rede:95) | |
1096 | BBVA via SiTef (rede:96) | |
1102 | Check Check (Smart Shop) via SiTef (rede:102) | |
1103 | Dacasa via SiTef (rede:103) | |
1104 | Bradesco Private Label via SiTef (rede:104) | |
1105 | Platinum (Credimais) via SiTef (rede:105) | |
1111 | Tredenexx via SiTef (rede:111) | |
1113 | Credishop via SiTef (rede:113) | |
1115 | IBI via SiTef (rede:115) | |
1118 | Oboe via SiTef (rede:118) | |
1121 | Hot Card via SiTef (rede:121) | |
1122 | PAN via SiTef (rede:122) | |
1125 | Cielo via SiTef (rede:125) | |
1127 | Marisa Cartao Presente via SiTef (rede:127) | |
1128 | Cooplife via SiTef (rede:128) | |
1129 | BOD via SiTef (rede:129) | |
1144 | Accredito (ACSP) via SiTef (rede:144) | |
1149 | Fidelidade Mais via SiTef (rede:149) | |
160 | Orbitall via SiTef (rede:160) | |
1161 | iCards via SiTef (rede:161) | |
1165 | Banco Ge (Tivit) via SiTef (rede:165) | |
1169 | Banescard via SiTef (rede:169) | |
1181 | GetNet Lac via SiTef (rede:181) | |
1187 | Sicredi - nao usar, usar o bin via SiTef (rede:187) | |
1192 | AVISTA via SiTef (rede:192) | |
1193 | Algorix via SiTef (rede:193) | |
1194 | Amex EMV via SiTef (rede:194) | |
1006 | Amex EMV via SiTef (rede:194) | |
1201 | SmartNet via SiTef (rede:201) | |
1203 | Peela via SiTef (rede:203) | |
1206 | GlobalPayments via SiTef (rede:206) | |
1207 | Elavon via SiTef (rede:207) | |
218 | Hug via SiTef (rede:218) | |
225 | Fidelity via SiTef (rede:225) | |
1229 | Bin via SiTef (rede:229) | |
1236 | Conductor via SiTef (rede:236) | |
1249 | Riachuelo PL via SiTef (rede:249) | |
1257 | Bradescard via SiTef (rede:257) | |
1265 | Stone via SiTef (rede:265) | |
1266 | DM Card via SiTef (rede:266) | |
1271 | CardSE via SiTef (rede:271) | |
1279 | Sodexo via SiTef (rede:279) | |
1280 | Kredilig via SiTef (rede:280) | |
1283 | ConductorDUP via SiTef (rede:283) | |
1296 | Safra via SiTef (rede:296) | |
1297 | Rede Ticket via SiTef (rede:297) | |
1303 | SiPag via SiTef (rede:303) | |
1309 | ADIQ via SiTef (rede:309) | |
1313 | Via Certa Financiadora via SiTef (rede:313) |