Full Merchant Submit

Full Merchant Submit

POST /onboarding

Full Merchant Submit

cURL

curl --request POST \
  --url https://testapi.fractalpay.com/api/v1/onboarding \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "BankingInfo": {
    "account_number": "091000019",
    "bank_name": "Truist",
    "routing_number": "00212369"
  },
  "BusinessInfo": {
    "business_address": "333 West Vine Street",
    "business_city": "Lexington",
    "business_country": "US",
    "business_email": "[e-mail]",
    "business_industry": "7311",
    "business_name": "Slab Ready Mix",
    "business_phone": "8599779166",
    "business_state": "Kentucky",
    "business_zip": "40517",
    "dba": "Slab Ready Mix",
    "ein": "123456789",
    "established_date": "2024-01-01",
    "ownershiptype": "LLC",
    "website": "https://testwebsite.com/"
  },
  "OwnerInfo": {
    "address": "333 West Vine Street",
    "b_dl_number": "123123123",
    "b_title": "Owner",
    "city": "Lexington",
    "country": "US",
    "date_of_birth": "1998-01-17",
    "email": "[e-mail]",
    "first_name": "MJ",
    "last_name": "Mann",
    "ownership_percent": "100",
    "phone": "1234567895",
    "ssn": "555667777",
    "state": "Kentucky",
    "zip": "40507"
  },
  "ProcessingInfo": {
    "annualCCSales": "500000",
    "avgTicket": "50",
    "legal_b2b": "50",
    "legal_b2c": "50",
    "legal_cnpinternet": "50",
    "legal_cnpphoneemail": "50",
    "legal_cp": "50",
    "legal_percentdeliveredover30days": "50",
    "legal_percentdeliveredsameday": "50",
    "legal_productssold": "Goods",
    "percentdelievered7days": "50",
    "percentdelivered14days": "50",
    "processing_environment": "Ecommerce"
  }
}
'

import requests

url = "https://testapi.fractalpay.com/api/v1/onboarding"

payload = {
    "BankingInfo": {
        "account_number": "091000019",
        "bank_name": "Truist",
        "routing_number": "00212369"
    },
    "BusinessInfo": {
        "business_address": "333 West Vine Street",
        "business_city": "Lexington",
        "business_country": "US",
        "business_email": "[e-mail]",
        "business_industry": "7311",
        "business_name": "Slab Ready Mix",
        "business_phone": "8599779166",
        "business_state": "Kentucky",
        "business_zip": "40517",
        "dba": "Slab Ready Mix",
        "ein": "123456789",
        "established_date": "2024-01-01",
        "ownershiptype": "LLC",
        "website": "https://testwebsite.com/"
    },
    "OwnerInfo": {
        "address": "333 West Vine Street",
        "b_dl_number": "123123123",
        "b_title": "Owner",
        "city": "Lexington",
        "country": "US",
        "date_of_birth": "1998-01-17",
        "email": "[e-mail]",
        "first_name": "MJ",
        "last_name": "Mann",
        "ownership_percent": "100",
        "phone": "1234567895",
        "ssn": "555667777",
        "state": "Kentucky",
        "zip": "40507"
    },
    "ProcessingInfo": {
        "annualCCSales": "500000",
        "avgTicket": "50",
        "legal_b2b": "50",
        "legal_b2c": "50",
        "legal_cnpinternet": "50",
        "legal_cnpphoneemail": "50",
        "legal_cp": "50",
        "legal_percentdeliveredover30days": "50",
        "legal_percentdeliveredsameday": "50",
        "legal_productssold": "Goods",
        "percentdelievered7days": "50",
        "percentdelivered14days": "50",
        "processing_environment": "Ecommerce"
    }
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    BankingInfo: {account_number: '091000019', bank_name: 'Truist', routing_number: '00212369'},
    BusinessInfo: {
      business_address: '333 West Vine Street',
      business_city: 'Lexington',
      business_country: 'US',
      business_email: '[e-mail]',
      business_industry: '7311',
      business_name: 'Slab Ready Mix',
      business_phone: '8599779166',
      business_state: 'Kentucky',
      business_zip: '40517',
      dba: 'Slab Ready Mix',
      ein: '123456789',
      established_date: '2024-01-01',
      ownershiptype: 'LLC',
      website: 'https://testwebsite.com/'
    },
    OwnerInfo: {
      address: '333 West Vine Street',
      b_dl_number: '123123123',
      b_title: 'Owner',
      city: 'Lexington',
      country: 'US',
      date_of_birth: '1998-01-17',
      email: '[e-mail]',
      first_name: 'MJ',
      last_name: 'Mann',
      ownership_percent: '100',
      phone: '1234567895',
      ssn: '555667777',
      state: 'Kentucky',
      zip: '40507'
    },
    ProcessingInfo: {
      annualCCSales: '500000',
      avgTicket: '50',
      legal_b2b: '50',
      legal_b2c: '50',
      legal_cnpinternet: '50',
      legal_cnpphoneemail: '50',
      legal_cp: '50',
      legal_percentdeliveredover30days: '50',
      legal_percentdeliveredsameday: '50',
      legal_productssold: 'Goods',
      percentdelievered7days: '50',
      percentdelivered14days: '50',
      processing_environment: 'Ecommerce'
    }
  })
};

