To check that you have correctly coded your integration to our API specifications, complete our test cases for each API resource. Each API resource has a unique test endpoint and a unique set of test cases. If your tests are successful: We send you an email to inform you that you can now send requests to the live endpoint. If your tests are unsuccessful: Contact the project owner or email us for help at [email protected].

Test environment

Run the following tests using our test environment with the credentials that we provided you.

Test environment base URI: https://api.uat.payroc.com/v1

Testing Funding Recipients

Use our /funding-recipients endpoint to create and manage third-party recipients that receive funds from your transactions. To verify that your integration works with this endpoint, run the following tests:

Test 1: Create a Funding Recipient

You can create a Funding Recipient independently of any existing MIDs on your account.

Use our /funding-recipients endpoint to create a new Funding Recipient.

Successful response:

Response

application/json

{
  "recipientId": 1,
  "status": "approved",
  "createdDate": "2020-09-08T12:00:00.000Z",
  "lastModifiedDate": "2020-09-08T12:00:00.000Z",
  "recipientType": "privateCorporation",
  "taxId": "123456789",
  "charityId": "abc123",
  "doingBuinessAs": "abc123",
  "address": {
    "address1": "1 Example Ave.",
    "address2": "abc123",
    "address3": "abc123",
    "city": "Example city",
    "state": "Illinois",
    "country": "US",
    "postalCode": "60056"
  },
  "contactMethods": [
    {
      "type": "email",
      "value": "[email protected]"
    }
  ],
  "metadata": {
    "customerId": "2345"
  },
  "owners": [
    {
      "ownerId": 1,
      "link": {
        "rel": "owner",
        "href": "https://api.payroc.com/v1/owners/1",
        "method": "get"
      }
    }
  ],
  "fundingAccounts": [
    {
      "fundingAccountId": 1,
      "status": "approved",
      "link": {
        "rel": "fundingAccount",
        "herf": "https://api.payroc.com/v1/funding-accounts/1",
        "method": "get"
      }
    },
    {
      "fundingAccountId": 2,
      "status": "rejected",
      "link": {
        "rel": "fundingAccount",
        "herf": "https://api.payroc.com/v1/funding-accounts/2",
        "method": "get"
      }
    }
  ]
}

Test 2: Add a Funding Account to a Recipient

You can use our /funding-recipients endpoint to manage Funding Accounts associated with a Recipient.

Use our /funding-recipients endpoint to add a new Funding Account to an existing Recipient.

Successful response:

Response

application/json

{
  "fundingAccountId": 123,
  "createdDate": "2020-09-08T12:00:00.000Z",
  "lastModifiedDate": "2020-09-08T12:00:00.000Z",
  "status": "approved",
  "type": "checking",
  "use": "credit",
  "nameOnAccount": "Joe Bloggs",
  "paymentMethods": [
    {
      "type": "ach",
      "value": {
        "routingNumber": "*****6789",
        "accountNumber": "******7890"
      }
    }
  ],
  "metadata": {
    "internalRef": "2345"
  },
  "links": [
    {
      "rel": "parent",
      "href": "https://api.payroc.com/v1/funding-recipient/2",
      "method": "get"
    }
  ]
}

Test 3: Add a new Owner to a Recipient

You can use our /funding-recipients endpoint to create and manage Owner objects associated with the Funding Recipient.

Use our /funding-recipients to create a new Owner.

Successful response:

Response

application/json

{
  "ownerId": 1543,
  "firstName": "David",
  "middleName": "scott",
  "lastName": "Simpson",
  "dateOfBirth": "1964-03-22T00:00:00.000Z",
  "address": {
    "address1": "1 Example Ave.",
    "address2": "abc123",
    "address3": "abc123",
    "city": "Example city",
    "state": "Illinois",
    "country": "US",
    "postalCode": "60056"
  },
  "identifiers": [
    {
      "type": "nationalId",
      "value": "xxx-xx-4320"
    }
  ],
  "contactMethods": [
    {
      "type": "phone",
      "value": "617 715 1234"
    },
    {
      "type": "mobile",
      "value": "856 457 8745"
    },
    {
      "type": "email",
      "value": "[email protected]"
    }
  ],
  "relationship": {
    "equityPercentage": 35.4,
    "title": "abc123",
    "isControlProng": false
  }
}

