Marketplace APIs (PFAC)
POST Application/pfac/Signup
# Don't forget to add your HMAC Authorization Headers
data = {
"companyId": 12342,
"numberOfOutlets": 1,
"cartDetails": {
"data": [
{
"id": "88683",
"name": "CLOVER FLEX",
"term": "O",
"qty": "1",
"productType": "ITERM"
},
{
"id": "10438",
"name": "VISA",
"term": "P",
"qty": "1",
"productType": "ACQUIRING"
},
{
"id": "10439",
"name": "AMEX",
"term": "P",
"qty": "1",
"productType": "ACQUIRING"
}
],
"amount": "0",
"shipping_amount": "0",
"tax": "0",
"taxPercent": "0",
"total": "0",
"status": "0",
"shipping_option_id": "1",
"purchaseEnabled": true,
"total_qty": "1"
},
"pricingDetails": [
{
"productId": "777-1000105664",
"description": "Visa Qualified Credit",
"feeMinAbsolute": "0.01",
"feeMin": "0.01",
"feeDefault": "0.00",
"feeMax": "0.4",
"feeMaxAbsolute": "0.4",
"minAmountAbsolute": "0.01",
"minAmt": "0.01",
"defaultAmt": "0.29",
"maxAmt": "0.4",
"maxAmountAbsolute": "0.4",
"quantity": "1",
"rateMinAbsolute": "1.5",
"rateMin": "1.5",
"rateDefault": "0.00",
"rateMax": "10",
"rateMaxAbsolute": "10",
"productName": "Visa Qualified Credit",
"productType": "NET_FEE",
"isOverride": "false",
"override": "false",
"showoncart": "false",
"purchaseType": "P",
"occurrence": {
"type": "Transaction"
},
"groupName": "",
"pricingTypeCategory": "ALL"
},
{
"productId": "777-1000105665",
"description": "Mastercard Qualified Credit",
"feeMinAbsolute": "0.00",
"feeMin": "0.00",
"feeDefault": "0.00",
"feeMax": "0.0",
"feeMaxAbsolute": "0.0",
"minAmountAbsolute": "0.00",
"minAmt": "0.00",
"defaultAmt": "0.00",
"maxAmt": "0.0",
"maxAmountAbsolute": "0.0",
"quantity": "1",
"rateMinAbsolute": "0.0",
"rateMin": "0.0",
"rateDefault": "0.00",
"rateMax": "00",
"rateMaxAbsolute": "00",
"productName": "Mastercard Qualified Credit",
"productType": "NET_FEE",
"isOverride": "false",
"override": "false",
"showoncart": "false",
"purchaseType": "P",
"occurrence": {
"type": "Transaction"
},
"groupName": "",
"pricingTypeCategory": "ALL"
},
{
"productId": "3",
"description": "MASTERCARD TRANSACTION FEE",
"feeMinAbsolute": 0,
"feeMin": 0,
"feeDefault": 0,
"feeMax": 0,
"feeMaxAbsolute": 0,
"minAmountAbsolute": 0,
"minAmt": 0,
"defaultAmt": 0,
"maxAmt": 0,
"maxAmountAbsolute": 0,
"quantity": 1,
"rateMinAbsolute": 0,
"rateMin": 0,
"rateDefault": 0,
"rateMax": 0,
"rateMaxAbsolute": 0,
"productName": "MASTERCARD TRANSACTION FEE",
"productType": "NET_FEE",
"isOverride": false,
"override": false,
"showoncart": false,
"purchaseType": "P",
"occurrence": {
"type": "Transaction"
},
"groupName": "",
"pricingTypeCategory": "ALL"
},
{
"productId": "2",
"description": "VISA TRANSACTION FEE",
"feeMinAbsolute": 0,
"feeMin": 0,
"feeDefault": 0,
"feeMax": 0,
"feeMaxAbsolute": 0,
"minAmountAbsolute": 0,
"minAmt": 0,
"defaultAmt": 0,
"maxAmt": 0,
"maxAmountAbsolute": 0,
"quantity": 1,
"rateMinAbsolute": 0,
"rateMin": 0,
"rateDefault": 0,
"rateMax": 0,
"rateMaxAbsolute": 0,
"productName": "VISA TRANSACTION FEE",
"productType": "NET_FEE",
"isOverride": false,
"override": false,
"showoncart": false,
"purchaseType": "P",
"occurrence": {
"type": "Transaction"
},
"groupName": "",
"pricingTypeCategory": "ALL"
}
],
"merchantCreditInformation": {
"bbbRating": "good",
"complaints12Months": 0,
"complaints36Months": 0,
"OFACReviewPassed": "Y",
"totalDocumentsNumber": 2
},
"siteSurvey": {
"siteVisitation": "Y",
"onSiteVisitPerformed": "Y",
"productsandServicesSold": "OPTICAL"
},
"gftNumber": "800000001221",
"globalFeeDetails": {
"chainNumber": "350123456880",
"globalFeeTableNumber": "800000001221",
"globalFeeTableDescription": "KINDERS"
},
"merchantTransactionInformation": {
"mccTypes": "Business to Business (Supplies)",
"mcc": "5812",
"annualVolume": 3000,
"averageTicket": 500,
"highestTicket": 2,
"category": "RETAIL",
"amexMemberId": 1
},
"merchantContactInformation": [
{
"contactType": "LOCATION",
"state": "CA",
"postalCode": "94536",
"address1": "123 DONTSHIP",
"address2": "TEST ST",
"address3": "TEST ST",
"email": "test@gyft.com",
"url": "ENT.COM",
"phone": "2435325432",
"country": "USA",
"city": "Mountain View"
},
{
"contactType": "CORPORATE",
"state": "CA",
"postalCode": "94536",
"address1": "123 OWNER ADDR",
"address2": "TEST ST",
"address3": "TEST ST",
"phone": "2435325432",
"country": "USA",
"city": "Mountain View",
"email": "test@gyft.com",
"url": "ENT.COM"
},
{
"contactType": "TRADING",
"state": "CA",
"postalCode": "94536",
"address1": "123 OWNER ADDR",
"address2": "TEST ST",
"address3": "TEST ST",
"phone": "2435325432",
"country": "USA",
"city": "Mountain View",
"email": "test@gyft.com",
"url": "ENT.COM"
},
{
"contactType": "BILLING",
"state": "CA",
"postalCode": "94536",
"address1": "123 OWNER ADDR",
"address2": "TEST ST",
"address3": "TEST ST",
"phone": "2435325432",
"country": "USA",
"city": "Mountain View",
"email": "test@gyft.com",
"url": "ENT.COM"
},
{
"contactType": "PRINCIPAL",
"state": "CA",
"postalCode": "94536",
"address1": "11311 McCormick Road",
"address2": "Suite 300",
"address3": "TEST ST",
"phone": "2435325432",
"country": "USA",
"city": "Hunt Valley",
"email": "test@gyft.com",
"url": "ENT.COM"
}
],
"merchantLocationInformation": [
{
"timeframeforDelivery": {
"percentDelivered0Days": "10",
"percentDelivered7Days": "0",
"percentDelivered14Days": "0",
"percentDelivered30Days": "10",
"percentDeliveredMore30Days": "80"
},
"percentOfAnnualCardVolume": {
"businessToBusiness": "0",
"businessToConsumer": "100"
},
"percentageOfTotalAnnualVolume": {
"businessToBusiness": "0",
"businessToConsumer": "100"
},
"highestTicket": 56,
"faceToFace": "100",
"percentTransactionsOverPhoneorEmail": "0",
"percentTransactionsOverInternet": "0",
"stateOfIncorporation": "HI",
"taxFilingName": "MMIS-TEST YP12111",
"istheBusinessaForeignEntity": "C",
"irsSparkExclusion": "N",
"tinRequestedGuid": "17487900F244257DA",
"dbaName": "MMIS-TEST YP12111",
"legalName": "MMIS-TEST YP12111",
"employeeIdentificationNumber": "111891111",
"yearsInBusiness": "2006-06-01",
"yearsAtLocation": "2006-06-01",
"organizationType": "corporation",
"obtained": "Y",
"type": "Company Prepared Tax Returns",
"endDate": "2017-03-01",
"cash": "1000",
"agentEmail": "test@gyft.com",
"numberOfMonths": "12",
"totalRevenue": "2000",
"netIncome": "1000",
"totalAssets": "2500",
"totalLiabilities": "1500",
"tangibleNetWorth": "2400",
"workingCapital": "2300",
"currentRation": "1.2",
"debtToTNWRatio": "0.5",
"country": "USA",
"salesCurrency": [
{
"currency": "USD"
}
],
"payeezyIndicator": "N",
"visa": "Y",
"mc": "N",
"serviceLevel": "01",
"tokenType": "01",
"transArmorTokenType": "0001",
"fundingCurrency": [
{
"currency": "USD"
}
],
"contactName": "contactName",
"contractSignDate": "2018-01-01",
"legalContactName": "legalCntactName",
"yearIncorporated": "2000"
}
],
"bankInformation": [
{
"instName": "JPMORGAN CHASE BANK, NA",
"abaNumber": "122100024",
"accountNumber": "123",
"accountType": "deposits"
}
],
"ownerInformation": [
{
"lastName": "Graham",
"firstName": "Jackson",
"nationalId": "989898989",
"dateOfBirth": "1983-03-16",
"title": "PARTNER",
"percentageOwnership": 100,
"isPrimary": "Y",
"isCreditBureauReportAvailable": "Y",
"bureauScore": "600",
"governmentDocumentVerified": "Y",
"gender": "M",
"governmentDocument": "SSN CARD",
"thirdPartyDatabaseVerified": "N",
"thirdPartyDatabaseType": "a",
"taxId": "989898989",
"nationalIdType": "SSN"
}
]
}
endpoint = "/marketplace/v1/pfac/application/signup"
r = requests.post(url + endpoint, json=data, headers=headers)
print(r)
# Don't forget to add your HMAC Authorization Headers
ENDPOINT="$URL/marketplace/v1/pfac/application/signup"
curl -X POST -H "date: $DATE" -H "Authorization: $HMAC_AUTH" -H "Content-Type:application/json" --data
'{
"companyId": 12342,
"numberOfOutlets": 1,
"cartDetails": {
"data": [
{
"id": "88683",
"name": "CLOVER FLEX",
"term": "O",
"qty": "1",
"productType": "ITERM"
},
{
"id": "10438",
"name": "VISA",
"term": "P",
"qty": "1",
"productType": "ACQUIRING"
},
{
"id": "10439",
"name": "AMEX",
"term": "P",
"qty": "1",
"productType": "ACQUIRING"
}
],
"amount": "0",
"shipping_amount": "0",
"tax": "0",
"taxPercent": "0",
"total": "0",
"status": "0",
"shipping_option_id": "1",
"purchaseEnabled": true,
"total_qty": "1"
},
"pricingDetails": [
{
"productId": "777-1000105664",
"description": "Visa Qualified Credit",
"feeMinAbsolute": "0.01",
"feeMin": "0.01",
"feeDefault": "0.00",
"feeMax": "0.4",
"feeMaxAbsolute": "0.4",
"minAmountAbsolute": "0.01",
"minAmt": "0.01",
"defaultAmt": "0.29",
"maxAmt": "0.4",
"maxAmountAbsolute": "0.4",
"quantity": "1",
"rateMinAbsolute": "1.5",
"rateMin": "1.5",
"rateDefault": "0.00",
"rateMax": "10",
"rateMaxAbsolute": "10",
"productName": "Visa Qualified Credit",
"productType": "NET_FEE",
"isOverride": "false",
"override": "false",
"showoncart": "false",
"purchaseType": "P",
"occurrence": {
"type": "Transaction"
},
"groupName": "",
"pricingTypeCategory": "ALL"
},
{
"productId": "777-1000105665",
"description": "Mastercard Qualified Credit",
"feeMinAbsolute": "0.00",
"feeMin": "0.00",
"feeDefault": "0.00",
"feeMax": "0.0",
"feeMaxAbsolute": "0.0",
"minAmountAbsolute": "0.00",
"minAmt": "0.00",
"defaultAmt": "0.00",
"maxAmt": "0.0",
"maxAmountAbsolute": "0.0",
"quantity": "1",
"rateMinAbsolute": "0.0",
"rateMin": "0.0",
"rateDefault": "0.00",
"rateMax": "00",
"rateMaxAbsolute": "00",
"productName": "Mastercard Qualified Credit",
"productType": "NET_FEE",
"isOverride": "false",
"override": "false",
"showoncart": "false",
"purchaseType": "P",
"occurrence": {
"type": "Transaction"
},
"groupName": "",
"pricingTypeCategory": "ALL"
},
{
"productId": "3",
"description": "MASTERCARD TRANSACTION FEE",
"feeMinAbsolute": 0,
"feeMin": 0,
"feeDefault": 0,
"feeMax": 0,
"feeMaxAbsolute": 0,
"minAmountAbsolute": 0,
"minAmt": 0,
"defaultAmt": 0,
"maxAmt": 0,
"maxAmountAbsolute": 0,
"quantity": 1,
"rateMinAbsolute": 0,
"rateMin": 0,
"rateDefault": 0,
"rateMax": 0,
"rateMaxAbsolute": 0,
"productName": "MASTERCARD TRANSACTION FEE",
"productType": "NET_FEE",
"isOverride": false,
"override": false,
"showoncart": false,
"purchaseType": "P",
"occurrence": {
"type": "Transaction"
},
"groupName": "",
"pricingTypeCategory": "ALL"
},
{
"productId": "2",
"description": "VISA TRANSACTION FEE",
"feeMinAbsolute": 0,
"feeMin": 0,
"feeDefault": 0,
"feeMax": 0,
"feeMaxAbsolute": 0,
"minAmountAbsolute": 0,
"minAmt": 0,
"defaultAmt": 0,
"maxAmt": 0,
"maxAmountAbsolute": 0,
"quantity": 1,
"rateMinAbsolute": 0,
"rateMin": 0,
"rateDefault": 0,
"rateMax": 0,
"rateMaxAbsolute": 0,
"productName": "VISA TRANSACTION FEE",
"productType": "NET_FEE",
"isOverride": false,
"override": false,
"showoncart": false,
"purchaseType": "P",
"occurrence": {
"type": "Transaction"
},
"groupName": "",
"pricingTypeCategory": "ALL"
}
],
"merchantCreditInformation": {
"bbbRating": "good",
"complaints12Months": 0,
"complaints36Months": 0,
"OFACReviewPassed": "Y",
"totalDocumentsNumber": 2
},
"siteSurvey": {
"siteVisitation": "Y",
"onSiteVisitPerformed": "Y",
"productsandServicesSold": "OPTICAL"
},
"gftNumber": "800000001221",
"globalFeeDetails": {
"chainNumber": "350123456880",
"globalFeeTableNumber": "800000001221",
"globalFeeTableDescription": "KINDERS"
},
"merchantTransactionInformation": {
"mccTypes": "Business to Business (Supplies)",
"mcc": "5812",
"annualVolume": 3000,
"averageTicket": 500,
"highestTicket": 2,
"category": "RETAIL",
"amexMemberId": 1
},
"merchantContactInformation": [
{
"contactType": "LOCATION",
"state": "CA",
"postalCode": "94536",
"address1": "123 DONTSHIP",
"address2": "TEST ST",
"address3": "TEST ST",
"email": "test@gyft.com",
"url": "ENT.COM",
"phone": "2435325432",
"country": "USA",
"city": "Mountain View"
},
{
"contactType": "CORPORATE",
"state": "CA",
"postalCode": "94536",
"address1": "123 OWNER ADDR",
"address2": "TEST ST",
"address3": "TEST ST",
"phone": "2435325432",
"country": "USA",
"city": "Mountain View",
"email": "test@gyft.com",
"url": "ENT.COM"
},
{
"contactType": "TRADING",
"state": "CA",
"postalCode": "94536",
"address1": "123 OWNER ADDR",
"address2": "TEST ST",
"address3": "TEST ST",
"phone": "2435325432",
"country": "USA",
"city": "Mountain View",
"email": "test@gyft.com",
"url": "ENT.COM"
},
{
"contactType": "BILLING",
"state": "CA",
"postalCode": "94536",
"address1": "123 OWNER ADDR",
"address2": "TEST ST",
"address3": "TEST ST",
"phone": "2435325432",
"country": "USA",
"city": "Mountain View",
"email": "test@gyft.com",
"url": "ENT.COM"
},
{
"contactType": "PRINCIPAL",
"state": "CA",
"postalCode": "94536",
"address1": "11311 McCormick Road",
"address2": "Suite 300",
"address3": "TEST ST",
"phone": "2435325432",
"country": "USA",
"city": "Hunt Valley",
"email": "test@gyft.com",
"url": "ENT.COM"
}
],
"merchantLocationInformation": [
{
"timeframeforDelivery": {
"percentDelivered0Days": "10",
"percentDelivered7Days": "0",
"percentDelivered14Days": "0",
"percentDelivered30Days": "10",
"percentDeliveredMore30Days": "80"
},
"percentOfAnnualCardVolume": {
"businessToBusiness": "0",
"businessToConsumer": "100"
},
"percentageOfTotalAnnualVolume": {
"businessToBusiness": "0",
"businessToConsumer": "100"
},
"highestTicket": 56,
"faceToFace": "100",
"percentTransactionsOverPhoneorEmail": "0",
"percentTransactionsOverInternet": "0",
"stateOfIncorporation": "HI",
"taxFilingName": "MMIS-TEST YP12111",
"istheBusinessaForeignEntity": "C",
"irsSparkExclusion": "N",
"tinRequestedGuid": "17487900F244257DA",
"dbaName": "MMIS-TEST YP12111",
"legalName": "MMIS-TEST YP12111",
"employeeIdentificationNumber": "111891111",
"yearsInBusiness": "2006-06-01",
"yearsAtLocation": "2006-06-01",
"organizationType": "corporation",
"obtained": "Y",
"type": "Company Prepared Tax Returns",
"endDate": "2017-03-01",
"cash": "1000",
"agentEmail": "test@gyft.com",
"numberOfMonths": "12",
"totalRevenue": "2000",
"netIncome": "1000",
"totalAssets": "2500",
"totalLiabilities": "1500",
"tangibleNetWorth": "2400",
"workingCapital": "2300",
"currentRation": "1.2",
"debtToTNWRatio": "0.5",
"country": "USA",
"salesCurrency": [
{
"currency": "USD"
}
],
"payeezyIndicator": "N",
"visa": "Y",
"mc": "N",
"serviceLevel": "01",
"tokenType": "01",
"transArmorTokenType": "0001",
"fundingCurrency": [
{
"currency": "USD"
}
],
"contactName": "contactName",
"contractSignDate": "2018-01-01",
"legalContactName": "legalCntactName",
"yearIncorporated": "2000"
}
],
"bankInformation": [
{
"instName": "JPMORGAN CHASE BANK, NA",
"abaNumber": "122100024",
"accountNumber": "123",
"accountType": "deposits"
}
],
"ownerInformation": [
{
"lastName": "Graham",
"firstName": "Jackson",
"nationalId": "989898989",
"dateOfBirth": "1983-03-16",
"title": "PARTNER",
"percentageOwnership": 100,
"isPrimary": "Y",
"isCreditBureauReportAvailable": "Y",
"bureauScore": "600",
"governmentDocumentVerified": "Y",
"gender": "M",
"governmentDocument": "SSN CARD",
"thirdPartyDatabaseVerified": "N",
"thirdPartyDatabaseType": "a",
"taxId": "989898989",
"nationalIdType": "SSN"
}
]
}' $ENDPOINT
// Don't forget to add your HMAC Authorization Headers
var options = {
method: 'POST',
url: url + '/marketplace/v1/pfac/application/signup',
headers: getAuthenticationHeaders(),
body: {
"companyId": 12342,
"numberOfOutlets": 1,
"cartDetails": {
"data": [
{
"id": "88683",
"name": "CLOVER FLEX",
"term": "O",
"qty": "1",
"productType": "ITERM"
},
{
"id": "10438",
"name": "VISA",
"term": "P",
"qty": "1",
"productType": "ACQUIRING"
},
{
"id": "10439",
"name": "AMEX",
"term": "P",
"qty": "1",
"productType": "ACQUIRING"
}
],
"amount": "0",
"shipping_amount": "0",
"tax": "0",
"taxPercent": "0",
"total": "0",
"status": "0",
"shipping_option_id": "1",
"purchaseEnabled": true,
"total_qty": "1"
},
"pricingDetails": [
{
"productId": "777-1000105664",
"description": "Visa Qualified Credit",
"feeMinAbsolute": "0.01",
"feeMin": "0.01",
"feeDefault": "0.00",
"feeMax": "0.4",
"feeMaxAbsolute": "0.4",
"minAmountAbsolute": "0.01",
"minAmt": "0.01",
"defaultAmt": "0.29",
"maxAmt": "0.4",
"maxAmountAbsolute": "0.4",
"quantity": "1",
"rateMinAbsolute": "1.5",
"rateMin": "1.5",
"rateDefault": "0.00",
"rateMax": "10",
"rateMaxAbsolute": "10",
"productName": "Visa Qualified Credit",
"productType": "NET_FEE",
"isOverride": "false",
"override": "false",
"showoncart": "false",
"purchaseType": "P",
"occurrence": {
"type": "Transaction"
},
"groupName": "",
"pricingTypeCategory": "ALL"
},
{
"productId": "777-1000105665",
"description": "Mastercard Qualified Credit",
"feeMinAbsolute": "0.00",
"feeMin": "0.00",
"feeDefault": "0.00",
"feeMax": "0.0",
"feeMaxAbsolute": "0.0",
"minAmountAbsolute": "0.00",
"minAmt": "0.00",
"defaultAmt": "0.00",
"maxAmt": "0.0",
"maxAmountAbsolute": "0.0",
"quantity": "1",
"rateMinAbsolute": "0.0",
"rateMin": "0.0",
"rateDefault": "0.00",
"rateMax": "00",
"rateMaxAbsolute": "00",
"productName": "Mastercard Qualified Credit",
"productType": "NET_FEE",
"isOverride": "false",
"override": "false",
"showoncart": "false",
"purchaseType": "P",
"occurrence": {
"type": "Transaction"
},
"groupName": "",
"pricingTypeCategory": "ALL"
},
{
"productId": "3",
"description": "MASTERCARD TRANSACTION FEE",
"feeMinAbsolute": 0,
"feeMin": 0,
"feeDefault": 0,
"feeMax": 0,
"feeMaxAbsolute": 0,
"minAmountAbsolute": 0,
"minAmt": 0,
"defaultAmt": 0,
"maxAmt": 0,
"maxAmountAbsolute": 0,
"quantity": 1,
"rateMinAbsolute": 0,
"rateMin": 0,
"rateDefault": 0,
"rateMax": 0,
"rateMaxAbsolute": 0,
"productName": "MASTERCARD TRANSACTION FEE",
"productType": "NET_FEE",
"isOverride": false,
"override": false,
"showoncart": false,
"purchaseType": "P",
"occurrence": {
"type": "Transaction"
},
"groupName": "",
"pricingTypeCategory": "ALL"
},
{
"productId": "2",
"description": "VISA TRANSACTION FEE",
"feeMinAbsolute": 0,
"feeMin": 0,
"feeDefault": 0,
"feeMax": 0,
"feeMaxAbsolute": 0,
"minAmountAbsolute": 0,
"minAmt": 0,
"defaultAmt": 0,
"maxAmt": 0,
"maxAmountAbsolute": 0,
"quantity": 1,
"rateMinAbsolute": 0,
"rateMin": 0,
"rateDefault": 0,
"rateMax": 0,
"rateMaxAbsolute": 0,
"productName": "VISA TRANSACTION FEE",
"productType": "NET_FEE",
"isOverride": false,
"override": false,
"showoncart": false,
"purchaseType": "P",
"occurrence": {
"type": "Transaction"
},
"groupName": "",
"pricingTypeCategory": "ALL"
}
],
"merchantCreditInformation": {
"bbbRating": "good",
"complaints12Months": 0,
"complaints36Months": 0,
"OFACReviewPassed": "Y",
"totalDocumentsNumber": 2
},
"siteSurvey": {
"siteVisitation": "Y",
"onSiteVisitPerformed": "Y",
"productsandServicesSold": "OPTICAL"
},
"gftNumber": "800000001221",
"globalFeeDetails": {
"chainNumber": "350123456880",
"globalFeeTableNumber": "800000001221",
"globalFeeTableDescription": "KINDERS"
},
"merchantTransactionInformation": {
"mccTypes": "Business to Business (Supplies)",
"mcc": "5812",
"annualVolume": 3000,
"averageTicket": 500,
"highestTicket": 2,
"category": "RETAIL",
"amexMemberId": 1
},
"merchantContactInformation": [
{
"contactType": "LOCATION",
"state": "CA",
"postalCode": "94536",
"address1": "123 DONTSHIP",
"address2": "TEST ST",
"address3": "TEST ST",
"email": "test@gyft.com",
"url": "ENT.COM",
"phone": "2435325432",
"country": "USA",
"city": "Mountain View"
},
{
"contactType": "CORPORATE",
"state": "CA",
"postalCode": "94536",
"address1": "123 OWNER ADDR",
"address2": "TEST ST",
"address3": "TEST ST",
"phone": "2435325432",
"country": "USA",
"city": "Mountain View",
"email": "test@gyft.com",
"url": "ENT.COM"
},
{
"contactType": "TRADING",
"state": "CA",
"postalCode": "94536",
"address1": "123 OWNER ADDR",
"address2": "TEST ST",
"address3": "TEST ST",
"phone": "2435325432",
"country": "USA",
"city": "Mountain View",
"email": "test@gyft.com",
"url": "ENT.COM"
},
{
"contactType": "BILLING",
"state": "CA",
"postalCode": "94536",
"address1": "123 OWNER ADDR",
"address2": "TEST ST",
"address3": "TEST ST",
"phone": "2435325432",
"country": "USA",
"city": "Mountain View",
"email": "test@gyft.com",
"url": "ENT.COM"
},
{
"contactType": "PRINCIPAL",
"state": "CA",
"postalCode": "94536",
"address1": "11311 McCormick Road",
"address2": "Suite 300",
"address3": "TEST ST",
"phone": "2435325432",
"country": "USA",
"city": "Hunt Valley",
"email": "test@gyft.com",
"url": "ENT.COM"
}
],
"merchantLocationInformation": [
{
"timeframeforDelivery": {
"percentDelivered0Days": "10",
"percentDelivered7Days": "0",
"percentDelivered14Days": "0",
"percentDelivered30Days": "10",
"percentDeliveredMore30Days": "80"
},
"percentOfAnnualCardVolume": {
"businessToBusiness": "0",
"businessToConsumer": "100"
},
"percentageOfTotalAnnualVolume": {
"businessToBusiness": "0",
"businessToConsumer": "100"
},
"highestTicket": 56,
"faceToFace": "100",
"percentTransactionsOverPhoneorEmail": "0",
"percentTransactionsOverInternet": "0",
"stateOfIncorporation": "HI",
"taxFilingName": "MMIS-TEST YP12111",
"istheBusinessaForeignEntity": "C",
"irsSparkExclusion": "N",
"tinRequestedGuid": "17487900F244257DA",
"dbaName": "MMIS-TEST YP12111",
"legalName": "MMIS-TEST YP12111",
"employeeIdentificationNumber": "111891111",
"yearsInBusiness": "2006-06-01",
"yearsAtLocation": "2006-06-01",
"organizationType": "corporation",
"obtained": "Y",
"type": "Company Prepared Tax Returns",
"endDate": "2017-03-01",
"cash": "1000",
"agentEmail": "test@gyft.com",
"numberOfMonths": "12",
"totalRevenue": "2000",
"netIncome": "1000",
"totalAssets": "2500",
"totalLiabilities": "1500",
"tangibleNetWorth": "2400",
"workingCapital": "2300",
"currentRation": "1.2",
"debtToTNWRatio": "0.5",
"country": "USA",
"salesCurrency": [
{
"currency": "USD"
}
],
"payeezyIndicator": "N",
"visa": "Y",
"mc": "N",
"serviceLevel": "01",
"tokenType": "01",
"transArmorTokenType": "0001",
"fundingCurrency": [
{
"currency": "USD"
}
],
"contactName": "contactName",
"contractSignDate": "2018-01-01",
"legalContactName": "legalCntactName",
"yearIncorporated": "2000"
}
],
"bankInformation": [
{
"instName": "JPMORGAN CHASE BANK, NA",
"abaNumber": "122100024",
"accountNumber": "123",
"accountType": "deposits"
}
],
"ownerInformation": [
{
"lastName": "Graham",
"firstName": "Jackson",
"nationalId": "989898989",
"dateOfBirth": "1983-03-16",
"title": "PARTNER",
"percentageOwnership": 100,
"isPrimary": "Y",
"isCreditBureauReportAvailable": "Y",
"bureauScore": "600",
"governmentDocumentVerified": "Y",
"gender": "M",
"governmentDocument": "SSN CARD",
"thirdPartyDatabaseVerified": "N",
"thirdPartyDatabaseType": "a",
"taxId": "989898989",
"nationalIdType": "SSN"
}
]
},
json: true
};
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
// Don't forget to add your HMAC Authorization Headers
try {
String jsonString = "{\n \"companyId\": 12342,\n \"numberOfOutlets\": 1,\n \"cartDetails\": {\n \"data\": [\n {\n \"id\": \"88683\",\n \"name\": \"CLOVER FLEX\",\n \"term\": \"O\",\n \"qty\": \"1\",\n \"productType\": \"ITERM\"\n },\n {\n \"id\": \"10438\",\n \"name\": \"VISA\",\n \"term\": \"P\",\n \"qty\": \"1\",\n \"productType\": \"ACQUIRING\"\n },\n {\n \"id\": \"10439\",\n \"name\": \"AMEX\",\n \"term\": \"P\",\n \"qty\": \"1\",\n \"productType\": \"ACQUIRING\"\n }\n ],\n \"amount\": \"0\",\n \"shipping_amount\": \"0\",\n \"tax\": \"0\",\n \"taxPercent\": \"0\",\n \"total\": \"0\",\n \"status\": \"0\",\n \"shipping_option_id\": \"1\",\n \"purchaseEnabled\": true,\n \"total_qty\": \"1\"\n },\n \"pricingDetails\": [\n {\n \"productId\": \"777-1000105664\",\n \"description\": \"Visa Qualified Credit\",\n \"feeMinAbsolute\": \"0.01\",\n \"feeMin\": \"0.01\",\n \"feeDefault\": \"0.00\",\n \"feeMax\": \"0.4\",\n \"feeMaxAbsolute\": \"0.4\",\n \"minAmountAbsolute\": \"0.01\",\n \"minAmt\": \"0.01\",\n \"defaultAmt\": \"0.29\",\n \"maxAmt\": \"0.4\",\n \"maxAmountAbsolute\": \"0.4\",\n \"quantity\": \"1\",\n \"rateMinAbsolute\": \"1.5\",\n \"rateMin\": \"1.5\",\n \"rateDefault\": \"0.00\",\n \"rateMax\": \"10\",\n \"rateMaxAbsolute\": \"10\",\n \"productName\": \"Visa Qualified Credit\",\n \"productType\": \"NET_FEE\",\n \"isOverride\": \"false\",\n \"override\": \"false\",\n \"showoncart\": \"false\",\n \"purchaseType\": \"P\",\n \"occurrence\": {\n \"type\": \"Transaction\"\n },\n \"groupName\": \"\",\n \"pricingTypeCategory\": \"ALL\"\n },\n {\n \"productId\": \"777-1000105665\",\n \"description\": \"Mastercard Qualified Credit\",\n \"feeMinAbsolute\": \"0.00\",\n \"feeMin\": \"0.00\",\n \"feeDefault\": \"0.00\",\n \"feeMax\": \"0.0\",\n \"feeMaxAbsolute\": \"0.0\",\n \"minAmountAbsolute\": \"0.00\",\n \"minAmt\": \"0.00\",\n \"defaultAmt\": \"0.00\",\n \"maxAmt\": \"0.0\",\n \"maxAmountAbsolute\": \"0.0\",\n \"quantity\": \"1\",\n \"rateMinAbsolute\": \"0.0\",\n \"rateMin\": \"0.0\",\n \"rateDefault\": \"0.00\",\n \"rateMax\": \"00\",\n \"rateMaxAbsolute\": \"00\",\n \"productName\": \"Mastercard Qualified Credit\",\n \"productType\": \"NET_FEE\",\n \"isOverride\": \"false\",\n \"override\": \"false\",\n \"showoncart\": \"false\",\n \"purchaseType\": \"P\",\n \"occurrence\": {\n \"type\": \"Transaction\"\n },\n \"groupName\": \"\",\n \"pricingTypeCategory\": \"ALL\"\n },\n {\n \"productId\": \"3\",\n \"description\": \"MASTERCARD TRANSACTION FEE\",\n \"feeMinAbsolute\": 0,\n \"feeMin\": 0,\n \"feeDefault\": 0,\n \"feeMax\": 0,\n \"feeMaxAbsolute\": 0,\n \"minAmountAbsolute\": 0,\n \"minAmt\": 0,\n \"defaultAmt\": 0,\n \"maxAmt\": 0,\n \"maxAmountAbsolute\": 0,\n \"quantity\": 1,\n \"rateMinAbsolute\": 0,\n \"rateMin\": 0,\n \"rateDefault\": 0,\n \"rateMax\": 0,\n \"rateMaxAbsolute\": 0,\n \"productName\": \"MASTERCARD TRANSACTION FEE\",\n \"productType\": \"NET_FEE\",\n \"isOverride\": false,\n \"override\": false,\n \"showoncart\": false,\n \"purchaseType\": \"P\",\n \"occurrence\": {\n \"type\": \"Transaction\"\n },\n \"groupName\": \"\",\n \"pricingTypeCategory\": \"ALL\"\n },\n {\n \"productId\": \"2\",\n \"description\": \"VISA TRANSACTION FEE\",\n \"feeMinAbsolute\": 0,\n \"feeMin\": 0,\n \"feeDefault\": 0,\n \"feeMax\": 0,\n \"feeMaxAbsolute\": 0,\n \"minAmountAbsolute\": 0,\n \"minAmt\": 0,\n \"defaultAmt\": 0,\n \"maxAmt\": 0,\n \"maxAmountAbsolute\": 0,\n \"quantity\": 1,\n \"rateMinAbsolute\": 0,\n \"rateMin\": 0,\n \"rateDefault\": 0,\n \"rateMax\": 0,\n \"rateMaxAbsolute\": 0,\n \"productName\": \"VISA TRANSACTION FEE\",\n \"productType\": \"NET_FEE\",\n \"isOverride\": false,\n \"override\": false,\n \"showoncart\": false,\n \"purchaseType\": \"P\",\n \"occurrence\": {\n \"type\": \"Transaction\"\n },\n \"groupName\": \"\",\n \"pricingTypeCategory\": \"ALL\"\n }\n ],\n \"merchantCreditInformation\": {\n \"bbbRating\": \"good\",\n \"complaints12Months\": 0,\n \"complaints36Months\": 0,\n \"OFACReviewPassed\": \"Y\",\n \"totalDocumentsNumber\": 2\n },\n \"siteSurvey\": {\n \"siteVisitation\": \"Y\",\n \"onSiteVisitPerformed\": \"Y\",\n \"productsandServicesSold\": \"OPTICAL\"\n },\n \"gftNumber\": \"800000001221\",\n \"globalFeeDetails\": {\n \"chainNumber\": \"350123456880\",\n \"globalFeeTableNumber\": \"800000001221\",\n \"globalFeeTableDescription\": \"KINDERS\"\n },\n \"merchantTransactionInformation\": {\n \"mccTypes\": \"Business to Business (Supplies)\",\n \"mcc\": \"5812\",\n \"annualVolume\": 3000,\n \"averageTicket\": 500,\n \"highestTicket\": 2,\n \"category\": \"RETAIL\",\n \"amexMemberId\": 1\n },\n \"merchantContactInformation\": [\n {\n \"contactType\": \"LOCATION\",\n \"state\": \"CA\",\n \"postalCode\": \"94536\",\n \"address1\": \"123 DONTSHIP\",\n \"address2\": \"TEST ST\",\n \"address3\": \"TEST ST\",\n \"email\": \"test@gyft.com\",\n \"url\": \"ENT.COM\",\n \"phone\": \"2435325432\",\n \"country\": \"USA\",\n \"city\": \"Mountain View\"\n },\n {\n \"contactType\": \"CORPORATE\",\n \"state\": \"CA\",\n \"postalCode\": \"94536\",\n \"address1\": \"123 OWNER ADDR\",\n \"address2\": \"TEST ST\",\n \"address3\": \"TEST ST\",\n \"phone\": \"2435325432\",\n \"country\": \"USA\",\n \"city\": \"Mountain View\",\n \"email\": \"test@gyft.com\",\n \"url\": \"ENT.COM\"\n },\n {\n \"contactType\": \"TRADING\",\n \"state\": \"CA\",\n \"postalCode\": \"94536\",\n \"address1\": \"123 OWNER ADDR\",\n \"address2\": \"TEST ST\",\n \"address3\": \"TEST ST\",\n \"phone\": \"2435325432\",\n \"country\": \"USA\",\n \"city\": \"Mountain View\",\n \"email\": \"test@gyft.com\",\n \"url\": \"ENT.COM\"\n },\n {\n \"contactType\": \"BILLING\",\n \"state\": \"CA\",\n \"postalCode\": \"94536\",\n \"address1\": \"123 OWNER ADDR\",\n \"address2\": \"TEST ST\",\n \"address3\": \"TEST ST\",\n \"phone\": \"2435325432\",\n \"country\": \"USA\",\n \"city\": \"Mountain View\",\n \"email\": \"test@gyft.com\",\n \"url\": \"ENT.COM\"\n },\n {\n \"contactType\": \"PRINCIPAL\",\n \"state\": \"CA\",\n \"postalCode\": \"94536\",\n \"address1\": \"11311 McCormick Road\",\n \"address2\": \"Suite 300\",\n \"address3\": \"TEST ST\",\n \"phone\": \"2435325432\",\n \"country\": \"USA\",\n \"city\": \"Hunt Valley\",\n \"email\": \"test@gyft.com\",\n \"url\": \"ENT.COM\"\n }\n ],\n \"merchantLocationInformation\": [\n {\n \"timeframeforDelivery\": {\n \"percentDelivered0Days\": \"10\",\n \"percentDelivered7Days\": \"0\",\n \"percentDelivered14Days\": \"0\",\n \"percentDelivered30Days\": \"10\",\n \"percentDeliveredMore30Days\": \"80\"\n },\n \"percentOfAnnualCardVolume\": {\n \"businessToBusiness\": \"0\",\n \"businessToConsumer\": \"100\"\n },\n \"percentageOfTotalAnnualVolume\": {\n \"businessToBusiness\": \"0\",\n \"businessToConsumer\": \"100\"\n },\n \"highestTicket\": 56,\n \"faceToFace\": \"100\",\n \"percentTransactionsOverPhoneorEmail\": \"0\",\n \"percentTransactionsOverInternet\": \"0\",\n \"stateOfIncorporation\": \"HI\",\n \"taxFilingName\": \"MMIS-TEST YP12111\",\n \"istheBusinessaForeignEntity\": \"C\",\n \"irsSparkExclusion\": \"N\",\n \"tinRequestedGuid\": \"17487900F244257DA\",\n \"dbaName\": \"MMIS-TEST YP12111\",\n \"legalName\": \"MMIS-TEST YP12111\",\n \"employeeIdentificationNumber\": \"111891111\",\n \"yearsInBusiness\": \"2006-06-01\",\n \"yearsAtLocation\": \"2006-06-01\",\n \"organizationType\": \"corporation\",\n \"obtained\": \"Y\",\n \"type\": \"Company Prepared Tax Returns\",\n \"endDate\": \"2017-03-01\",\n \"cash\": \"1000\",\n \"agentEmail\": \"test@gyft.com\",\n \"numberOfMonths\": \"12\",\n \"totalRevenue\": \"2000\",\n \"netIncome\": \"1000\",\n \"totalAssets\": \"2500\",\n \"totalLiabilities\": \"1500\",\n \"tangibleNetWorth\": \"2400\",\n \"workingCapital\": \"2300\",\n \"currentRation\": \"1.2\",\n \"debtToTNWRatio\": \"0.5\",\n \"country\": \"USA\",\n \"salesCurrency\": [\n {\n \"currency\": \"USD\"\n }\n ],\n \"payeezyIndicator\": \"N\",\n \"visa\": \"Y\",\n \"mc\": \"N\",\n \"serviceLevel\": \"01\",\n \"tokenType\": \"01\",\n \"transArmorTokenType\": \"0001\",\n \"fundingCurrency\": [\n {\n \"currency\": \"USD\"\n }\n ],\n \"contactName\": \"contactName\",\n \"contractSignDate\": \"2018-01-01\",\n \"legalContactName\": \"legalCntactName\",\n \"yearIncorporated\": \"2000\"\n }\n ],\n \"bankInformation\": [\n {\n \"instName\": \"JPMORGAN CHASE BANK, NA\",\n \"abaNumber\": \"122100024\",\n \"accountNumber\": \"123\",\n \"accountType\": \"deposits\"\n }\n ],\n \"ownerInformation\": [\n {\n \"lastName\": \"Graham\",\n \"firstName\": \"Jackson\",\n \"nationalId\": \"989898989\",\n \"dateOfBirth\": \"1983-03-16\",\n \"title\": \"PARTNER\",\n \"percentageOwnership\": 100,\n \"isPrimary\": \"Y\",\n \"isCreditBureauReportAvailable\": \"Y\",\n \"bureauScore\": \"600\",\n \"governmentDocumentVerified\": \"Y\",\n \"gender\": \"M\",\n \"governmentDocument\": \"SSN CARD\",\n \"thirdPartyDatabaseVerified\": \"N\",\n \"thirdPartyDatabaseType\": \"a\",\n \"taxId\": \"989898989\",\n \"nationalIdType\": \"SSN\"\n }\n ]\n}";
StringEntity payload = new StringEntity(jsonString);
HttpResponse response = doPost("/marketplace/v1/pfac/application/signup", payload);
int statusCode = response.getStatusLine().getStatusCode();
String response_string = EntityUtils.toString(response.getEntity());
JSONObject json = new JSONObject(response_string);
System.out.println("json:" + json.toString());
catch (Exception e) {
e.printStackTrace();
}
<?php
# Don't forget to add your HMAC Authorization Headers
# Note: the "document" string below is an incomplete example
$data = (
array (
'companyId' => 12342,
'numberOfOutlets' => 1,
'cartDetails' =>
array (
'data' =>
array (
0 =>
array (
'id' => '88683',
'name' => 'CLOVER FLEX',
'term' => 'O',
'qty' => '1',
'productType' => 'ITERM',
),
1 =>
array (
'id' => '10438',
'name' => 'VISA',
'term' => 'P',
'qty' => '1',
'productType' => 'ACQUIRING',
),
2 =>
array (
'id' => '10439',
'name' => 'AMEX',
'term' => 'P',
'qty' => '1',
'productType' => 'ACQUIRING',
),
),
'amount' => '0',
'shipping_amount' => '0',
'tax' => '0',
'taxPercent' => '0',
'total' => '0',
'status' => '0',
'shipping_option_id' => '1',
'purchaseEnabled' => true,
'total_qty' => '1',
),
'pricingDetails' =>
array (
0 =>
array (
'productId' => '777-1000105664',
'description' => 'Visa Qualified Credit',
'feeMinAbsolute' => '0.01',
'feeMin' => '0.01',
'feeDefault' => '0.00',
'feeMax' => '0.4',
'feeMaxAbsolute' => '0.4',
'minAmountAbsolute' => '0.01',
'minAmt' => '0.01',
'defaultAmt' => '0.29',
'maxAmt' => '0.4',
'maxAmountAbsolute' => '0.4',
'quantity' => '1',
'rateMinAbsolute' => '1.5',
'rateMin' => '1.5',
'rateDefault' => '0.00',
'rateMax' => '10',
'rateMaxAbsolute' => '10',
'productName' => 'Visa Qualified Credit',
'productType' => 'NET_FEE',
'isOverride' => 'false',
'override' => 'false',
'showoncart' => 'false',
'purchaseType' => 'P',
'occurrence' =>
array (
'type' => 'Transaction',
),
'groupName' => '',
'pricingTypeCategory' => 'ALL',
),
1 =>
array (
'productId' => '777-1000105665',
'description' => 'Mastercard Qualified Credit',
'feeMinAbsolute' => '0.00',
'feeMin' => '0.00',
'feeDefault' => '0.00',
'feeMax' => '0.0',
'feeMaxAbsolute' => '0.0',
'minAmountAbsolute' => '0.00',
'minAmt' => '0.00',
'defaultAmt' => '0.00',
'maxAmt' => '0.0',
'maxAmountAbsolute' => '0.0',
'quantity' => '1',
'rateMinAbsolute' => '0.0',
'rateMin' => '0.0',
'rateDefault' => '0.00',
'rateMax' => '00',
'rateMaxAbsolute' => '00',
'productName' => 'Mastercard Qualified Credit',
'productType' => 'NET_FEE',
'isOverride' => 'false',
'override' => 'false',
'showoncart' => 'false',
'purchaseType' => 'P',
'occurrence' =>
array (
'type' => 'Transaction',
),
'groupName' => '',
'pricingTypeCategory' => 'ALL',
),
2 =>
array (
'productId' => '3',
'description' => 'MASTERCARD TRANSACTION FEE',
'feeMinAbsolute' => 0,
'feeMin' => 0,
'feeDefault' => 0,
'feeMax' => 0,
'feeMaxAbsolute' => 0,
'minAmountAbsolute' => 0,
'minAmt' => 0,
'defaultAmt' => 0,
'maxAmt' => 0,
'maxAmountAbsolute' => 0,
'quantity' => 1,
'rateMinAbsolute' => 0,
'rateMin' => 0,
'rateDefault' => 0,
'rateMax' => 0,
'rateMaxAbsolute' => 0,
'productName' => 'MASTERCARD TRANSACTION FEE',
'productType' => 'NET_FEE',
'isOverride' => false,
'override' => false,
'showoncart' => false,
'purchaseType' => 'P',
'occurrence' =>
array (
'type' => 'Transaction',
),
'groupName' => '',
'pricingTypeCategory' => 'ALL',
),
3 =>
array (
'productId' => '2',
'description' => 'VISA TRANSACTION FEE',
'feeMinAbsolute' => 0,
'feeMin' => 0,
'feeDefault' => 0,
'feeMax' => 0,
'feeMaxAbsolute' => 0,
'minAmountAbsolute' => 0,
'minAmt' => 0,
'defaultAmt' => 0,
'maxAmt' => 0,
'maxAmountAbsolute' => 0,
'quantity' => 1,
'rateMinAbsolute' => 0,
'rateMin' => 0,
'rateDefault' => 0,
'rateMax' => 0,
'rateMaxAbsolute' => 0,
'productName' => 'VISA TRANSACTION FEE',
'productType' => 'NET_FEE',
'isOverride' => false,
'override' => false,
'showoncart' => false,
'purchaseType' => 'P',
'occurrence' =>
array (
'type' => 'Transaction',
),
'groupName' => '',
'pricingTypeCategory' => 'ALL',
),
),
'merchantCreditInformation' =>
array (
'bbbRating' => 'good',
'complaints12Months' => 0,
'complaints36Months' => 0,
'OFACReviewPassed' => 'Y',
'totalDocumentsNumber' => 2,
),
'siteSurvey' =>
array (
'siteVisitation' => 'Y',
'onSiteVisitPerformed' => 'Y',
'productsandServicesSold' => 'OPTICAL',
),
'gftNumber' => '800000001221',
'globalFeeDetails' =>
array (
'chainNumber' => '350123456880',
'globalFeeTableNumber' => '800000001221',
'globalFeeTableDescription' => 'KINDERS',
),
'merchantTransactionInformation' =>
array (
'mccTypes' => 'Business to Business (Supplies)',
'mcc' => '5812',
'annualVolume' => 3000,
'averageTicket' => 500,
'highestTicket' => 2,
'category' => 'RETAIL',
'amexMemberId' => 1,
),
'merchantContactInformation' =>
array (
0 =>
array (
'contactType' => 'LOCATION',
'state' => 'CA',
'postalCode' => '94536',
'address1' => '123 DONTSHIP',
'address2' => 'TEST ST',
'address3' => 'TEST ST',
'email' => 'test@gyft.com',
'url' => 'ENT.COM',
'phone' => '2435325432',
'country' => 'USA',
'city' => 'Mountain View',
),
1 =>
array (
'contactType' => 'CORPORATE',
'state' => 'CA',
'postalCode' => '94536',
'address1' => '123 OWNER ADDR',
'address2' => 'TEST ST',
'address3' => 'TEST ST',
'phone' => '2435325432',
'country' => 'USA',
'city' => 'Mountain View',
'email' => 'test@gyft.com',
'url' => 'ENT.COM',
),
2 =>
array (
'contactType' => 'TRADING',
'state' => 'CA',
'postalCode' => '94536',
'address1' => '123 OWNER ADDR',
'address2' => 'TEST ST',
'address3' => 'TEST ST',
'phone' => '2435325432',
'country' => 'USA',
'city' => 'Mountain View',
'email' => 'test@gyft.com',
'url' => 'ENT.COM',
),
3 =>
array (
'contactType' => 'BILLING',
'state' => 'CA',
'postalCode' => '94536',
'address1' => '123 OWNER ADDR',
'address2' => 'TEST ST',
'address3' => 'TEST ST',
'phone' => '2435325432',
'country' => 'USA',
'city' => 'Mountain View',
'email' => 'test@gyft.com',
'url' => 'ENT.COM',
),
4 =>
array (
'contactType' => 'PRINCIPAL',
'state' => 'CA',
'postalCode' => '94536',
'address1' => '11311 McCormick Road',
'address2' => 'Suite 300',
'address3' => 'TEST ST',
'phone' => '2435325432',
'country' => 'USA',
'city' => 'Hunt Valley',
'email' => 'test@gyft.com',
'url' => 'ENT.COM',
),
),
'merchantLocationInformation' =>
array (
0 =>
array (
'timeframeforDelivery' =>
array (
'percentDelivered0Days' => '10',
'percentDelivered7Days' => '0',
'percentDelivered14Days' => '0',
'percentDelivered30Days' => '10',
'percentDeliveredMore30Days' => '80',
),
'percentOfAnnualCardVolume' =>
array (
'businessToBusiness' => '0',
'businessToConsumer' => '100',
),
'percentageOfTotalAnnualVolume' =>
array (
'businessToBusiness' => '0',
'businessToConsumer' => '100',
),
'highestTicket' => 56,
'faceToFace' => '100',
'percentTransactionsOverPhoneorEmail' => '0',
'percentTransactionsOverInternet' => '0',
'stateOfIncorporation' => 'HI',
'taxFilingName' => 'MMIS-TEST YP12111',
'istheBusinessaForeignEntity' => 'C',
'irsSparkExclusion' => 'N',
'tinRequestedGuid' => '17487900F244257DA',
'dbaName' => 'MMIS-TEST YP12111',
'legalName' => 'MMIS-TEST YP12111',
'employeeIdentificationNumber' => '111891111',
'yearsInBusiness' => '2006-06-01',
'yearsAtLocation' => '2006-06-01',
'organizationType' => 'corporation',
'obtained' => 'Y',
'type' => 'Company Prepared Tax Returns',
'endDate' => '2017-03-01',
'cash' => '1000',
'agentEmail' => 'test@gyft.com',
'numberOfMonths' => '12',
'totalRevenue' => '2000',
'netIncome' => '1000',
'totalAssets' => '2500',
'totalLiabilities' => '1500',
'tangibleNetWorth' => '2400',
'workingCapital' => '2300',
'currentRation' => '1.2',
'debtToTNWRatio' => '0.5',
'country' => 'USA',
'salesCurrency' =>
array (
0 =>
array (
'currency' => 'USD',
),
),
'payeezyIndicator' => 'N',
'visa' => 'Y',
'mc' => 'N',
'serviceLevel' => '01',
'tokenType' => '01',
'transArmorTokenType' => '0001',
'fundingCurrency' =>
array (
0 =>
array (
'currency' => 'USD',
),
),
'contactName' => 'contactName',
'contractSignDate' => '2018-01-01',
'legalContactName' => 'legalCntactName',
'yearIncorporated' => '2000',
),
),
'bankInformation' =>
array (
0 =>
array (
'instName' => 'JPMORGAN CHASE BANK, NA',
'abaNumber' => '122100024',
'accountNumber' => '123',
'accountType' => 'deposits',
),
),
'ownerInformation' =>
array (
0 =>
array (
'lastName' => 'Graham',
'firstName' => 'Jackson',
'nationalId' => '989898989',
'dateOfBirth' => '1983-03-16',
'title' => 'PARTNER',
'percentageOwnership' => 100,
'isPrimary' => 'Y',
'isCreditBureauReportAvailable' => 'Y',
'bureauScore' => '600',
'governmentDocumentVerified' => 'Y',
'gender' => 'M',
'governmentDocument' => 'SSN CARD',
'thirdPartyDatabaseVerified' => 'N',
'thirdPartyDatabaseType' => 'a',
'taxId' => '989898989',
'nationalIdType' => 'SSN',
),
),
)
);
$data_json = json_encode($data);
$headers = array(
'date: ' . $date,
'Authorization: ' . $hmacAuth,
'Content-Type: application/json',
'Content-Length: ' . strlen($data_json)
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url . "/marketplace/v1/pfac/application/signup");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data_json);
$res = curl_exec($ch);
curl_close($ch);
?>
The above command returns JSON structured like this:
{
"orderId": "dLwD1"
}
This service allows us to create PFAC merchant order by using merchant information and PFAC setup data. As part of the service it also validates product data and merchant information. In short this service is combination of /checkout and /update.
Request
`POST /marketplace/v1/pfac/application/signup
The endpoint takes a JSON object
as input containing merchant and transaction information and product data.
Note on “DOM.” and “INT.” columns:
- DOM.: Required for domestic transactions
- INT.: Required for international transactions
Parameter | Dom. | Int. | Data Type | Description |
---|---|---|---|---|
numberOfOutlets | ✔ | integer | Number of outlets (locations) the business has. If not provided, default to 1 . | |
siteSurvey | ✔ | ✔ | object | Object containing site survey information. |
siteVisitation | ✔ | ✔ | string | Note: siteVisitation is required field when percentTransactionsOverInternet is greater than 0. |
productsandServicesSold | ✔ | ✔ | string | A small description of what products and services are sold at the business location |
merchantCreditInformation | ✔ | ✔ | object | Object containing information used by First Data to determine credit worthiness of a merchant. |
merchantTransactionInformation | ✔ | ✔ | object | Transactions information used to determine pricing. Contains mccTypes , mcc , annualVolume , averageTicket , highestTicket and category . |
mcc | ✔ | ✔ | string | MCC Code (refer to: GET MCC/Category). |
annualVolume | ✔ | ✔ | long | Actual or estimated annual credit card transaction volume in USD. |
averageTicket | ✔ | ✔ | long | Actual or estimated average ticket price in USD. |
highestTicket | ✔ | long | Actual or estimated highest ticket price in USD. | |
amexMemberId | long | Amex Member ID is the entitlement number associated with your submerchant account. | ||
category | ✔ | ✔ | string | Category name eg: "RETAIL/MOTO" (refer to: GET Categories). |
merchantContactInformation | ✔ | ✔ | array | Array of (minimum one) object(s), each of which represent business information for a location. Each contains contactType , address1 , address2 , city , state , postalCode , country , email , phone and url . |
contactType | ✔ | ✔ | string | Type of location. Valid values: "TRADING" , "BILLING" , "LOCATION" , "PRINCIPAL" . |
state | ✔ | string | Trading state the business is located in, abbreviated format. i.e. for California send "CA" . | |
postalCode | ✔ | string | Trading Postal Code or Zip Code. | |
address1 | ✔ | ✔ | string | Trading Address line 1. |
address2 | string | Second line of street address, if applicable. i.e. Unit, Floor, Suite, etc. | ||
address3 | string | Third line of street address. | ||
url | string | URL of business website is required of a PFAC Sub-Merchant if the Percent of Transaction Volume is greater than 0% for eCommerce. | ||
country | ✔ | ✔ | string | Trading Country code the business is located in. |
phone | ✔ | ✔ | string | Value should be 10 digits, Error message: phone is invalid. |
province | string | Trading Province the business is located in. | ||
city | ✔ | ✔ | string | City the business is located in. |
merchantLocationInformation | ✔ | ✔ | array | Array of (minimum one) object (s) that is required to submit the application form containing transaction and legal information. |
timeframeforDelivery | ✔ | ✔ | object | Object containing options for time frame for delivery of services after transaction. Sum of all options must equal 100%. |
percentDelivered0Days | ✔ | ✔ | string | Percentage of services delivered within 0 days after transaction. |
percentDelivered7Days | ✔ | ✔ | string | Percentage of services delivered between 1-7 days after transaction. |
percentDelivered14Days | ✔ | ✔ | string | Percentage of services delivered between 8-14 days after transaction. |
percentDelivered30Days | ✔ | ✔ | string | Percentage of services delivered between 15-30 days after transaction. |
percentDeliveredMore30Days | ✔ | ✔ | string | Percentage of services delivered more than 30 days after transaction. |
highestTicket | ✔ | long | Actual or estimated highest ticket price in USD. | |
amexVolume | ✔ | long | If amex entitlement sent on the contract, then creditCardVolume is required.If creditCardVolume is more than a Million, then amexVolume is required. If the amexVolume not entered then API will throw error message, error code: 10195, Error Message: “Missing merchant TransactionInformation amexVolume. | |
faceToFace | ✔ | ✔ | string | Percentage of payments/transactions made face to face (can’t exceed 100%). |
percentTransactionsOverPhoneorEmail | ✔ | ✔ | string | Percentage of payments/transactions made by phone or email (can’t exceed 100%). |
percentTransactionsOverInternet | ✔ | ✔ | string | Percentage of payments/transactions made on the internet (can’t exceed 100%). |
stateOfIncorporation | ✔ | string | State of incorporation in abbreviated format. i.e. for California send "CA" . | |
taxFilingName | ✔ | string | IRS tax filing name for the business. Needs to be validated against employeeIdentificationNumber using the POST TIN/Validate service. | |
istheBusinessaForeignEntity | ✔ | string | "Y" or "N" . Indicates if the business can claim foreign status according to IRS regulations. | |
dbaName | ✔ | ✔ | string | Doing business as name. |
legalName | ✔ | ✔ | string | Legal business name. |
employeeIdentificationNumber | ✔ | string | A Taxpayer Identification Number (TIN) is an identification number used by the Internal Revenue Service (IRS). Needs to be validated against taxFilingName using the POST TIN/Validate service. | |
yearsInBusiness | ✔ | string | Number of years in business. For example "2006-06-01" | |
organizationType | string | Business Legal Form- Sample values are SOLE PROPRIETOR , Partnership, LLC , Private Corp , Public Corp , Government, Not for profit. | ||
currency | ✔ | ✔ | string | Currency the submerchant will use for transactions. For example: USD |
transProcessingFee | ✔ | string | Trans Processing Fee (Flat Fee). | |
transInitiationFee | ✔ | string | Trans Initiation Fee (Flat Fee). | |
transSuccessFee | ✔ | string | Trans Success Fee (%). | |
transRefundFee | ✔ | string | Trans Refund Fee (Flat Fee). | |
transChargeBackFee | ✔ | string | Trans Chargeback Fee (Flat Fee). | |
pricingType | string | |||
yearIncorporated | ✔ | ✔ | string | Year of incorporation in "yyyy" format. For example "1936" . |
visa | ✔ | ✔ | string | Visa processing. "Y" or "N" . |
mc | ✔ | ✔ | string | Mastercard processing. "Y" or "N" . |
Discover | ✔ | ✔ | string | Discover processing. "Y" or "N" . |
Amex | ✔ | ✔ | string | American Express processing. "Y" or "N" . |
contractSignDate | ✔ | string | Sub-merchant contract sign date in "yyyy-mm-dd" format. | |
legalContactName | ✔ | string | ||
percentOfAnnualCardVolume | ✔ | ✔ | array | Array of Minimum 1 object(s). Sum of all options must equal 100%. |
businessToBusiness | ✔ | ✔ | string | Percentage of total annual volume Business to Business. |
businessToConsumer | ✔ | ✔ | string | Percentage of total annual volume Business to Business. |
multiCurrency | string | Possible values: "O" , "B" , "N" . | ||
registrationNo | string | Merchant Company registration number. | ||
vatRegNo | ✔ | string | A value added tax identification number or VAT identification number (VATIN) is an identifier used in many countries, including the countries of the European Union, for value added tax purposes. | |
timeZone | ✔ | string | Time zone. | |
bankInformation | ✔ | ✔ | array | Array of object(s) (min. 1, max. 2) containing the ACH information. Each object contains abaNumber , accountNumber and instnName . |
abaNumber | ✔ | ✔ | string | Bank routing number. |
accountNumber | ✔ | ✔ | string | Account number. |
instName | ✔ | ✔ | string | Financial institution name. |
fundingCurrency | ✔ | string | The funding currency is the currency in which the merchant will be paid for the transaction or debited in the case of a chargeback. | |
bankCountry | ✔ | string | Merchant’s bank country. | |
accountTypeId | ✔ | string | A list of account types contained within the Institution. | |
paymentFormat | string | Format used to present payments to the clearing entity. | ||
bankCity | string | City where bank is located. | ||
accountName | string | Merchants bank account name. | ||
sortCode | string | A sort code is a number which is assigned to a branch of a bank for internal purposes. They are typically 6 digits in the format ##-##-## and most commonly used by banks in the UK. | ||
swiftCode | string | A SWIFT code is an international bank code that identifies particular banks worldwide consisting of 8 or 11 characters. | ||
iban | string | IBAN is a series of alphanumeric characters (up to 34, dependent on country) that uniquely identifies an account held at any bank anywhere in the world. | ||
bankPhone | string | Phone number of the bank. | ||
contactName | string | Name of bank contact. | ||
ownerInformation | ✔ | ✔ | array | Array of (minimum one) object (s) to collect information about the owner(s) of the business. Mandatory to capture and verify the identity of each natural person that owns 25% or more of the equity interest of the legal entity. (Max 4). |
lastName | ✔ | ✔ | string | Owner’s last name. |
firstName | ✔ | ✔ | string | Owner’s first name. |
nationalId | ✔ | ✔ | string | Owner’s Social Security Number in ”#########“ format. |
nationalIdType | ✔ | string | ||
dateOfBirth | ✔ | ✔ | string | Owner’s date of birth in "yyyy-mm-dd" format. |
title | ✔ | ✔ | string | Owner’s title in the organization. |
taxId | ✔ | ✔ | string | 9 Digit Owner’s tax ID or SSN. SSN should not start with 1. |
percentageOwnership | ✔ | ✔ | integer | Percentage of ownership in case of multiple owners. |
isPrimary | string | "Y" or "N" . Is Primary Owner. | ||
pricingDetails | ✔ | array | Array of object each containing the information of a product (hardware, software, acquiring, fees, etc.) in the order. For Domestic only. | |
productId | ✔ | string | Canonical identifier of the product. | |
defaultAmt | ✔ | double | Price/amount to be collected (usually as a one-time payment) in USD. | |
feeDefault | ✔ | double | Fee charged per occurrence in USD. | |
rateDefault | ✔ | double | Percentage of transaction amount charged per occurrence . | |
quantity | ✔ | integer | Quantity of the product to be added to the Order. | |
clientFee | ✔ | array | ||
productId | ✔ | string | ||
feeDefault | ✔ | double | ||
merchantFee | ✔ | array | ||
productId | ✔ | string | ||
feeDefault | ✔ | double | ||
paymentMethodInformation | ✔ | array | Array of (minimum one) objects to collect information about the local payments with sub-merchant Fee | |
productId | ✔ | string | Local Payment product ID. | |
personInformation | ✔ | array | ||
lastName | ✔ | string | Last name. | |
firstName | ✔ | string | First name. | |
middleName | ✔ | string | Middle name. | |
title | ✔ | string | ||
dateOfBrith | ✔ | string | Date of birth. | |
addressLine | ✔ | string | Address. | |
city | ✔ | string | City. | |
state | ✔ | string | State. | |
zipCode | ✔ | string | Zip code. | |
country | ✔ | string | Country. | |
type | ✔ | string | Type (Partner, Owner, Director). | |
gftNumber | string | |||
globalFeeDetails | ✔ | object | ||
chainNumber | ✔ | string | ||
globalFeeTableNumber | ✔ | string | ||
globalFeeTableDescription | ✔ | string |
Possible values for legalForm
Value | Meaning |
---|---|
"SOLE PROPRIETOR" | SOLE PROPRIETOR |
"Partnership" | Partnership |
"Public Corp" | Public Corporation |
"Private Corp" | Private Corporation |
"LLC" | Limited Liability Company |
"Government" | Government |
"Not for profit" | Non-profit, Tax Exempt |
Response
The endpoint returns an object
containing an string
which serves as the confirmation for the submission.
Parameter | Data Type | Description |
---|---|---|
orderId | string | Order Id. The unique identifier to be used in the following processes as input to reference the order. |