PApayu-com
PF-Submerchant-Registration

Create a Submerchant

post/api/v2_1/firms/{firmPublicId}/submerchants

Request

Path parameters

Firm id in alphanumeric format, visible in the merchant panel.

Headers

Content-Typestring required

Content type

Authorizationstring required

Auth token

Request body

OR
OR

Example request

{
  "payTypeCategories": [
    "CARD"
  ]
}

Response

idstring

Id assigned by PayU and required in OrderCreateRequest.

externalIdstring

Id assigned by the Payment Facilitator.

status'NOT_ACTIVE' | 'ACTIVE' | 'BLOCKED'

Submerchant status.

lastUpdatedstring YYYY-MM-DDThh:mm:ss±hh:mm

Datetime of resource creation or last update (if applicable) in ISO 8601 format.

notifyUrlstring

Notifications regarding submerchant status change will be sent to address provided in this field.

legalNamestring

Full legal (registration) name.

dbaNamestring

"Doing business as" name, usually simplified website address which can be recognized by customer (e.g. when displayed on card statement).

phonestring

Contact phone number.

websiteUrlstring

A valid URL address of merchant's website.

mccnumber

Accurate Merchant Category Code established during KYC process by the PF.

riskClass'LOW' | 'NORMAL' | 'HIGH'

Risk class assigned by Payment Facilitator (basing on requirements provided by PayU).

taxIdstring

Tax identification (e.g. NIP in Poland) or business identification (e.g. IČ in Czechia).

legalFormstring

Dictionary value - legal entity type. Dictionaries for specific origin are available here.

agreementDatestring yyyy-mm-dd

Date when PF signed agreement with the submerchant (required by Visa for reporting purposes).

payTypeCategoriesstring[]

Array of enumerated values: CARD, PBL. Minimum one is required.

Example response

{
  "payTypeCategories": [
    "CARD",
    "PBL"
  ]
}

Changes

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