Skip to main content

​
DRP Plugin for Square

Send encrypted receipts directly from Square POS to your customers’ banking apps. No coding required - install the plugin and start sending receipts in 15 minutes.

​
Overview

The DRP plugin for Square integrates seamlessly with:
  • Square POS (iPad, Android tablet)
  • Square Register (countertop terminal)
  • Square Terminal (portable all-in-one)
  • Square for Restaurants
  • Square for Retail

​
What It Does

After every card transaction, the plugin automatically:
  1. Retrieves the customer’s encryption key from their bank
  2. Encrypts an itemized receipt with transaction details
  3. Signs the receipt with your merchant key
  4. Sends the encrypted receipt to the customer’s card issuer
  5. Logs delivery confirmation for your records
Your checkout flow doesn’t change. Customers tap/insert their card, and encrypted receipts send automatically in the background.

​
Prerequisites

Before installing, ensure you have:
Square account with admin access
At least one location set up in Square Dashboard
Active merchant account with a DRP-enabled card issuer
Issuer-provided credentials (merchant ID and registration key)

​
Supported Square Versions

  • Square POS: v8.0 or higher
  • Square Register: v6.0 or higher
  • Square Terminal: All firmware versions
  • Square for Restaurants: v3.0 or higher

​
Installation

​
Step 1: Install from Square App Marketplace

  1. Open Square Dashboard
  2. Navigate to Apps
    • Click “Apps” in the left sidebar
    • Select “App Marketplace”
  3. Search for DRP
    • Search for “Digital Receipt Protocol” or “DRP”
    • Click on the “DRP - Digital Receipts” app
  4. Install the App
    • Click “Add to Square”
    • Review permissions (the app needs access to transaction data and payment details)
    • Click “Allow”
The plugin is free to install and use. There are no monthly fees or per-transaction charges.

​
Step 2: Configure Issuer Connections

After installation, you’ll be redirected to the DRP configuration screen.
  1. Add Your First Issuer
    • Click “Connect Card Issuer”
    • Select your primary card issuer from the dropdown
    • If your issuer isn’t listed, select “Other” and enter their domain
  2. Enter Merchant Credentials You’ll need these from your issuer’s merchant services team: 
    Merchant ID: mch_your_coffee_shop_001
Registration Key: reg_key_abc123xyz789
Issuer API Domain: api.issuer-bank.com
    • Paste your Merchant ID (provided by issuer)
    • Paste your Registration Key (one-time registration token)
    • Enter Issuer API Domain (e.g., api.chase.com)
  3. Complete Registration
    • Click “Register with Issuer”
    • The plugin will:
      • Generate cryptographic keys for your merchant account
      • Register your public key with the issuer
      • Store your API credentials securely
      • Test the connection
        You’ll see “Connected” with a green checkmark when successful
  4. Add Additional Issuers (Optional)
    • Click “Add Another Issuer”
    • Repeat steps 1-3 for each additional card issuer
    • Most merchants connect with 2-4 major issuers

​
Step 3: Configure Receipt Settings

  1. Customize Receipt Appearance
    • Business Logo: Upload your logo (PNG/JPG, max 200KB)
    • Receipt Header: Custom message (e.g., “Thank you for your purchase!”)
    • Footer Message: Include return policy, social media, etc.
    • Contact Information: Phone, email, website
  2. Set Location Details The plugin auto-detects your Square locations. For each location:
    • Verify address is correct
    • Add location-specific messages (optional)
    • Enable/disable DRP per location
  3. Advanced Settings
    • Receipt Language: Default language for receipts (auto-detected from Square)
    • Include Tax Breakdown: Show itemized taxes (recommended)
    • Include Payment Method: Show card type and last 4 digits
    • Retry Failed Receipts: Auto-retry if transmission fails (recommended: ON)

​
Step 4: Test the Integration

  1. Enable Test Mode
    • Toggle “Test Mode” to ON in the DRP settings
    • This sends receipts to issuer sandbox (not real customers)
  2. Run a Test Transaction Using Square POS or Register:
    • Ring up a test sale (minimum $0.01)
    • Use a test card provided by your issuer
    • Complete the transaction
    Most issuers provide test cards like:
    • Visa: 4111 1111 1111 1111
    • Mastercard: 5555 5555 5555 4444
    • Check with your issuer for their test cards
  3. Verify Receipt Delivery In the DRP plugin dashboard:
    • Go to “Recent Receipts”
    • You should see your test transaction
    • Status should show “Delivered” with timestamp
    • Click “View Details” to see delivery confirmation
  4. Check Receipt Content If your issuer provides a test portal:
    • Log into issuer’s test environment
    • View the encrypted receipt
    • Verify all items, prices, and taxes are correct

​
Step 5: Go Live

  1. Disable Test Mode
    • Toggle “Test Mode” to OFF
    • Confirm you want to go live
  2. Enable for All Locations
    • Go to “Locations” tab
    • Toggle DRP ON for each location
    • Receipts will start sending on next transaction
  3. Train Your Team Inform your staff:
    • Nothing changes at checkout - it works automatically
    • If a customer asks about receipts, explain they’ll appear in their banking app
    • Paper/email receipts still available as backup

​
Dashboard & Monitoring

​
View Receipt Activity

The DRP dashboard shows:
  • Today’s Receipts: Count of receipts sent today
  • Delivery Rate: Percentage successfully delivered (target: >95%)
  • Top Issuers: Which card issuers process most of your transactions
  • Recent Activity: Last 50 receipts with status

​
Receipt Statuses

