Testing Your Double the Donation Integration
      Back to home
      1. Partnerships and Integrations | Double the Donation
      2. Testing Your Double the Donation Integration

      Create a Test Account

      This article explains how to create a Double the Donation account to test an integration.

      Create a Double the Donation Account for Testing

      Access and Configure Your Test Account

      Troubleshooting

      Account with your email address already exists

      Create a 360MatchPro Account for Testing

      Double the Donation will not create a test account for you. After a mutual NDA is signed between our parties, a Double the Donation team member will provision credentials for you to use with the instructions below. With this method, you can create up to 3 accounts yourself. 
       
      A Double the Donation team member will provide you with private access to a document with:
      1. Partner TEST API Key - you'll use this to create test accounts (see below). 
      2. Partner Identifier - you'll use this in your integration builds where partner_identifier appears. 

       

      Issue a POST request to the create-360-account endpoint.

       

      Include your test partner's API key.

       

      Configure the POST request as follows:

       

      1. {
      2.   "username": "Partner Test 1",    // Replace "Partner" with your platform name. If you provision more than one test account, label them with ascending integers.
      3.   "partner_api_key": "partner-XXXXXXXXXXXXXXXX",    // Replace with your test partner API key.
      4.   "organization_name": "Partner Test 1",    // Same as your username.
      5.   "email": "youremail+dtdtest1@yourdomain.com",    // Must be unique. We recommend using this syntax with ascending integers the match your username/organization name for your test account(s).
      6.   "employer_identification_number": "string",    // Optional field. Leave blank.
      7.   "from_email": "string",    // Optional field. Leave blank.
      8.   "plugin_url": "string",    // Optional field. Leave blank.
      9.   "from_name": "string"    // Optional field. Leave blank.
      10. }

       

      Reference the Double the Donation Provision Account Data Schema for guidance.

       

      After calling the create-360-account endpoint with these parameters, you will receive a JSON response containing the following:

      1. 360matchpro_public_key: The public key for the account, which will be used for account verification and data transfer between your platform and 360MatchPro.

      2. 360matchpro_private_key: The private key for the account, which will be used only for account verification.

      3. email_cname: A JSON array representing the 3 CNAME records that have to be created so that emails 360MatchPro sends will be whitelisted by email providers.

       

      A sample response follows:

       

      1. {
      2.   "360matchpro_public_key": "XXXXXXXXXXXXXXXX",
      3.   "360matchpro_private_key": "XXXXXXXXXXXXXXXX",
      4.   "email_cname": {
      5.     "mail_cname": {
      6.       "valid": true,
      7.       "type": "cname",
      8.       "host": "XXX.com",
      9.       "data": "XXXXX"
      10.     },
      11.     "dkim1": {
      12.       "valid": true,
      13.       "type": "cname",
      14.       "host": "XXX.com",
      15.       "data": "XXXXX"
      16.     },
      17.     "dkim2": {
      18.       "valid": true,
      19.       "type": "cname",
      20.       "host": "XXX.com",
      21.       "data": "XXXXX"
      22.     }
      23.   }
      24. }

      Access and Configure Your Test Account

      Visit https://doublethedonation.com/members/login/ and select "Forgot Password?" to trigger a password reset email to your inbox. Then, sign in using your email and password.

      Navigate to "Automated Outreach" --> "Match Eligible" and enable/toggle on the Initial Email in the stream. Repeat this for the "Unknown Company" stream.

      Navigate to "Settings" --> "Exclusion Rules" and uncheck the "Duplicate Donations" rule. This will allow you to test recurring transactions and use repeat email address and donation amounts without issue.

      Troubleshooting

      Account with your email address already exists

      When provisioning an account, the username and email fields must be unique. If the username and/or email address is associated with a different account, the create-360-account endpoint will return the following response:

       

      1. {
      2.     "errors": {
      3.         "email": "Already registered with an existing account.",
      4.         "username": "Already registered with an existing account."
      5.     }
      6. }

       

      If you receive this response, try a different email address. Refer to the recommended syntax for the email field in the POST request to the create-360-account endpoint above to avoid this error.