Introduction

The Dufr Digital Payment System provides a robust Instant Payment Notification (IPN) service to keep your application informed about cryptocurrency payment statuses. By providing a webhook URL, you will receive real-time POST requests containing payment details once a crypto payment is completed. This ensures seamless integration and timely updates for your business processes.

IPN Setup

To start receiving IPN calls, configure a publicly accessible webhook URL in your Dufr Digital dashboard. Ensure your endpoint is HTTPS-enabled and can handle POST requests with JSON payloads. Once set, Dufr will send a notification to your webhook URL whenever a payment is completed, including details such as transaction ID, amount, and status.

IPN Retries

Dufr implements a retry mechanism to ensure reliable delivery of IPN notifications. If your webhook fails to respond with a 200 OK status, Dufr will retry the notification up to 5 times over one hour. To avoid missing updates, ensure your endpoint is resilient and logs all incoming requests for debugging.

Code Samples

To help you integrate IPN handling, we provide sample code in various programming languages. These examples demonstrate how to parse the JSON payload, verify the request, and process payment data. Visit our GitHub repository for detailed code samples and documentation to get started quickly.

IPN POST JSON Fields

HEADERS

merchant-id: DqWJbuQz5

x-api-key: dufr-DqWJbuQz5-jbgsdkGXKEKnFEVH15hykcXe

BUNDLE CONTENT

ipn_version: 1.0

ipn_type: purchase

dufr_digital_id: 123456789

address: bc1qtwx5kcl6zsfpu9te25p7eurtl93snuepzxv7up

txn_id: 654321

client_id: 123456

client_email: john@gmail.com

status: 100

status_text: completed

date: 12/1/24 - 12:23PM

currency: BTC

amount: 0.00023669

usdamount: 20.00

escrow: no

escrow_release: na

date_release: na

confirms: 3