StatusMeaningAction
[Yes] DeliveredSuccessfully sent to issuerNone - receipt delivered
⏳ PendingQueued for transmissionWait - will retry automatically
[Partial] Customer Not EnrolledCustomer hasn’t enabled DRPNormal - they won’t receive DRP receipt
[No] FailedTransmission errorCheck error details, contact support if persistent

​
Analytics

Track your DRP performance:
  • Enrollment Rate: % of transactions where customer has DRP enabled
  • Delivery Time: Average time from transaction to receipt delivery
  • Error Rate: % of failed transmissions
  • Issuer Breakdown: Receipt volume by card issuer

​
Troubleshooting

Common causes:
  1. Issuer connectivity issue
    • Check issuer status page
    • Verify API domain is correct in settings
    • Test issuer connection in DRP settings
  2. Invalid merchant credentials
    • Re-enter merchant ID and registration key
    • Contact issuer to verify credentials are active
  3. Expired registration key
    • Registration keys expire after 30 days
    • Request new key from issuer merchant services
Solution: Click “Reconnect” next to the issuer and re-enter credentials
This is normal if:
  • The issuer recently launched DRP (low customer enrollment)
  • You’re in a test environment with test cards
Check:
  • Confirm issuer has DRP available to cardholders
  • Verify you’re not in test mode for production transactions
  • Ask issuer what their current enrollment rate is
Note: As DRP adoption grows, this percentage will increase over time
Steps to resolve:
  1. Update Square POS to latest version
  2. Restart Square POS app
  3. Check that plugin is installed in Square Dashboard -> Apps
  4. Ensure you’re logged into the correct Square account
  5. Try uninstalling and reinstalling the plugin
Still not working? Contact DRP support with your Square seller ID
Possible causes:
  1. Square item library not synced
    • Go to Square Dashboard -> Items
    • Ensure all items have correct names and prices
    • Sync item library in DRP settings
  2. Modifiers not configured
    • Check that item modifiers are set up correctly
    • DRP uses Square’s modifier structure
  3. Multiple locations with different items
    • Verify item library is configured per location
    • Check “Item Library” settings in DRP plugin
Enable in settings:
  1. Go to DRP plugin -> Settings
  2. Enable “Include Tax Breakdown”
  3. Ensure Square is calculating taxes correctly:
    • Dashboard -> Settings -> Taxes
    • Verify tax rates are configured
Note: If Square doesn’t calculate taxes, DRP can’t include the breakdown
To remove an issuer connection:
  1. Go to DRP plugin -> Issuers
  2. Find the issuer you want to remove
  3. Click the three dots (⋮) -> “Disconnect”
  4. Confirm disconnection
Note: This won’t delete past receipts, but stops sending new ones to that issuer

​
Best Practices

Connect Multiple Issuers

Add 3-4 major card issuers to maximize receipt coverage. Most transactions use Visa, Mastercard, Amex, or Discover.

Monitor Delivery Rate

Check your dashboard weekly. Delivery rate should be >95%. Lower rates indicate a configuration issue.

Keep Square Updated

Update Square POS regularly. Plugin updates automatically, but requires latest Square version.

Train Staff on Questions

Customers may ask where receipts went. Staff should explain: “Your itemized receipt will appear in your banking app within a few minutes.”

​
FAQ

No. DRP receipts are in addition to your existing receipt methods. Customers still get email/SMS if configured. DRP sends an encrypted copy to their bank.
Customers must have:
  1. A card from a DRP-enabled issuer
  2. DRP receipts enabled in their banking app
If either condition isn’t met, they won’t receive DRP receipts (but will still get email/paper receipts).
Select “Other” when adding an issuer and manually enter their API domain. Contact your issuer’s merchant services to get:
  • API domain
  • Merchant ID
  • Registration key
No - receipts are encrypted with each customer’s private key. Only they can decrypt and view the receipt in their banking app. You can see delivery confirmation but not the decrypted content.
Yes! The plugin works for:
  • In-person Square POS/Register/Terminal
  • Square Online Store checkout
  • Square Invoices
  • Square Virtual Terminal
Any card-present or card-not-present transaction sends a DRP receipt.
Refunds automatically trigger an updated receipt showing:
  • Original items
  • Refund amount
  • Refund date/time
  • Updated balance
Voided transactions don’t send receipts.

​
Support & Resources

Plugin Support

Email support for installation help

Video Tutorial

Watch step-by-step installation

Square Help Center

General Square POS questions

Issuer Support

Contact your card issuer for credentials

​
Update & Uninstall

​
Updating the Plugin

The DRP plugin auto-updates when new versions are released. You’ll see a notification in Square Dashboard when an update is available. To manually check for updates:
  1. Go to Square Dashboard -> Apps
  2. Find “DRP - Digital Receipts”
  3. If an update is available, click “Update”

​
Uninstalling

To remove the plugin:
  1. Go to Square Dashboard -> Apps
  2. Find “DRP - Digital Receipts”
  3. Click ”⋮” -> “Uninstall”
  4. Confirm uninstallation
Uninstalling removes:
  • Issuer connections
  • Receipt history in dashboard
  • Custom settings
Past receipts already sent to issuers are not deleted (customers keep their receipts).

​
What’s Next?

1

Install Plugin

Add DRP from Square App Marketplace
2

Connect Issuers

Set up connections with 2-3 major card issuers
3

Test & Verify

Run test transactions and check delivery
4

Go Live

Enable for all locations and start sending receipts
5

Monitor & Optimize

Check dashboard weekly and add more issuers as needed
Ready to get started? Install the Square plugin now ->