Create an ACH wallet for a fundraising donor | SchoolSet

curl -X POST https://ssuccessv2.com/app/api/v1/fundraising/donor/wallet/create/ach \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "routing_number": "021000021",
  "account_number": "000123456789",
  "account_type": "checking",
  "customer_billing_name": "Jordan Lee",
  "customer_address_1": "100 Main Street",
  "customer_city": "New York",
  "customer_state": "NY",
  "customer_zip": "10001",
  "customer_country": "US",
  "customer_phone": "+1-212-555-0188",
  "merchant_account_id": 3,
  "fundraising_id": 42
}'

{
  "status": "success",
  "message": "",
  "data": {
    "id": 811,
    "wallet_type": {
      "id": 5,
      "sys_name": "ach"
    },
    "merchant_account_id": 3,
    "active": true,
    "wallet_status_id": 1,
    "payer_id": 274,
    "payer_type": "donor"
  }
}

Validates ACH and donor billing details, verifies that the campaign is active, resolves or creates the fundraising donor, and creates the wallet through the configured merchant account. A disabled campaign or invalid donation type can return a 400 error.

Authentication

AuthorizationBearer

The signed-in SchoolSet user token sent by the frontend.

Request

This endpoint expects an object.

routing_numberstringRequired

account_numberstringRequired

account_typeenumRequired

Allowed values:

customer_billing_namestringRequired

customer_address_1stringRequired

customer_citystringRequired

customer_statestringRequired

customer_zipstringRequired

customer_countrystringRequired

customer_phonestringRequired

merchant_account_idintegerRequired

fundraising_idintegerRequired

bank_namestring or nullOptional

customer_address_2string or nullOptional

customer_emailstring or nullOptionalformat: "email"

donation_type_idinteger or nullOptional

messagestring or nullOptional

full_namestring or nullOptional

emailstring or nullOptionalformat: "email"

notestring or nullOptional

parent_student_idinteger or nullOptional

family_student_idinteger or nullOptional

fundraising_donor_idinteger or nullOptional

wallet_descriptionstring or nullOptional

activeboolean or nullOptional

Response

Wallet created.

statusstring

messagestring

datamap from strings to any

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error