ADVERTENCIA: Los formularios de donación recién creados se registran como V2. Por favor, consulte el texto de ayuda relacionado con V2. ¡Los formularios de donación en este documento pertenecen a una versión anterior!
¿Qué es un formulario de donación?
Los formularios de donación son una infraestructura que le permite recibir donaciones integrándolos en su propio sitio web. Puede crear un formulario de donación ingresando a la sección Donaciones > Formulario de Donación en el menú de la izquierda.
¿Qué hay que tener en cuenta?
El punto más importante a considerar al crear un formulario de donación es ingresar la dirección del sitio web donde usará el formulario. Al ingresar la dirección, debe incluir https:// al principio. Y si su sitio web tiene varias versiones, debe hacerla única. Los formularios de donación solo funcionan con HTTPS.
Por ejemplo;
Si su sitio funciona tanto como https://www.adimadim.org como https://adimadim.org, por favor, elija solo uno y redirija el nombre de dominio no elegido al otro.
Integración con el sitio web
¡ADVERTENCIA! Esta integración requiere conocimientos de software. Debe dominar HTML y Javascript básicos. Si no domina estos temas, por favor, utilice nuestras páginas de donación estándar.
Primero, puede obtener la clave API (api_key) y el Código de Campaña (campaign) necesarios para usar el formulario en su página desde la sección Operaciones > Información de Integración en la lista de formularios de donación.
Justo antes de la sección </head> de su página web
<meta name="Referrer" content="origin"><script type="text/javascript" src="https://s.fonzip.com/js/fonzip.loader.js"></script>
añada nuestro script a la página.
Luego, después de preparar las secciones de su página web donde recibirá los parámetros de cantidad y donación recurrente, debe llamar a la función fz.bagis cuando se haga clic en el botón de donar.
Parámetros
api_key: Su clave API (Obligatorio)
amount: Cantidad de Donación (Obligatorio)
currency: Código ISO de la moneda, por defecto la moneda de la institución,
recurring: ¿Donación recurrente? (Obligatorio)
campaign: Su Código de Campaña (Obligatorio)
lang: Vacío o "tr" para turco, "en" para inglés, por defecto el idioma del navegador
get_news: Permiso de comunicación, true si se concede, false si no se concede
referring: Si se desea que la donación en nombre de alguien se abra seleccionada, true, de lo contrario false
cardholder_name: Si se desea que el nombre y apellido del donante aparezcan rellenos, debe rellenarse
email: Si se desea que la dirección de correo electrónico aparezca rellena, debe rellenarse
ref_to: Si se desea que el nombre de la persona en cuyo nombre se hará la donación aparezca relleno, debe rellenarse
ref_email: Si se desea que el correo electrónico de la persona en cuyo nombre se hará la donación aparezca relleno, debe rellenarse
tckno: Si se desea que el TCKN (Número de Identificación Turco) aparezca relleno, debe rellenarse, debe tener 11 dígitos
phone: Si se desea que el teléfono aparezca relleno, debe rellenarse, debe contener solo números
birthday: Fecha de nacimiento, debe estar en formato DD/MM/AAAA y debe rellenarse si se desea que aparezca rellena
details: Campo de descripción, debe rellenarse si se desea que aparezca relleno
api_tracking_id: Código necesario para el seguimiento del formulario abierto
fundraising_campaign_id: Debe enviarse si se desea que el formulario abierto se vincule a una campaña de usuario
name_hidden: ¿Se debe ocultar el nombre en la donación realizada a la campaña de usuario?
amount_visible: ¿Se debe mostrar la cantidad de la donación en la donación realizada a la campaña de usuario?
custom_parameters: Sus parámetros personalizados
onload: Acciones que desea que se realicen en su página cuando se abra el formulario de donación
success: Acciones que desea que se realicen en su página cuando se complete la donación, devuelve la información de la donación exitosa
error: Acciones que desea que se realicen en su página cuando la donación falle
close: Acciones que desea que se realicen en su página cuando se cierre el formulario, si se cierra después de una donación exitosa, el parámetro result devuelve true.
fz.bagis({ api_key: "SU CLAVE API", amount: "Cantidad", currency: "TRY", recurring: false || true, campaign: "SU CÓDIGO DE CAMPAÑA", lang:"tr", // get_news: true, referring: false, cardholder_name: "Nombre y apellido del donante", email: "Dirección de correo electrónico", ref_to: "Nombre de la persona en cuyo nombre se hará la donación", ref_email: "Correo electrónico de la persona en cuyo nombre se hará la donación", tckno: "TCKN", phone: "Teléfono", birthday: "DD/MM/AAAA", details: "Descripción", api_tracking_id: "Código de Seguimiento", fundraising_campaign_id: "ID de campaña de usuario", name_hidden: false || true, amount_visible: false || true, custom_parameters: { //sus parámetros personalizados }, onload: function() { //ACCIONES A REALIZAR CUANDO LA CARGA SE COMPLETE }, success: function(data) { var nombre_donante = data.name; var cantidad_donacion = data.amount; var correo_donante = data.email; var campaña = data.campaign_id; var direccion = data.address; var telefono = data.phone; var tckno = data.tckno; var fecha_nacimiento = data.birthday; var ciudad = data.city; var distrito = data.district; var descripcion = data.details; var tckno = data.tckno; var en_nombre_de_alguien = data.referring; var persona_donada_en_nombre_de = data.referring_name; var correo_persona_donada_en_nombre_de = data.referring_email; var recurrente = data.recurring; var numero_transaccion = data.order_id; var numero_transaccion_banco = data.transaction_id; var numero_provision_banco = data.provision_no; var api_tracking_id = data.api_tracking_id; // ACCIONES A REALIZAR EN CASO DE ÉXITO }, error: function(data) { var codigo_error = data.error_code; var descripcion_error = data.error_description; // ACCIONES A REALIZAR EN CASO DE FALLO }, close: function(result) { //true si la donación es exitosa, de lo contrario otras situaciones //Acciones a realizar cuando se cierre el formulario }});Parámetros Personalizados
Puede utilizar la función de parámetros personalizados para transferir cualquier campo que no esté definido en Fonzip pero que usted utilice al recibir donaciones.
Creación de Parámetros Personalizados
Puede crear un parámetro haciendo clic en Añadir parámetro en la sección Parámetros Personalizados, que se encuentra en la parte inferior de la página de creación/edición del formulario de donación.
En la pantalla que aparece, escriba el valor clave que pasará en el parámetro en la sección Nombre del campo, y el valor que desea que aparezca en el sistema en la sección Descripción y guarde.
Por ejemplo, creamos un parámetro con el nombre de campo receipt y la descripción Solicitud de Recibo. Si el donante solicita un recibo adicional, rellenaremos este campo como "Sí", si no lo solicita, como "No".
Nota: No hay restricciones en los valores que se pasarán en los parámetros.
Al enviar una solicitud de donación, debe enviar su parámetro en la función fz.bagis de la siguiente manera:
var valor_recibo = makbuz_checkbox.selected ? "Sí":"No";fz.bagis({ api_key: "SU CLAVE API", amount: "cantidad", currency: "TRY", recurring: false, campaign: "SU CÓDIGO DE CAMPAÑA", custom_parameters: { makbuz: valor_recibo }, success: function(data) { // ACCIONES A REALIZAR EN CASO DE ÉXITO }, error: function(data) { // ACCIONES A REALIZAR EN CASO DE FALLO }});Después de completar la donación, si se seleccionó la opción de solicitar un recibo, puede ver los datos relevantes en los detalles de la donación como se muestra a continuación.
Advertencias de Parámetros Personalizados
El envío de un parámetro no definido en la configuración del formulario provocará un error en el sistema.
El envío de datos en un formato diferente al JSON provocará un error en el sistema.
Si cambia/elimina el nombre de un campo de un parámetro que añadió previamente, puede perder los datos de las donaciones relacionadas.
Código de Ejemplo
Puede acceder a los archivos HTML, CSS y Javascript de ejemplo desde https://bitbucket.org/erdifonzip/fonzip-donation-form-integration.