Test 4: Retrieve the Funding Accounts for a Recipient

To create accurate Funding Instructions, it's important to make sure that you can retrieve a list of Funding Accounts for any Funding Recipients that you create.

Use our /funding-accounts endpoint to retrieve a list of Funding Accounts for a Funding Recipient.

Successful response:

Response

application/json

[
  {
    "fundingAccountId": 123,
    "createdDate": "2020-09-08T12:00:00.000Z",
    "lastModifiedDate": "2020-09-08T12:00:00.000Z",
    "status": "approved",
    "type": "checking",
    "use": "credit",
    "nameOnAccount": "Joe Bloggs",
    "paymentMethods": [
      {
        "type": "ach",
        "value": {
          "routingNumber": "*****6789",
          "accountNumber": "******7890"
        }
      }
    ],
    "metadata": {
      "internalRef": "2345"
    },
    "links": [
      {
        "rel": "parent",
        "href": "https://api.payroc.com/v1/funding-recipient/2",
        "method": "get"
      }
    ]
  },
  {
    "fundingAccountId": 124,
    "createdDate": "2021-01-08T12:00:00.000Z",
    "lastModifiedDate": "2021-01-08T12:00:00.000Z",
    "status": "pending",
    "type": "checking",
    "use": "debit",
    "nameOnAccount": "Joe Bloggs",
    "paymentMethods": [
      {
        "type": "ach",
        "value": {
          "routingNumber": "*****8725",
          "accountNumber": "******3491"
        }
      }
    ],
    "metadata": {
      "internalRef": "2346"
    },
    "links": [
      {
        "rel": "parent",
        "href": "https://api.payroc.com/v1/funding-recipient/2",
        "method": "get"
      }
    ]
  }
]

Testing Funding Instructions

You can use our /funding-instructions endpoint to tell us how to split your available funds across multiple Funding Accounts. For example, Funding Accounts that belong to your sales office, your merchants, or any Funding Recipients. To verify that your integration works with this endpoint, run the following tests:

Test 5: Create a new Funding Instruction

A Funding Instruction tells us how to split funds across multiple accounts.

Use our /funding-accounts endpoint to retrieve a list of Funding Accounts.
Use our /funding-instructions endpoint to create a new Funding Instruction.

Successful response:

Response

application/json

{
  "instructionId": 123,
  "createdDate": "2021-09-05T13:15:00.000Z",
  "lastModifiedDate": null,
  "status": "accepted",
  "merchants": [
    {
      "merchantId": "99999",
      "recipients": [
        {
          "status": "accepted",
          "fundingAccountId": 67890,
          "paymentMethod": "ACH",
          "amount": {
            "value": 12350,
            "currency": "USD"
          },
          "metadata": {
            "customerId": "2345"
          },
          "link": {
            "rel": "fundingAccount",
            "method": "get",
            "href": "https://api.payroc.com/v1/funding-accounts/67890"
          }
        }
      ],
      "link": {
        "rel": "merchant",
        "method": "get",
        "href": "https://api.payroc.com/v1/merchants/99999"
      }
    }
  ],
  "metadata": {
    "instructionRef": "abcd"
  }
}

Test 6: Update a Funding Instruction

While a Funding Instruction has a status of accepted, you can continue to edit and update the instruction. To update a Funding Instruction, you must send a PUT request to the correct Funding Instruction id.

Use our /funding-instructions endpoint to update a Funding Instruction.

Successful response:

Response

application/json

