> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.schoolset.io/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.schoolset.io/_mcp/server. # Charge a split payment by credit card POST https://ssuccessv2.com/app/api/v2/payment/split/create/onetime/charge-now/credit-card Content-Type: multipart/form-data Charges an immediate credit-card payment and distributes the approved amount across selected contracts and fee allocations. Reference: https://docs.schoolset.io/api-reference/school-set-api/payment-splits/create-credit-card-charge-now-one-time-payment-split ## Authentication - `Authorization` header (bearer token, required) — The signed-in SchoolSet user token sent by the frontend. ## Request ### Body (multipart/form-data) This endpoint expects a multipart form. - `merchant_account_id` (integer, required) - `credit_card_number` (integer, required) - `credit_card_exp_date` (string, required) - `credit_card_cvc` (integer, required) - `customer_billing_name` (string, required) - `customer_address_1` (string, optional) - `customer_address_2` (string, optional) - `customer_city` (string, optional) - `customer_state` (string, optional) - `customer_zip` (string, optional) - `customer_country` (string, optional) - `customer_phone` (string, optional) - `customer_email` (string, optional) - `contracts_id` (list of integer, required) - `payment_amounts` (list of double, required) - `payment_total_amount` (double, required) - `contract_fees_types_id` (list of integer, optional) - `is_credit` (boolean, optional) - `note` (string, optional) ## Response ### 200 The card split result is returned with gateway status and PaymentResource items - `status` (string, optional) - `message` (string, optional) - `data` (list of ApiV2PaymentSplitCreateOnetimeChargeNowCreditCardPostResponsesContentApplicationJsonSchemaDataItems, optional) ## Errors ### 400 Bad Request Error The contract - `status` (string, required) - `message` (string, required) - `data` (any, optional, nullable) ### 401 Unauthorized Error Authentication is required to charge a split card payment. - `status` (string, required) - `message` (string, required) - `data` (any, optional, nullable) ### 403 Forbidden Error The authenticated user cannot create payments in the active school. - `status` (string, required) - `message` (string, required) - `data` (any, optional, nullable) ### 404 Not Found Error A contract or merchant account was not found. - `status` (string, required) - `message` (string, required) - `data` (any, optional, nullable) ### 422 Unprocessable Entity Error Credit-card or split fields failed validation. - `message` (string, required) - `errors` (map from string to list of string, required) ## Types ### ApiV2PaymentSplitCreateOnetimeChargeNowCreditCardPostResponsesContentApplicationJsonSchemaDataItems PaymentResource for each split payment. ## Examples **Request** ```json { "merchant_account_id": 8, "credit_card_number": 4111111111111111, "credit_card_exp_date": "2027-08", "credit_card_cvc": 123, "customer_billing_name": "Maria Garcia", "contracts_id": [ 1201, 1202 ], "payment_amounts": [ 75, 50.5 ], "payment_total_amount": 125.5 } ``` **Response** ```json { "status": "success", "message": "Payment accepted.", "data": [ {} ] } ``` **SDK Code** ```python import requests url = "https://ssuccessv2.com/app/api/v2/payment/split/create/onetime/charge-now/credit-card" payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"merchant_account_id\"\r\n\r\n8\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"credit_card_number\"\r\n\r\n4111111111111111\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"credit_card_exp_date\"\r\n\r\n2027-08\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"credit_card_cvc\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_billing_name\"\r\n\r\nMaria Garcia\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_address_1\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_address_2\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_city\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_state\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_zip\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_country\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_phone\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_email\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"contracts_id\"\r\n\r\n[\n 1201,\n 1202\n]\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"payment_amounts\"\r\n\r\n[\n 75,\n 50.5\n]\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"payment_total_amount\"\r\n\r\n125.5\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"contract_fees_types_id\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"is_credit\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n\r\n-----011000010111000001101001--\r\n" headers = { "Authorization": "Bearer ", "Content-Type": "multipart/form-data; boundary=---011000010111000001101001" } response = requests.post(url, data=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://ssuccessv2.com/app/api/v2/payment/split/create/onetime/charge-now/credit-card'; const form = new FormData(); form.append('merchant_account_id', '8'); form.append('credit_card_number', '4111111111111111'); form.append('credit_card_exp_date', '2027-08'); form.append('credit_card_cvc', '123'); form.append('customer_billing_name', 'Maria Garcia'); form.append('customer_address_1', ''); form.append('customer_address_2', ''); form.append('customer_city', ''); form.append('customer_state', ''); form.append('customer_zip', ''); form.append('customer_country', ''); form.append('customer_phone', ''); form.append('customer_email', ''); form.append('contracts_id', '[ 1201, 1202 ]'); form.append('payment_amounts', '[ 75, 50.5 ]'); form.append('payment_total_amount', '125.5'); form.append('contract_fees_types_id', ''); form.append('is_credit', ''); form.append('note', ''); const options = {method: 'POST', headers: {Authorization: 'Bearer '}}; options.body = form; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://ssuccessv2.com/app/api/v2/payment/split/create/onetime/charge-now/credit-card" payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"merchant_account_id\"\r\n\r\n8\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"credit_card_number\"\r\n\r\n4111111111111111\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"credit_card_exp_date\"\r\n\r\n2027-08\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"credit_card_cvc\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_billing_name\"\r\n\r\nMaria Garcia\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_address_1\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_address_2\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_city\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_state\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_zip\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_country\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_phone\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_email\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"contracts_id\"\r\n\r\n[\n 1201,\n 1202\n]\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"payment_amounts\"\r\n\r\n[\n 75,\n 50.5\n]\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"payment_total_amount\"\r\n\r\n125.5\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"contract_fees_types_id\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"is_credit\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n\r\n-----011000010111000001101001--\r\n") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://ssuccessv2.com/app/api/v2/payment/split/create/onetime/charge-now/credit-card") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"merchant_account_id\"\r\n\r\n8\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"credit_card_number\"\r\n\r\n4111111111111111\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"credit_card_exp_date\"\r\n\r\n2027-08\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"credit_card_cvc\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_billing_name\"\r\n\r\nMaria Garcia\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_address_1\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_address_2\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_city\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_state\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_zip\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_country\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_phone\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_email\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"contracts_id\"\r\n\r\n[\n 1201,\n 1202\n]\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"payment_amounts\"\r\n\r\n[\n 75,\n 50.5\n]\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"payment_total_amount\"\r\n\r\n125.5\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"contract_fees_types_id\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"is_credit\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n\r\n-----011000010111000001101001--\r\n" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://ssuccessv2.com/app/api/v2/payment/split/create/onetime/charge-now/credit-card") .header("Authorization", "Bearer ") .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"merchant_account_id\"\r\n\r\n8\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"credit_card_number\"\r\n\r\n4111111111111111\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"credit_card_exp_date\"\r\n\r\n2027-08\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"credit_card_cvc\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_billing_name\"\r\n\r\nMaria Garcia\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_address_1\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_address_2\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_city\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_state\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_zip\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_country\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_phone\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_email\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"contracts_id\"\r\n\r\n[\n 1201,\n 1202\n]\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"payment_amounts\"\r\n\r\n[\n 75,\n 50.5\n]\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"payment_total_amount\"\r\n\r\n125.5\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"contract_fees_types_id\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"is_credit\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n\r\n-----011000010111000001101001--\r\n") .asString(); ``` ```php request('POST', 'https://ssuccessv2.com/app/api/v2/payment/split/create/onetime/charge-now/credit-card', [ 'multipart' => [ [ 'name' => 'merchant_account_id', 'contents' => '8' ], [ 'name' => 'credit_card_number', 'contents' => '4111111111111111' ], [ 'name' => 'credit_card_exp_date', 'contents' => '2027-08' ], [ 'name' => 'credit_card_cvc', 'contents' => '123' ], [ 'name' => 'customer_billing_name', 'contents' => 'Maria Garcia' ], [ 'name' => 'contracts_id', 'contents' => '[ 1201, 1202 ]' ], [ 'name' => 'payment_amounts', 'contents' => '[ 75, 50.5 ]' ], [ 'name' => 'payment_total_amount', 'contents' => '125.5' ] ] 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://ssuccessv2.com/app/api/v2/payment/split/create/onetime/charge-now/credit-card"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddParameter("undefined", "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"merchant_account_id\"\r\n\r\n8\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"credit_card_number\"\r\n\r\n4111111111111111\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"credit_card_exp_date\"\r\n\r\n2027-08\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"credit_card_cvc\"\r\n\r\n123\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_billing_name\"\r\n\r\nMaria Garcia\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_address_1\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_address_2\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_city\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_state\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_zip\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_country\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_phone\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"customer_email\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"contracts_id\"\r\n\r\n[\n 1201,\n 1202\n]\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"payment_amounts\"\r\n\r\n[\n 75,\n 50.5\n]\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"payment_total_amount\"\r\n\r\n125.5\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"contract_fees_types_id\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"is_credit\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n\r\n-----011000010111000001101001--\r\n", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Authorization": "Bearer "] let parameters = [ [ "name": "merchant_account_id", "value": "8" ], [ "name": "credit_card_number", "value": "4111111111111111" ], [ "name": "credit_card_exp_date", "value": "2027-08" ], [ "name": "credit_card_cvc", "value": "123" ], [ "name": "customer_billing_name", "value": "Maria Garcia" ], [ "name": "customer_address_1", "value": ], [ "name": "customer_address_2", "value": ], [ "name": "customer_city", "value": ], [ "name": "customer_state", "value": ], [ "name": "customer_zip", "value": ], [ "name": "customer_country", "value": ], [ "name": "customer_phone", "value": ], [ "name": "customer_email", "value": ], [ "name": "contracts_id", "value": "[ 1201, 1202 ]" ], [ "name": "payment_amounts", "value": "[ 75, 50.5 ]" ], [ "name": "payment_total_amount", "value": "125.5" ], [ "name": "contract_fees_types_id", "value": ], [ "name": "is_credit", "value": ], [ "name": "note", "value": ] ] let boundary = "---011000010111000001101001" var body = "" var error: NSError? = nil for param in parameters { let paramName = param["name"]! body += "--\(boundary)\r\n" body += "Content-Disposition:form-data; name=\"\(paramName)\"" if let filename = param["fileName"] { let contentType = param["content-type"]! let fileContent = String(contentsOfFile: filename, encoding: String.Encoding.utf8) if (error != nil) { print(error as Any) } body += "; filename=\"\(filename)\"\r\n" body += "Content-Type: \(contentType)\r\n\r\n" body += fileContent } else if let paramValue = param["value"] { body += "\r\n\r\n\(paramValue)" } } let request = NSMutableURLRequest(url: NSURL(string: "https://ssuccessv2.com/app/api/v2/payment/split/create/onetime/charge-now/credit-card")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```