Skip to content
/
Create merchant

Create merchant

Request

Creates a new merchant.

Security
oauth2(Required scopes: merchant:create) or bearerAuth or apiKeyHeader
Path
companyIdstringrequired

The unique company identifier.

Bodyapplication/jsonrequired
addressobject(AddressBase)

The mailing address.

businessNamestringrequired

The business name of the merchant. Can be displayed in UI.

businessTypeDisplayNamestring

The business type/description as shown to borrowers. For example: 'Merchant', 'Dealer', or 'Venue'. Defaults to 'Merchant' if no value is provided.

disputesContactEmailstring, <= 320 characters

The email of the merchant's disputes department.

disputesContactNamestring, <= 256 characters

The name of the merchant's disputes department.

disputesContactPhonestring, <= 15 characters

The phone number of the merchant's disputes department.

externalIdstring

A lender's identifier for the merchant.

parentMerchantIdstring or null

The parent merchant identifier. Used to represent hierarchy of merchant sub entities. Can be Peach or lender's external identifier.

primaryContactEmailstring, <= 320 characters

The email of the merchant's primary contact person or department.

primaryContactNamestring, <= 256 characters

The name of the merchant's primary contact person or department.

primaryContactPhonestring, <= 15 characters

The phone number of the merchant's primary contact person or department.

subEntitynamestring

The sub entity business name of the merchant. For example: Online Sephora.

POST
/companies/{companyId}/merchants
curl -i -X POST \
  'https://sandboxapi.peach.finance/api/companies/{companyId}/merchants' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": {
      "POBox": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "country": "string",
      "countyOrRegion": "string",
      "postalCode": "string",
      "state": "strin"
    },
    "businessName": "string",
    "businessTypeDisplayName": "string",
    "disputesContactEmail": "string",
    "disputesContactName": "string",
    "disputesContactPhone": "string",
    "externalId": "string",
    "parentMerchantId": "string",
    "primaryContactEmail": "string",
    "primaryContactName": "string",
    "primaryContactPhone": "string",
    "subEntityname": "string"
  }'

Responses

Success

Bodyapplication/json
messagestring

Description of the server action or error.

statusinteger

HTTP status code.

dataobject(Merchant)
Response
{
  "message": "string",
  "status": 0,
  "data": {
    "createdAt": "2019-08-24T14:15:22Z",
    "deletedAt": "2019-08-24T14:15:22Z",
    "id": "string",
    "updatedAt": "2019-08-24T14:15:22Z",
    "address": { … },
    "businessName": "string",
    "businessTypeDisplayName": "string",
    "disputesContactEmail": "string",
    "disputesContactName": "string",
    "disputesContactPhone": "string",
    "externalId": "string",
    "parentMerchantId": "string",
    "primaryContactEmail": "string",
    "primaryContactName": "string",
    "primaryContactPhone": "string",
    "subEntityname": "string"
  }
}