← Back to Documentation

Payment Triggers Documentation

Learn how to automatically collect testimonials when you receive payments from customers or complete business events. Choose from three integration methods: Zapier, Direct API, or Email BCC.

Overview

Payment triggers automatically send testimonial requests to your customers after they make a payment. This integration works with 100+ payment providers worldwide without requiring you to share any payment credentials.

⚡ Zapier

No code required, 5-minute setup

Works with 5,000+ apps

🔧 Direct API

For developers, full control

Custom integrations

📧 Email BCC

Simplest method, 2-minute setup

No API keys needed

Zapier Integration Setup

Supported Payment Providers

Zapier supports all major payment processors worldwide

Global

Stripe
PayPal
Square

Africa

Paystack
Flutterwave
PayFast

Europe

Mollie
Adyen
Klarna

Asia

Razorpay
PayTM
Alipay

1
Create a New Zap

  1. Go to Zapier.com and sign in
  2. Click “Create Zap” or “+ Create”
  3. You'll see the Zap editor with Trigger and Action steps

2
Choose Your Payment Provider

Search for and select your payment provider, then choose the appropriate trigger event:

Stripe:“New Payment” or “Payment Intent Succeeded”
Paystack:“Charge Success”
Square:“New Payment Created”
PayPal:“New Sale”

3
Add ReputaFlow Webhook Action

Choose “Webhooks by Zapier” as your action app and select “POST” as the action event.

https://www.reputaflow.com/api/webhooks/trigger?agentId=YOUR_AGENT_ID
X-API-Key: [Your ReputaFlow API Key]
Content-Type: application/json

4
Map Payment Data Fields

Map data from your payment provider to ReputaFlow fields:

customer_email→ Customer Email (Required)
customer_name→ Customer Name (Optional)
amount→ Amount (Optional)
currency→ Currency (Optional)
project_description→ Description (Optional)

5
Test and Activate

Test your Zap to ensure everything is working correctly, then turn it on.

Developer Integration

Webhook Code Examples

Add testimonial triggers to your existing payment webhook handlers

JavaScript / Node.js

// In your existing payment webhook handler
app.post('/webhooks/payment', async (req, res) => {
  // ... your existing payment processing ...
  
  // Forward to ReputaFlow (async, won't block)
  fetch('https://www.reputaflow.com/api/webhooks/trigger?agentId=YOUR_AGENT_ID', {
    method: 'POST',
    headers: {
      'X-API-Key': 'rf_live_your_api_key',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      customer_email: payment.customer.email,
      customer_name: payment.customer.name,
      amount: payment.amount / 100,
      currency: payment.currency,
      project_description: payment.description
    })
  }).catch(console.error);
  
  // ... rest of your logic ...
});

Python

# In your existing webhook handler
import requests

# Forward to ReputaFlow (async)
try:
    requests.post(
        'https://www.reputaflow.com/api/webhooks/trigger?agentId=YOUR_AGENT_ID',
        headers={'X-API-Key': 'rf_live_your_api_key'},
        json={
            'customer_email': payment.customer.email,
            'customer_name': payment.customer.name,
            'amount': payment.amount / 100,
            'currency': payment.currency,
            'project_description': payment.description
        },
        timeout=5
    )
except Exception as e:
    print(f'ReputaFlow notification failed: {e}')

API Reference

POST /api/webhooks/trigger

Trigger a testimonial collection when a payment is received

Request Body

FieldTypeRequiredDescription
customer_emailstringYesCustomer's email address
customer_namestringNoCustomer's full name
amountnumberNoPayment amount (not in cents)
currencystringNoCurrency code (USD, EUR, etc.)
project_descriptionstringNoDescription of the service/product

Response Codes

200Success - Conversation created
400Bad Request - Invalid data
401Unauthorized - Invalid API key
403Forbidden - Payment triggers disabled
429Too Many Requests

Email BCC Integration

📧 Simplest Method - No API Keys Required

BCC your magic email on delivery/invoice emails to automatically trigger testimonial requests

Step 1: Get Your Magic Email

  1. Log in to your ReputaFlow dashboard
  2. Navigate to your agent dashboard: /dashboard/agents/[AGENT_ID]
  3. Find your Magic Email in the "BCC Email" card
  4. Copy the email address (format: feedback+xxxxxxxxxx@reputaflow.com)

Step 2: Add to Your Email Client

When sending delivery or invoice emails, add your magic email to the BCC field:

To: customer@example.com
Bcc: feedback+zxf56fpit2@reputaflow.com
Subject: Your Website Redesign is Complete!

Step 3: What Gets Extracted

  • Customer email (from "To" field)
  • Customer name (if in email signature)
  • Project context (from subject/body)
  • Service type (from email content)
Set Up Payment TriggersBack to Documentation