Create Grant

POST

Create and submit a new grant. This should be used to capture a grant intent from an authorized DAFpay workflow session and submit the grant request to the DAF sponsor.

Error handling:

  • The grant must be captured within 15 minutes of authorization otherwise the request will return status 410 Gone.
  • A grant can only be captured once from any given workflow session so any duplicate requests will return status 409 Conflict.
  • The amount must be in whole dollar increments (rounded to the nearest hundred) as currently DAFs only accept whole dollar grants otherwise the request will return status 400 Bad Request.
  • The amount must be greater than or equal to the minimum grant amount for the DAF otherwise the request will return status 400 Bad Request.
  • The amount must be less than or equal to the user’s DAF account balance otherwise the request will return status 400 Bad Request.

Request

This endpoint expects an object.
workflowSessionIdstringRequired

The identifier of the donor’s DAFpay Workflow Session. See Integrating Connect for how to get this value from the DAFpay client-side SDK.

amountdoubleRequired
The grant amount in cents that will be processed by Chariot and submitted to the DAF. This amount must be in whole dollar increments (rounded to the nearest hundred) as currently all DAFs only accept whole dollar grant amounts.
applicationFeeAmountdoubleOptional

This parameter specifies the fee your platform plans to take from the grant in cents. This is a fee in addition to Chariot’s processing fee. With application fees, Chariot collects the fee you determine from the nonprofit and passes it to your platform. Please note that platform fees are only taken when the grant is successfully received by the Nonprofit. The sum of Chariot’s fee and the applicationFeeAmount cannot exceed 5% of the grant’s amount. If the fee limit is exceeded, a 400 Bad Request error will be returned.

donorobjectOptional
designationstringOptional
The designation to include on the grant. If this is left blank, "Where needed most" will be used. Note that including a custom designation may cause the grant approval process to take longer. Designations over 100 characters will be truncated.

Response

This endpoint returns an object.
idstring
The unique identifier for the object
workflowSessionIdstring
ID of the Connect Workflow Session associated with this grant
fundIdstring
ID of the donor advised fund
amountdouble
The grant amount expressed in units of whole cents
trackingIdstringOptional
The tracking ID for the grant
externalGrantIdstringOptional
ID of the grant associated with the donor advised fund
createdAtdatetimeOptional
Time when this object was created; expressed in ISO 8601 format
updatedAtdatetimeOptional
Time when this object was last updated; expressed in ISO 8601 format
statusstringOptional
The status of the grant
feeDetailobjectOptional
The fee detail of the grant
metadatamap from strings to stringsOptional
A map of arbitrary string keys and values to store information about the object
firstNamestringOptional
The donor's first name
lastNamestringOptional
The donor's last name
phonestringOptional
The donor's phone number
emailstringOptional
The donor's email
notestringOptional
An note inputted by the user at submisson
statuseslist of objectsOptional
The list of grant statuses for this grant
paymentChannel"dafpay_network" or "direct"Optional
Allowed values: dafpay_networkdirect

The payment channel for the grant. This is useful to know how the grant will be sent. The payment channel will be one of the following:

  • dafpay_network: Grant will be sent to the DAFPay Network 501(c)(3) non-profit organization (EIN: 93-1372175). The DAFPay Network will then review and process the grant and send the funds to the intended recipient.
  • direct: Grant will be sent directly to the intended recipient.
addressobjectOptional
userFriendlyIdstringOptionalDeprecated
Often referred to as the "Chariot ID", this is the ID that will be included in the payment from the DAF provider.

Errors

Built with