Ajouter/Mettre à jour le site
A site must be created prior to making any of the standard API calls. A unique site should be created for each unique Merchant ID (MID).
Point de terminaison
The following endpoint can be used to add or update sites. You must replace the {base_url} variable.
POST
{base_url}/api/v3.1/site/addUpdate
Le même point de terminaison est utilisé pour ajouter ou mettre à jour a site. Si a site existe déjà avec le {external_id} , le site sera mis à jour sinon il sera inséré.
Demande
Champ
Type
Description
external_id
String
Le numéro d'identification unique attribué par le système/source de données. Si nous détectons un enregistrement avec le même external_id, il sera mis à jour, sinon il sera ajouté.
name
String
Le nom du site/entreprise.
merchant_id
String
L'identifiant du commerçant attribué à l'entreprise par la banque acquéreuse/le processeur.
agency
Agency
Une référence au dossier de l'agence.
location
L'adresse commerciale de ce site/entreprise.
primary_contact
Le principal responsable de l'entreprise. Non requis si access_type = api_only.
site_enterprise
Une référence au dossier de l'entreprise du site.
site_group
Une référence à l'enregistrement du groupe de sites.
branding
La marque unique de l'entreprise, y compris le logo et la couleur principale.
access_type
String
Le niveau d'accès que le site demande. Utilisez api_only si vous ne souhaitez pas envoyer le courriel de bienvenue au contact principal.
Default = basic | One of api_only, basic, pro
Default = basic | One of api_only, basic, pro
active
Boolean
Ce drapeau représente si l'enregistrement du site est actif et disponible pour être utilisé ou non.
Default = true
Default = true
webhook
Configurer des webhooks pour recevoir des mises à jour en temps réel lorsque des données liées à ce site sont mises à jour.
payment_types
Les modes de paiement disponibles pour accepter les paiements des clients. Au moins un mode de paiement est requis.
Sample Request
{
"external_id": "12345678",
"name": "Sample Company",
"merchant_id": "123544633452",
"agency": {
"external_id": "65123125",
"name": "Sample Agency"
},
"location": {
"address_line1": "123 Main Street",
"address_line2": "Suite 123",
"city": "Naples",
"state_code": "FL",
"zip_code": "34102",
"phone": "239-123-1234",
"website": "https://samplecompany.com"
},
"primary_contact": {
"first_name": "Thomas",
"last_name": "Smith",
"email": "tsmith@samplecompany.com",
"mobile_phone": "239-987-6543"
},
"payment_types": {
"payment_card": {
"active": true,
"gateway": {
"code": "gatewaycode",
"credentials": {
"key": "value",
"key_2": "value2"
}
}
},
"ach": {
"active": true,
"gateway": {
"code": "gatewaycode",
"credentials": {
"key": "value",
"key_2": "value2"
}
}
}
},
"branding": {
"logo_url": "https://samplecompany.com/images/logo.png",
"logo_base64": "",
"color": "#336699"
},
"access_type": "basic",
"active": true,
"webhook": {
"active": true,
"url": "https://mysoftware.com/webhook"
}
}
Réponse
Champ
Type
Description
success
Boolean
Whether the record was added or updated successfully.
action
String
Informs whether the record was added or updated. Will only be returned if success is true.
One of added, updated
One of added, updated
_id
String
The auto generated id assigned to the record.
errors
String [ ]
A list of errors. Will only be returned if success is false.
Sample Response (Successful)
{
"success": true,
"action": "added",
"_id": "60f720d248f143332af022e0"
}
Sample Response (Failed)
{
"success": false,
"errors": [
"invalid field2",
"missing field_name"
]
}