Skip to main content
POST
https://api.onepay.la/v1
/
merchants
Crear sub comercio
curl --request POST \
  --url https://api.onepay.la/v1/merchants \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-idempotency: <x-idempotency>' \
  --data '
{
  "external_id": "<string>",
  "name": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "address": "<string>",
  "document_type": "<string>",
  "document_number": "<string>",
  "mcc": "<string>",
  "activity": "<string>",
  "annual_volume": 123,
  "legal_representative": {
    "full_name": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "document_type": "<string>",
    "document_number": "<string>"
  },
  "fiscal_responsibilities": [
    {
      "code": "<string>",
      "apply": true
    }
  ],
  "retention_rules": [
    {
      "type": "<string>",
      "value": true
    }
  ]
}
'

​
Headers

​
x-idempotency
string
required
Token único para garantizar la idempotencia de la petición

​
Body

​
external_id
string
Identificador único del sub comercio, en tu sistema.
​
name
string
required
Nombre del sub comercio, este es el nombre comercial que aparecera en los extractos bancarios.
​
email
string
required
Correo electrónico del sub comercio, de contacto.
​
phone
string
required
Número de teléfono del sub comercio, de contacto.
​
address
string
required
Dirección del sub comercio, de contacto.
​
document_type
string
required
Tipo de documento de identidad (CC, CE, NIT, PASSPORT).
​
document_number
string
required
Número de documento de identidad.
​
mcc
string
required
Código de actividad comercial (MCC).
​
activity
string
required
Actividad del sub comercio.
​
annual_volume
integer
required
Volumen anual del sub comercio.
​
legal_representative
object
required
Representante legal del sub comercio.
​
full_name
string
required
Nombre completo del representante legal.
​
email
string
required
Correo electrónico del representante legal.
​
phone
string
required
Número de teléfono del representante legal.
​
document_type
string
required
Tipo de documento de identidad (CC, CE, NIT, PASSPORT).
​
document_number
string
required
Número de documento de identidad.
​
fiscal_responsibilities
object[]
required
Responsabilidades fiscales del sub comercio.
​
code
string
required
Codigo de la responsabilidad fiscal.
​
apply
boolean
required
Indica si la responsabilidad fiscal se aplica.
​
retention_rules
object[]
required
Reglas de retención del sub comercio.
​
type
string
required
Tipo de retención.
​
value
boolean
required
Indica si la retención se aplica.