Documentación técnica para desarrollar formularios personalizados para Salesforce
Endpoint para iniciar la Transacción
Utiliza el siguiente endpoint para enviar información a Salesforce:
https://forms.tc-cloud-partners.net/api/capture/{salesforce_connection}
Debes solicitar al equipo de soporte el nombre de conexión de la organización. A partir de ese nombre de conexión, puedes comenzar a trabajar con el formulario.
Si necesitas realizar pruebas, puedes solicitar un formulario de testing. En este caso, primero te proporcionaremos el nombre de conexión del formulario de test. Una vez que implementes en producción, deberás reemplazarlo con el nombre de conexión del formulario principal.
| Nombre | Identificador | Tipo | Ejemplo |
|---|---|---|---|
| Nombre de conexión de la organización | salesforce_connection | String | "example" |
Campos y Tipos de Datos
| Nombre del Campo | Identificador | Tipo de Dato | Ejemplo |
|---|---|---|---|
| Apellido | TCPagos__Apellido__c | String | "test" |
| Nombre | TCPagos__Nombre__c | String | "test" |
| Correo Electrónico | TCPagos__Correo_electr_nico__c | String | "test@test.com" |
| Tipo de Documento | TCPagos__Tipo_de_identificaci_n__c | String | "Dni" |
| Número de Documento | TCPagos__N_mero_de_identificaci_n__c | String | "23234344" |
| Género | TCPagos__G_nero__c | String | "Femenino" |
| Fecha de Nacimiento | TCPagos__Fecha_de_nacimiento__c | Date | "2000-12-12" |
| Código Postal | TCPagos__C_digo_postal__c | String | "5000" |
| Dirección | TCPagos__Calle_y_n_mero__c | String | "S/N" |
| País | TCPagos__Pa_s__c | String | "Argentina" |
| Provincia | TCPagos__Provincia__c | String | "Formosa" |
| Teléfono | TCPagos__Tel_fono__c | String | "115643456" |
| Frecuencia de Donación | TCPagos__Frecuencia_de_la_donaci_n__c | String | "Mensual" o "Única vez" |
| Monto de Donación | TCPagos__Monto_de_la_donaci_n__c | Float | 2500.50 |
| Qué motiva a sumar tu aporte | TCPagos__Qu_te_motiv_a_sumar_tu_aporte__c | String | "otro" |
| Cómo conociste nuestra Organización | TCPagos__C_mo_conociste_nuestra_organizaci_n__c | String | "otro" |
| Campaña | TCPagos__Campa_a__c | String | "https://forms.tc-cloud-partners.net/form/example" |
| Autorización de Update | TCPagos__TCPagos_Autorizacion_de_update__c | Boolean | true |
| Debi método de pago | TCPagos__Tu_cuota_Id__c | String | "PMrqkjB8Gk9L" |
Tipos de Peticiones
- Creación (POST): Si en el cuerpo de la petición (BODY) no se incluye el
salesforce_form_id, se generará un nuevo formulario. Esto es útil para iniciar una nueva transacción o proceso de recolección de datos. - Modificación (POST): Si en el cuerpo de la petición se incluye el
salesforce_form_id, el formulario existente se actualizará con los nuevos campos enviados. Si el campo ya existía, el valor será sobreescrito con el nuevo valor proporcionado. Esta operación permite una carga parcial de los datos, ya que el orden de incorporación es flexible, permitiendo que la información se envíe en múltiples etapas y en cualquier secuencia.
Obtener el Método de Pago
Para obtener el método de pago, debes utilizar en tu frontend la librería js.debi.pro, ingresa al artículo Uso librería js para tokenizar desde front-end. Esta biblioteca te permitirá integrar la tokenización de métodos de pago de manera segura y eficiente.
Ejemplo de prueba
Consulta este ejemplo y pruébalo en tu consola.