{
  "instructionId": 123,
  "createdDate": "2021-09-05T13:15:00.000Z",
  "lastModifiedDate": null,
  "status": "accepted",
  "merchants": [
    {
      "merchantId": "99999",
      "recipients": [
        {
          "status": "accepted",
          "fundingAccountId": 67890,
          "paymentMethod": "ACH",
          "amount": {
            "value": 12350,
            "currency": "USD"
          },
          "metadata": {
            "customerId": "2345"
          },
          "link": {
            "rel": "fundingAccount",
            "method": "get",
            "href": "https://api.payroc.com/v1/funding-accounts/67890"
          }
        }
      ],
      "link": {
        "rel": "merchant",
        "method": "get",
        "href": "https://api.payroc.com/v1/merchants/99999"
      }
    }
  ],
  "metadata": {
    "instructionRef": "abcd"
  }
}

Test 7: List Funding Activity

You can use our /funding-activity endpoint to retrieve a list of all funding activity so far.

Use our /funding-activity endpoint to retrieve a list of all funding activity.

Successful response:

Response

application/json

{
  "limit": 10,
  "count": 10,
  "hasMore": true,
  "links": [
    {
      "rel": "previous",
      "method": "get",
      "href": "https://api.payroc.com/v1/funding-activity?before=11&limit=10&datefrom=2021-01-01&dateto=2021-01-30"
    },
    {
      "rel": "next",
      "method": "get",
      "href": "https://api.payroc.com/v1/funding-activity?after=20&limit=10&datefrom=2021-01-01&dateto=2021-01-30"
    }
  ],
  "data": [
    {
      "id": "11",
      "date": "2021-01-01T17:00:00.000Z",
      "merchant": "Joes Hot dogs",
      "description": "sales",
      "type": "credit",
      "amount": 20000,
      "currency": "USD"
    },
    {
      "id": "12",
      "date": "2021-01-01T19:32:00.000Z",
      "merchant": "Joes Hot dogs",
      "description": "sales",
      "type": "credit",
      "amount": 50000,
      "currency": "USD"
    },
    {
      "id": "13",
      "date": "2021-01-01T17:00:00.000Z",
      "merchant": "Joes Hot dogs",
      "recipient": "Joes Hot dogs",
      "description": "payment",
      "type": "debit",
      "amount": 10000,
      "currency": "USD"
    },
    {
      "id": "14",
      "date": "2021-01-01T17:00:00.000Z",
      "merchant": "Joes Hot dogs",
      "recipient": "Payroc",
      "description": "Interchange Fees",
      "type": "debit",
      "amount": 500,
      "currency": "USD"
    },
    {
      "id": "15",
      "date": "2021-01-03T09:10:00.000Z",
      "merchant": "Joes Hot dogs",
      "description": "sales",
      "type": "credit",
      "amount": 30000,
      "currency": "USD"
    },
    {
      "id": "16",
      "date": "2021-01-10T17:00:00.000Z",
      "merchant": "Janes shoe laces LTD",
      "description": "adjustment",
      "type": "credit",
      "amount": 500,
      "currency": "USD"
    },
    {
      "id": "17",
      "date": "2021-01-10T17:00:00.000Z",
      "merchant": "Janes shoe laces LTD",
      "recipient": "Payroc",
      "description": "Interchange Fees",
      "type": "debit",
      "amount": 500,
      "currency": "USD"
    },
    {
      "id": "18",
      "date": "2021-01-15T17:00:00.000Z",
      "merchant": "Joes Hot dogs",
      "recipient": "Payroc",
      "description": "Charge back",
      "type": "debit",
      "amount": 1000,
      "currency": "USD"
    },
    {
      "id": "19",
      "date": "2021-01-17T17:00:00.000Z",
      "merchant": "Janes shoe laces LTD",
      "description": "sales",
      "type": "credit",
      "amount": 50000,
      "currency": "USD"
    },
    {
      "id": "20",
      "date": "2021-01-26T17:00:00.000Z",
      "merchant": "Joes Hot dogs",
      "recipient": "Mr Payfac corp",
      "description": "payment",
      "type": "debit",
      "amount": 5000,
      "currency": "USD"
    }
  ]
}

Results

After you complete your tests, send your results to [email protected]. A member of our team will contact you to confirm certification or to provide support.

Need more help?

We are here to help! If you need help with your integration, contact us at [email protected] or through our Developer Community.