PApayu-com
Partner-Merchant-Registration

Create a Firm

Create a Firm entity for your partner.

post/api/v2_1/firms

Request

Headers

Content-Typestring required

Content type

Authorizationstring required

Auth token with <code>grant_type=client_credentials</code>.

Request body

namestring required

Full legal name.

typestring required

Dictionary value - legal entity type. Dictionary is available here. For a firm which <code>address.country</code> code is not equal to <code>businessArea.origin</code> please use <b>FZ</b> type. <b>Providing accurate type speeds up merchant verification.</b>

taxIdstring required

Tax identification.

taxIdType'NIP' | 'VAT_EU' | 'TAX_ID' required

Type of tax identification.

cinstring required

Business identification. IČ (CZ) or REGON (PL).

partnerIdstring required

Your partner id.

contactLanguage'EN' | 'PL' | 'CS' | 'RO'

Preferred language for communication.

technicalContactDataobject

Object containing firm's technical contact details (e.g. to the developer responsible for integration with PayU).

Example request

{
  "name": "Test sp. z o.o.",
  "type": "SO",
  "taxId": "3771910486",
  "taxIdType": "NIP",
  "cin": "138237420",
  "partnerId": "egmcvdo5",
  "contactLanguage": "PL",
  "businessArea": {
    "origin": "PL"
  },
  "users": [
    {
      "name": "Jan",
      "surname": "Nowak",
      "email": "jan.nowak@testowa.pl",
      "role": "MANAGER"
    }
  ],
  "representatives": [
    {
      "name": "Jan",
      "surname": "Nowak",
      "countryCode": "PL",
      "birthDate": "2000-01-01",
      "birthCountryCode": "pl"
    }
  ],
  "contactData": {
    "email": "biuro@testowa.pl"
  },
  "address": {
    "street": "Grunwaldzka",
    "postalCode": "61-166",
    "city": "Poznań",
    "countryCode": "PL"
  },
  "correspondenceAddress": {
    "street": "Grunwaldzka",
    "postalCode": "61-166",
    "city": "Poznań",
    "countryCode": "PL"
  }
}

Response

firmIdstring

Identifier that needs to be stored in your system and is used to create further entities for that firm.

Example response

{
  "firmId": "KzXy4ZzD"
}

Changes

No recorded changes to this operation across all 1 revision of this API.