Post receiver

Warning: This feature is only available to customers who have contracted it independently. To use it, please contact us at soporte@khipu.com

Create a new collection account associated with an integrator.

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

First name of the administrator of the collection account to be created.

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

Last name of the administrator of the collection account to be created.

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

Email of the administrator of the collection account to be created.

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

ISO 3166-1 two-character alphanumeric code of the country of the collection account to be created.

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

Tax identifier of the merchant associated with the collection account to be created.

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

Tax category or tax item of the merchant associated with the collection account to be created.

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

Tax name of the merchant associated with the collection account to be created.

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

Telephone of the merchant associated with the collection account to be created.

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

Address of the merchant of the collection account to be created.

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

Second line of the address of the merchant of the collection account to be created.

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

Third line of the address of the merchant of the collection account to be created.

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

Name of the merchant's contact.

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

Position of the merchant contact.

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

Email address of the merchant's contact.

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

Merchant's contact phone number.

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

Bank identifier.

Example: "SDdGj"
bank_account_type
string <= 255 characters

Account type. It is required if the alternative trusted integrator model is used.

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

Personal identifier of the owner of the bank account.

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

Bank account name.

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

Bank account number.

Example: "00347909823"
notify_url
string <= 1024 characters

Default URL for the webservice where the payment will be notified.

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

URL for the webservice where the accountability will be notified.

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

Successful operation. Returns a JSON object with the identifier and secret of the new collection account.

Response Schema: application/json
receiver_id
required
string

Unique identifier of the collection account.

Example: "934568"
secret
required
string

Secret key to the collection account, used to sign all requests.

Example: "b2025dc47a29a04592fa3c1191110370db0e208c"
400

Bad request

401

Unauthorized - Invalid or missing credentials

403

Forbidden

404

Not found - Resource not available

500

Internal server error

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"
}