Wire Instructions
Please wire your donation to the following account
Bank: {wireInstructions.receivingBank.name}
Routing Number: {wireInstructions.receivingBank.abaRoutingNumber}
```
With the donation form set up, the user can now enter the amount they would like to donate and submit the form. The donation request will be sent to your backend server on the `/wire-donation` route. We will set up this route in the next step.
### 3. Orchestrate the donation request
When the user submits the donation form, the details will be sent to your backend service. We will need to create an endpoint that can receive this information and then send it to the Endaoment API to create the donation request. For the purposes of this guide, we will assume that the endpoint is `/wire-donation`.
The following code snippet, taken from the [backend/routes/wire-donation.ts file](https://github.com/endaoment/endaoment-integration-docs/blob/main/quickstart/backend/src/routes/wire-donation.ts) in the [quickstart example](https://github.com/endaoment/endaoment-integration-docs/tree/main/quickstart/), demonstrates how to call the API:
```javascript theme={null}
const crypto = require('crypto');
// This is the part that should be called by your `wire-donation` route handler
async function wireDonation(req, res) {
const amount = req.body['amount'];
const receivingFundId = req.body['fundId'];
if (!amount || !receivingFundId) {
// Return an error response if any of the required fields are missing
res.status(400);
res.end();
return;
}
// Get the Endaoment access token for the user
// This is a placeholder function, you should replace it with your own implementation
const token = getAccessToken(req);
// Generate a unique key for the donation request
// This can be generated by anything that is unique to the donation request
const idempotencyKey = crypto.randomUUID();
// Convert the amount to microdollars
// 1 dollar = 1,000,000 microdollars
// The actual formula for the conversion will depend on how you handle currency and data types in your application
const pledgedAmountMicroDollars = (BigInt(amount) * 1000000n).toString();
// Make a request to the Endaoment API to create the donation request
const donationRequest = await fetch(
'https://api.dev.endaoment.org/v1/donation-pledges/wire',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
// Pass the user's token in the Authorization header
Authorization: `Bearer ${token}`,
},
body: JSON.stringify({
pledgedAmountMicroDollars,
receivingFundId,
idempotencyKey,
}),
}
);
// We can now return the response to the frontend
res.status(200);
res.json(await donationRequest.json());
res.end();
}
```
The request to the Endaoment API will require the following fields:
```typescript theme={null}
{
// The amount the user would like to donate in microdollars
pledgedAmountMicroDollars: bigint,
// The ID of the DAF the user would like to donate to
receivingFundId: string,
// A unique key to ensure the donation request is idempotent
// This can be generated by anything that is unique to the donation request
idempotencyKey: string,
}
```
While there are other fields that can be included in the donation form, these are the minimum required fields to create a donation request. You can learn more about the donation fields in the [API Reference docs.](https://docs.endaoment.org/developers/api/donation-pledges/create-a-wire-donation-pledge)
With the donation request sent to the Endaoment API, the donation will be processed and the user will receive a response containing the id of the donation pledge. It will be similar to the following:
```json theme={null}
{
"id": "00a1dv45-dx19-2301-2471-223932594567"
}
```
When the frontend receives this response, it can display a confirmation message to the user that their donation has been successfully processed.
### 4. Display donation confirmation
Once the donation request has been successfully processed, the user should be shown a confirmation message that their donation has been received. This can be done by displaying the donation pledge ID that was returned from the Endaoment API.
```html theme={null}