Create a Buyer

This page will provide a basic example of creating a buyer payment type VCN. The fields I provided in the example below are the minimum you need to make a buyer. You need to replace the buyer and institution filed with your information.

POST to https://sandbox-api.cpxenterprise.com/buyer/v1/buyer

{
  "status": "Approved",
  "name": "BuyerName", 
  "externalStatus": "Active",
  "associatedInstitutionName": "YourInstitutionName",
  "associatedInstitutionId": "60ea3gc4-35b3-5f58-9f0e-6b8e8f2fe2df",
  "bid": "BuyerId",
  "virtualCardRequested": true,
  "address": {
    "street1": "2001 Westside Pkwy",
    "city": "Alpharetta",
    "state": "GA",
    "country": "USA",
    "postalCode": "30004"
 						 }
  },
  
  "bankAccounts":
  [
  	{
	 "id": "Bank Name",
     "accountType": "checking",
     "accountNumber": "7687432567",
     "routingNumber": "061000052"
  	}
  ]
}
"fweoifw32-32f23o2-3fj32o" //buyer id

Below is a GET request to our API to know if your buyer has been successfully created. You can find the buyer.id from the response of the call for making a buyer.

Get to https://sandbox-api.cpxenterprise.com/buyer/v1/buyer/{buyer. id}

{
    "status": "Approved",
    "acl": [
        "pps:cpx-acquiring",
        "buyer:xxxxxxxx-xxxx-xxxxx-837c-594e31774ab5",
        "institution:xxxxx-xxxxx-xxxx-xxe-6b8e812fe2df",
        "network:xxxxxx4-xxxxx-xxxxx-bbbd-435ea27c28d6"
    ],
    "address": {
        "country": "USA"
      
    }

You can review our developer documentation for adding banks to your buyer here: https://developer.cpxchange.com/reference#apicreate-2