Create Grant
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. On initial creation of the grant, this request will return a 201 Created status. On subsequent requests, the request will return status 200 OK.
Error handling:
- The grant must be captured within 15 minutes of authorization otherwise the request will return status
410 Gone. - If this request is submitted while this grant is already being processed, the request 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. - If the DAF provider does not recognize the nonprofit, the request will return status
404 Not Found. - If the nonprofit cannot receive DAF gifts, for example because it is not in good standing with the IRS, the request will return status
412 Precondition Failed. - If the DAF provider is down or the submission fails, the request will return status
502 Bad Gateway. Retrying a502submits the grant to the provider again. - Any inputs exceeding the maximum allowed length will be automatically truncated.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
The identifier of the donor’s DAFpay Workflow Session.
See Handle the Result for how to get this value from the DAFpay CHARIOT_SUCCESS event.
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.
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 applicationFeeAmount is validated on its own against the grant amount, with a default ceiling of 210 basis points that your Chariot agreement can raise. Chariot’s own fee is charged separately and is not part of this check.
If the fee limit is exceeded, a 400 Bad Request error will be returned.
A note the donor wants to send to the nonprofit. Maximum length: 400 characters.
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. Maximum length: 100 characters.
Response
ID of the Donation produced by this grant. Populated once the grant has produced a donation. Newly-created grants and grants that have not yet produced a donation do not have this field set.
Time when this object was created; expressed in RFC 3339 format
Time when this object was last updated; expressed in RFC 3339 format
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) nonprofit 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.

