Saltar al contenido principal

Ejemplo de Envío de Datos para Desarrollo del Formulario

Instrucciones para Probar la Integración de un Formulario Personalizado con Salesforce Usando cURL​

Estos comandos están basados en la documentación proporcionada y simulan las solicitudes necesarias para capturar y actualizar la información del formulario:

Paso 1: Iniciar la Transacción y Obtener el salesforce_form_id​

Este primer cURL envía la información inicial (por ejemplo, el nombre del donante) para obtener un ID de formulario único (salesforce_form_id) que se usará en las siguientes solicitudes:

En este caso la salesforce_connection es "tucuota3". Puedes probar el cURL en tu terminal y jugar con variaciones de este ejemplo.

Ejemplo

curl "https://forms.tc-cloud-partners.net/api/capture/tucuota3" \
  -H "Content-Type: application/json" \
  -d '{
      "data": {
          "TCPagos__Apellido__c": "test",
          "TCPagos__Campa_a__c": "https://forms.tc-cloud-partners.net/form/example",
          "TCPagos__Monto_de_la_donaci_n__c": 500,
          "TCPagos__Nombre__c": "test"
      }
  }'

La respuesta se verá de esta forma y obtendras el salesforce_form_id para continuar con los siguientes pasos​

{
  "data": {
    "message": "OK",
    "data": {
      "id": "FS4ZOVg17PWE6o"
    }
  }
}
A tener en cuenta:

salesforce_form_id se devuelve como parte de la respuesta JSON, lo que permite que los desarrolladores manejen el formulario, y puedan ir realizando llamados de tipo UPDATE posteriores.

Paso 2: Actualizar Información del Formulario​

En cada solicitud de actualización, debes usar el salesforce_form_id que obtuviste en el primer paso. A continuación, un ejemplo para actualizar el tipo y monto de la donación:

Ejemplo

curl "https://forms.tc-cloud-partners.net/api/capture/tucuota3" \
  -H "Content-Type: application/json" \
  -d '{
      "salesforce_form_id": "FS4ZOVg17PWE6o_HERE_YOUR_FORM_ID",
      "data": {
          "TCPagos__Correo_electr_nico__c": "test@test.com",
          "TCPagos__Qu_te_motiv_a_sumar_tu_aporte__c": "Otros",
          "TCPagos__Tel_fono__c": "115643456"
      }
  }'

Paso 3: Actualizar Información Adicional y envío de Método de Pago​

Ejemplo

Creación del Método de Pago

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. Una vez que obtienes el ID del Método de pago continúas con el envío de la información a Salesforce reemplazando en el campo "id": "PM_NEW_PAYMENT_METHOD_ID"

Envío de Información a Salesforce

Por último, una vez que obtengas el método de pago creado, puedes concluir el flujo enviando la información de este objeto a Salesforce.

curl "https://forms.tc-cloud-partners.net/api/capture/tucuota3" \
  -H "content-type: application/json" \
  -d '{
    "salesforce_form_id": "FS4ZOVg17PWE6o_HERE_YOUR_FORM_ID",
    "data": {
      "payment_method": {
        "id": "PMjba3yvok8m_NEW_PAYMENT_METHOD_ID",
        "object": "payment_method",
        "type": "card",
        "card": {
          "last_four_digits": "4242",
          "expiration_month": 10,
          "expiration_year": 2025,
          "country": "GB",
          "network": "visa",
          "funding": "credit",
          "name": "Visa",
          "providers": {
            "available": ["fiserv-argentina", "prisma-visa"],
            "preferred": "prisma-visa"
          }
        },
        "livemode": false
      }
    }
  }'

Ejemplo