Post receiver

Advertencia: Esta función sólo está disponible para los clientes que la hayan contratado de forma independiente. Para utilizarla, póngase en contacto con nosotros en soporte@khipu.com

Crear una nueva cuenta de cobro asociada a un integrador. Necesita datos de la cuenta de usuario asociada, datos de facturación y datos de contacto.

SecurityApi-Key
Request
Request Body schema: application/json
admin_first_name
required
string <= 255 characters

Nombre de pila del administrador de la cuenta de cobro a crear.

Example: "Nombre"
admin_last_name
required
string <= 255 characters

Apellido del administrador de la cuenta de cobro a crear.

Example: "Apellido"
admin_email
required
string <email> <= 255 characters

Correo electrónico del administrador de la cuenta de cobro a crear.

Example: "admin@email.com"
country_code
required
string <= 2 characters

Código alfanumérico de dos caracteres ISO 3166-1 del país de la cuenta de cobro a crear.

Example: "CL"
business_identifier
required
string [ 8 .. 255 ] characters

Identificador tributario del cobrador asociado a la cuenta de cobro a crear.

Example: "99.999.999-9"
business_category
required
string <= 255 characters

Categoría tributaria o rubro tributario del cobrador asociado a la cuenta de cobro a crear.

Example: "VENTA AL POR MAYOR DE FRUTAS Y VERDURAS"
business_name
required
string <= 255 characters

Nombre tributario del cobrador asociado a la cuenta de cobro a crear.

Example: "Nombre Tributario"
business_phone
required
string [ 5 .. 20 ] characters

Teléfono del cobrador asociado a la cuenta de cobro a crear.

Example: "+56988887777"
business_address_line_1
required
string [ 4 .. 300 ] characters

Dirección del cobrador de la cuenta de cobro a crear.

Example: "Calle principal 1111"
business_address_line_2
required
string [ 4 .. 300 ] characters

Segunda línea de la dirección del cobrador de la cuenta de cobro a crear.

Example: "Oficina 3-A"
business_address_line_3
required
string [ 4 .. 300 ] characters

Tercera línea de la dirección del cobrador de la cuenta de cobro a crear.

Example: "Santiago"
contact_full_name
required
string <= 255 characters

Nombre del contacto del cobrador.

Example: "Nombre Contacto"
contact_job_title
required
string <= 255 characters

Cargo del contacto del cobrador.

Example: "Tesorero"
contact_email
required
string <email> <= 255 characters

Correo electrónico del contacto del cobrador.

Example: "contacto@email.com"
contact_phone
required
string [ 5 .. 20 ] characters

Teléfono del contacto del cobrador.

Example: "+56955553333"
bank_account_bank_id
string <= 5 characters

Identificador del banco.

Example: "SDdGj"
bank_account_type
string <= 255 characters

Tipo de cuenta. Es obligatorio si se utiliza el modelo alternativo de integrador de confianza.

Example: "Cuenta Corriente"
bank_account_identifier
string <= 50 characters

Identificador personal del dueño de la cuenta de banco.

Example: "11.333.555-7"
bank_account_name
string <= 255 characters

Nombre de la cuenta de banco.

Example: "Alias Cuenta"
bank_account_number
string <= 255 characters

Número de la cuenta en el banco.

Example: "00347909823"
notify_url
string <= 1024 characters

URL por omisión para el webservice donde se notificará el pago.

Example: "http://micomercio.com/account/notify_url"
rendition_url
string <= 1024 characters

URL para el webservice donde se notificará la rendición.

Example: "http://micomercio.com/account/rendition_url"
Responses
200

Operación exitosa. Devuelve un objeto JSON con el identificador y secreto de la nueva cuenta de cobro.

Response Schema: application/json
receiver_id
required
string

Identificador único de la cuenta de cobro.

Example: "934568"
secret
required
string

Llave secreta de la cuenta de cobro, se usa para firmar todas las peticiones.

Example: "b2025dc47a29a04592fa3c1191110370db0e208c"
400

Bad request - Solicitud mal formada

401

Unauthorized - Credenciales no válidas o faltantes

403

Forbidden - Cliente no tiene privilegios

404

Not found - Recurso no disponible

500

Internal server error - Servidor no pudo completar la solicitud

post/v3/receivers
Request samples
application/json
{
  • "admin_first_name": "Nombre",
  • "admin_last_name": "Apellido",
  • "admin_email": "admin@email.com",
  • "country_code": "CL",
  • "business_identifier": "99.999.999-9",
  • "business_category": "VENTA AL POR MAYOR DE FRUTAS Y VERDURAS",
  • "business_name": "Nombre Tributario",
  • "business_phone": "+56988887777",
  • "business_address_line_1": "Calle principal 1111",
  • "business_address_line_2": "Oficina 3-A",
  • "business_address_line_3": "Santiago",
  • "contact_full_name": "Nombre Contacto",
  • "contact_job_title": "Tesorero",
  • "contact_email": "contacto@email.com",
  • "contact_phone": "+56955553333"
}
Response samples
application/json
{
  • "receiver_id": "934568",
  • "secret": "b2025dc47a29a04592fa3c1191110370db0e208c"
}