fetch('https://testapi.fractalpay.com/api/v1/onboarding', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://testapi.fractalpay.com/api/v1/onboarding",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'BankingInfo' => [
        'account_number' => '091000019',
        'bank_name' => 'Truist',
        'routing_number' => '00212369'
    ],
    'BusinessInfo' => [
        'business_address' => '333 West Vine Street',
        'business_city' => 'Lexington',
        'business_country' => 'US',
        'business_email' => '[e-mail]',
        'business_industry' => '7311',
        'business_name' => 'Slab Ready Mix',
        'business_phone' => '8599779166',
        'business_state' => 'Kentucky',
        'business_zip' => '40517',
        'dba' => 'Slab Ready Mix',
        'ein' => '123456789',
        'established_date' => '2024-01-01',
        'ownershiptype' => 'LLC',
        'website' => 'https://testwebsite.com/'
    ],
    'OwnerInfo' => [
        'address' => '333 West Vine Street',
        'b_dl_number' => '123123123',
        'b_title' => 'Owner',
        'city' => 'Lexington',
        'country' => 'US',
        'date_of_birth' => '1998-01-17',
        'email' => '[e-mail]',
        'first_name' => 'MJ',
        'last_name' => 'Mann',
        'ownership_percent' => '100',
        'phone' => '1234567895',
        'ssn' => '555667777',
        'state' => 'Kentucky',
        'zip' => '40507'
    ],
    'ProcessingInfo' => [
        'annualCCSales' => '500000',
        'avgTicket' => '50',
        'legal_b2b' => '50',
        'legal_b2c' => '50',
        'legal_cnpinternet' => '50',
        'legal_cnpphoneemail' => '50',
        'legal_cp' => '50',
        'legal_percentdeliveredover30days' => '50',
        'legal_percentdeliveredsameday' => '50',
        'legal_productssold' => 'Goods',
        'percentdelievered7days' => '50',
        'percentdelivered14days' => '50',
        'processing_environment' => 'Ecommerce'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://testapi.fractalpay.com/api/v1/onboarding"

	payload := strings.NewReader("{\n  \"BankingInfo\": {\n    \"account_number\": \"091000019\",\n    \"bank_name\": \"Truist\",\n    \"routing_number\": \"00212369\"\n  },\n  \"BusinessInfo\": {\n    \"business_address\": \"333 West Vine Street\",\n    \"business_city\": \"Lexington\",\n    \"business_country\": \"US\",\n    \"business_email\": \"[e-mail]\",\n    \"business_industry\": \"7311\",\n    \"business_name\": \"Slab Ready Mix\",\n    \"business_phone\": \"8599779166\",\n    \"business_state\": \"Kentucky\",\n    \"business_zip\": \"40517\",\n    \"dba\": \"Slab Ready Mix\",\n    \"ein\": \"123456789\",\n    \"established_date\": \"2024-01-01\",\n    \"ownershiptype\": \"LLC\",\n    \"website\": \"https://testwebsite.com/\"\n  },\n  \"OwnerInfo\": {\n    \"address\": \"333 West Vine Street\",\n    \"b_dl_number\": \"123123123\",\n    \"b_title\": \"Owner\",\n    \"city\": \"Lexington\",\n    \"country\": \"US\",\n    \"date_of_birth\": \"1998-01-17\",\n    \"email\": \"[e-mail]\",\n    \"first_name\": \"MJ\",\n    \"last_name\": \"Mann\",\n    \"ownership_percent\": \"100\",\n    \"phone\": \"1234567895\",\n    \"ssn\": \"555667777\",\n    \"state\": \"Kentucky\",\n    \"zip\": \"40507\"\n  },\n  \"ProcessingInfo\": {\n    \"annualCCSales\": \"500000\",\n    \"avgTicket\": \"50\",\n    \"legal_b2b\": \"50\",\n    \"legal_b2c\": \"50\",\n    \"legal_cnpinternet\": \"50\",\n    \"legal_cnpphoneemail\": \"50\",\n    \"legal_cp\": \"50\",\n    \"legal_percentdeliveredover30days\": \"50\",\n    \"legal_percentdeliveredsameday\": \"50\",\n    \"legal_productssold\": \"Goods\",\n    \"percentdelievered7days\": \"50\",\n    \"percentdelivered14days\": \"50\",\n    \"processing_environment\": \"Ecommerce\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Basic <encoded-value>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://testapi.fractalpay.com/api/v1/onboarding")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"BankingInfo\": {\n    \"account_number\": \"091000019\",\n    \"bank_name\": \"Truist\",\n    \"routing_number\": \"00212369\"\n  },\n  \"BusinessInfo\": {\n    \"business_address\": \"333 West Vine Street\",\n    \"business_city\": \"Lexington\",\n    \"business_country\": \"US\",\n    \"business_email\": \"[e-mail]\",\n    \"business_industry\": \"7311\",\n    \"business_name\": \"Slab Ready Mix\",\n    \"business_phone\": \"8599779166\",\n    \"business_state\": \"Kentucky\",\n    \"business_zip\": \"40517\",\n    \"dba\": \"Slab Ready Mix\",\n    \"ein\": \"123456789\",\n    \"established_date\": \"2024-01-01\",\n    \"ownershiptype\": \"LLC\",\n    \"website\": \"https://testwebsite.com/\"\n  },\n  \"OwnerInfo\": {\n    \"address\": \"333 West Vine Street\",\n    \"b_dl_number\": \"123123123\",\n    \"b_title\": \"Owner\",\n    \"city\": \"Lexington\",\n    \"country\": \"US\",\n    \"date_of_birth\": \"1998-01-17\",\n    \"email\": \"[e-mail]\",\n    \"first_name\": \"MJ\",\n    \"last_name\": \"Mann\",\n    \"ownership_percent\": \"100\",\n    \"phone\": \"1234567895\",\n    \"ssn\": \"555667777\",\n    \"state\": \"Kentucky\",\n    \"zip\": \"40507\"\n  },\n  \"ProcessingInfo\": {\n    \"annualCCSales\": \"500000\",\n    \"avgTicket\": \"50\",\n    \"legal_b2b\": \"50\",\n    \"legal_b2c\": \"50\",\n    \"legal_cnpinternet\": \"50\",\n    \"legal_cnpphoneemail\": \"50\",\n    \"legal_cp\": \"50\",\n    \"legal_percentdeliveredover30days\": \"50\",\n    \"legal_percentdeliveredsameday\": \"50\",\n    \"legal_productssold\": \"Goods\",\n    \"percentdelievered7days\": \"50\",\n    \"percentdelivered14days\": \"50\",\n    \"processing_environment\": \"Ecommerce\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://testapi.fractalpay.com/api/v1/onboarding")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"BankingInfo\": {\n    \"account_number\": \"091000019\",\n    \"bank_name\": \"Truist\",\n    \"routing_number\": \"00212369\"\n  },\n  \"BusinessInfo\": {\n    \"business_address\": \"333 West Vine Street\",\n    \"business_city\": \"Lexington\",\n    \"business_country\": \"US\",\n    \"business_email\": \"[e-mail]\",\n    \"business_industry\": \"7311\",\n    \"business_name\": \"Slab Ready Mix\",\n    \"business_phone\": \"8599779166\",\n    \"business_state\": \"Kentucky\",\n    \"business_zip\": \"40517\",\n    \"dba\": \"Slab Ready Mix\",\n    \"ein\": \"123456789\",\n    \"established_date\": \"2024-01-01\",\n    \"ownershiptype\": \"LLC\",\n    \"website\": \"https://testwebsite.com/\"\n  },\n  \"OwnerInfo\": {\n    \"address\": \"333 West Vine Street\",\n    \"b_dl_number\": \"123123123\",\n    \"b_title\": \"Owner\",\n    \"city\": \"Lexington\",\n    \"country\": \"US\",\n    \"date_of_birth\": \"1998-01-17\",\n    \"email\": \"[e-mail]\",\n    \"first_name\": \"MJ\",\n    \"last_name\": \"Mann\",\n    \"ownership_percent\": \"100\",\n    \"phone\": \"1234567895\",\n    \"ssn\": \"555667777\",\n    \"state\": \"Kentucky\",\n    \"zip\": \"40507\"\n  },\n  \"ProcessingInfo\": {\n    \"annualCCSales\": \"500000\",\n    \"avgTicket\": \"50\",\n    \"legal_b2b\": \"50\",\n    \"legal_b2c\": \"50\",\n    \"legal_cnpinternet\": \"50\",\n    \"legal_cnpphoneemail\": \"50\",\n    \"legal_cp\": \"50\",\n    \"legal_percentdeliveredover30days\": \"50\",\n    \"legal_percentdeliveredsameday\": \"50\",\n    \"legal_productssold\": \"Goods\",\n    \"percentdelievered7days\": \"50\",\n    \"percentdelivered14days\": \"50\",\n    \"processing_environment\": \"Ecommerce\"\n  }\n}"

response = http.request(request)
puts response.read_body

201

{
  "data": {
    "businessname": "Slab Ready Mix",
    "email": "[e-mail]",
    "merchant_key": "9f496121110e19b36b862e97559bbd9ffe0bd0a7335b2884e071ea6d6d59cc34",
    "public_key": "28e2464f8b8726847cec7196beb7d0c6"
  },
  "message": "Merchant onboarding successfully",
  "result": true
}

Authorizations

Authorization · string · header · required

Use your Fractal API credentials.

Username = Client ID Password = Secret Key

Sandbox credentials can be generated from the Test Portal.

Body

application/json

BankingInfo · object · required

Show child attributes

BusinessInfo · object · required

Show child attributes

OwnerInfo · object · required

Show child attributes

ProcessingInfo · object · required

Show child attributes

Response

201 - application/json

Full Merchant Submit

data · object

Show child attributes

message · string

Example:

"Merchant onboarding successfully"

result · boolean

Example:

true