Payment Receipt

Chapa provides a comprehensive receipt system that allows users to view detailed payment information and transaction receipts through a simple URL redirect.

Receipt URL Format

After a successful payment, users can access their payment receipt using the following URL format:

https://chapa.link/payment-receipt/{chapa_reference_id}

Example Receipt URL

https://chapa.link/payment-receipt/APQ1kcaiCZi2

Receipt Information

The receipt page displays comprehensive payment details including:

Payment Details

• Reference ID: Unique transaction identifier (e.g., APQ1kcaiCZi2)
• Payer Name: Customer's full name
• Phone Number: Customer's phone number
• Email Address: Customer's email address
• Payment Method: Method used for payment (e.g., telebirr, card, bank)
• Status: Payment status (Paid)
• Payment Date: Date and time of the transaction
• Payment Reason: Purpose of the payment

Financial Information

• Sub Total: Original payment amount
• Charge: Transaction fee
• Total: Final amount including fees

Merchant Information

• Merchant Name: Business or service provider name
• TIN: Tax Identification Number
• Phone Number: Merchant contact number
• Address: Merchant business address
• Website: Merchant website

References

• Chapa Reference: Internal Chapa reference ID
• Merchant Reference: Your custom transaction reference
• Bank Reference: Bank transaction reference (if applicable)

Implementation

Redirect After Payment

You can redirect users to the receipt page after a successful payment:

// After successful payment
const referenceId = response.data.reference; // Get from payment response
const receiptUrl = `https://chapa.link/payment-receipt/${referenceId}`;
window.location.href = receiptUrl;

Example Integration

// Example: After payment initialization
const initializePayment = async () => {
  try {
    const response = await fetch('https://api.chapa.co/v1/transaction/initialize', {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer YOUR_SECRET_KEY',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        amount: '100',
        currency: 'ETB',
        email: 'customer@example.com',
        tx_ref: 'unique-tx-ref-123'
      })
    });

    const data = await response.json();
    
    if (data.status === 'success') {
      // Redirect to payment checkout
      window.location.href = data.data.checkout_url;
      
      // After payment success, redirect to receipt
      // The receipt URL can be constructed using the reference from verify endpoint
    }
  } catch (error) {
    console.error('Payment initialization failed:', error);
  }
};

Getting Receipt URL from Verification

After verifying a payment, you can extract the reference ID and construct the receipt URL:

// Verify payment
const verifyPayment = async (txRef) => {
  const response = await fetch(`https://api.chapa.co/v1/transaction/verify/${txRef}`, {
    headers: {
      'Authorization': 'Bearer YOUR_SECRET_KEY'
    }
  });

  const data = await response.json();
  
  if (data.status === 'success') {
    const chapaReference = data.data.reference; // Chapa reference ID
    const receiptUrl = `https://chapa.link/payment-receipt/${chapaReference}`;
    
    // Redirect to receipt or display link
    return receiptUrl;
  }
};

Receipt Features

Print Receipt

Users can print the receipt for their records by using the browser's print function (Ctrl+P or Cmd+P).

Download Receipt

The receipt page provides options to download the receipt in various formats.

Security

Support

For any issues with receipt access or questions about receipt information:

• Phone: +251-960724272
• Email: info@chapa.co
• Website: chapa.co

This receipt system provides a professional and comprehensive way for both merchants and customers to access and verify payment information.

Next Steps

• Verify Payment - Verify payment status and get receipt reference
• Webhooks - Receive payment notifications
• Accept Payment - Learn how to accept payments