This repository contains the source code for Dwolla's C#-based SDK, which allows developers to interact with Dwolla's server-side API via a C# API. Any action that can be performed via an HTTP request can be made using this SDK when executed within a server-side environment.
To begin using this SDK, you will first need to download it to your machine. We use NuGet to distribute this package. Check out the Microsoft documentation for more information on how to install and manage packages from Nuget using Visual Studio.
Here's an example using the Package Manager Console
$ Install-Package Dwolla.Client -Version 5.2.2Before any API requests can be made, you must first determine which environment you will be using, as well as fetch the application key and secret. To fetch your application key and secret, please visit one of the following links:
- Production: https://dashboard.dwolla.com/applications
- Sandbox: https://dashboard-sandbox.dwolla.com/applications
Finally, you can create an instance of DwollaClient by specifying which environment you will be using—Production or Sandbox—via the isSandbox boolean flag.
var client = DwollaClient.Create(isSandbox: true);Application access tokens are used to authenticate against the API on behalf of an application.
Application tokens can be used to access resources in the API that either belong to the application
itself (webhooks, events, webhook-subscriptions) or the Dwolla Account that owns the
application (accounts, customers, funding-sources, etc.). Application tokens are obtained by
using the client_credentials OAuth grant type:
var tokenRes = await client.PostAuthAsync<AppTokenRequest, TokenResponse>(
new Uri($"{client.AuthBaseAddress}/token"),
new AppTokenRequest {Key = "...", Secret = "..."});Application access tokens are short-lived: 1 hour. They do not include a refresh_token. When it
expires, generate a new one using AppTokenRequest.
Once you've created a DwollaClient, currently, you can make low-level HTTP requests.
To make low-level HTTP requests, you can use the GetAsync(), PostAsync(), UploadAsync() and
DeleteAsync() methods with the available
request models.
These methods will return responses that can be mapped to one of the available
response models.
To specify headers for a request (e.g., Authorization), you can pass a Headers object as the last argument.
var headers = new Headers {{"Authorization", $"Bearer {tokenRes.Content.Token}"}};
client.GetAsync<GetCustomersResponse>(url, headers);// GET api.dwolla.com/customers
var url = new Uri("https://api.dwolla.com/customers");
client.GetAsync<GetCustomersResponse>(url);// POST api.dwolla.com/customers
var url = new Uri("https://api.dwolla.com/customers/");
var request = new CreateCustomerRequest
{
FirstName = "Jane",
LastName = "Doe",
Email = "jane.doe@email.com"
};
var res = await PostAsync<CreateCustomerRequest, EmptyResponse>(url, request, headers);
//res.Response.Headers.Location => "https://api-sandbox.dwolla.com/customers/fc451a7a-ae30-4404-aB95-e3553fcd733f
// POST api.dwolla.com/customers/{id}/documents multipart/form-data foo=...
var url = new Uri("https://api-sandbox.dwolla.com/customers/{id}/documents");
var request = new UploadDocumentRequest
{
DocumentType = "idCard",
Document = new File
{
ContentType = "image/png",
Filename = "filename.jpg",
Stream = fileStream
}
};
client.UploadAsync<UploadDocumentRequest, EmptyResponse>(url, request, headers);// DELETE api.dwolla.com/resource
var url = "https://api.dwolla.com/labels/{id}"
client.DeleteAsync<object>(url, null);Take a look at the
Example Application for
examples on how to use the available C# models to call the Dwolla API. Before you can begin using the app, however, you will need to specify a DWOLLA_APP_KEY and
DWOLLA_APP_SECRET environment variable.
- 5.2.2 Update
Newtonsoft.Jsonto version 13.0.1 - 5.2.1 Add Masspayment models and examples, support RTP transfers
- 5.2.0 Change Token URLs and Add Labels models and examples
- 5.1.1 Update Content-Type and Accept headers for Token URLs
- 5.1.0 Change Token URLs
- 5.0.16 Add missing
usingto ExampleApp - 5.0.15 Upgrade dependencies and Dwolla.Client.Tests and ExampleApp to
netcoreapp2.0. Breaking changes:- DwollaClient no longer throws on API errors, they should be properly deserialized into RestResponse.Error instead
- DwollaException, RestException, and RestResponse.Exception are removed
- Use
EmptyResponseinstead ofobjectin DwollaClient inteface
- 4.0.14 Ignore null values in JSON POST requests
- 4.0.13 Add Beneficial Owner models and examples
- 4.0.12 Add Controller models
- 4.0.11 Add document failure reason
- 4.0.10 Add Micro Deposit models
- 4.0.9 Add Document models, support transfer fees
- 4.0.8 Add Transfer models, expose raw response on RestResponse
- 4.0.7 Add Micro Deposit and Balance models
- 4.0.6 Breaking change: Remove CreateCustomerRequest.Status. Add UpdateCustomerRequest
- 3.0.5 Breaking change: CreateCustomerRequest.DateOfBirth
string->DateTime?. Create base responses, refactor ExampleApp to tasks, add Funding Source models - 2.0.4 Add Webhook Subscription models
- 2.0.3 Breaking change: CustomerEmbed -> CustomersEmbed. Thanks to @ithielnor for adding Business Classification models and a CLI
- 1.0.2 Lower VisualStudioVersion, add more properties to Customer
- 1.0.1 Include deserialized error in DwollaException
- 1.0.0 Initial release
- If you have any feedback, please reach out to us on our forums or by creating a GitHub issue.
- If you would like to contribute to this library, bug reports and pull requests are always appreciated!
To learn more about Dwolla and how to integrate our product with your application, please consider visiting the following resources and becoming a member of our community!