Mall

El producto ha sido diseñado especialmente para aquellas empresas integradoras de distintas marcas con diferentes líneas de negocio las cuales pueden agruparse manteniendo su diversidad en un mismo espacio virtual o mall.

Ofreciendo la posibilidad de agrupar el pago de las compras realizadas en múltiples tiendas virtuales en una sola transacción.

Ver diagrama

URL base: https://app.payku.cl/ (Default server) · https://des.payku.cl/ (Sandbox server)

Crear transacción Mall

POST/api/mall

Esto método permite la inserción de datos de una transacción.

Cuerpo de la solicitud

Parámetro	Tipo	Descripción
emailrequerido	string <email>	Email del cliente. máximo 50 caracteres Ejemplo: [email protected]
paymentrequerido	integer	Identificador del medio de pago. Si se envía el identificador, el pagador será redireccionado directamente al medio de pago que se indique. 1 Webpay 4 Etpay (Transferencia) 6 Pago46 9 Mach 19 Fintoc (Transferencia) 23 Tenpo 26 Floid (Transferencia) 99 Todos máximo 2 caracteres Ejemplo: 1
merchantrequerido	array of arrays	Arreglo que contiene los clientes, cada cliente es un arreglo que contiene su token público o id de afiliación de marketplace, valor de transacción, descripción, id del evento en especifico que si no posee debe pasar null y numero de orden individual. máximo 200 caracteres Ejemplo: [["81b6179e4feeef2b50af71d660f830de",30000,"item1",null,"4545"],["81b6179e4feeef2b50af71d66f7830de",25000,"item2",null,"4546"],["81b6179e4fffff2b50af71d66f7830de",15000,"item3",null,"4547"]]
orderrequerido	integer	Orden del comercio, este debe ser único. máximo 40 caracteres Ejemplo: 123
urlreturnrequerido	string <url>	url de retorno del comercio donde payku redirigirá al pagador. máximo 200 caracteres Ejemplo: https://youwebsite.com/urlreturn
urlnotify	string <url>	url callback del comercio donde payku notificará el pago. máximo 600 caracteres Ejemplo: https://youwebsite.com/urlnotify

CURL

curl -X POST \
https://BASE_URL/api/mall \
-H 'Accept: application/json, text/plain, */*' \
-H 'Sign: SHA256-REQUEST-PATH-VALUE-TOKEN-PRIVADO  \
-H 'Authorization: Bearer TOKEN_PUBLICO  \
-H 'Content-Type: application/json' \
-H 'Host: BASE_URL' \
-d {
    "email": "[email protected]",
    "payment": 1,
    "merchant": [
      ["81b6179e4feeef2b50af71d660f830de", "30000", "item1", null, "4545"],
      ["bcf6c06c523d9394be41bc0174c43d1476f274abb342955aac93cc8014737b3b","25000","item2", null, "4546"],
      ["TOKEN-PUBLICO","15000","item3", null, "4547"]
    ],
    "order": 123,
    "urlreturn": "https://youwebsite.com/urlreturn",
    "urlnotify": "https://youwebsite.com/urlnotify"
  }'

PHP

$client = new \GuzzleHttp\Client();
  $body = $client->request('POST', 'https://BASE_URL/api/mall', [
    'json' => [
      'email'         => '[email protected]',
      'payment'       => 1,
      'merchant'      => [
        ['81b6179e4feeef2b50af71d660f830de', '30000', 'item1', null, '4545'],
        ['bcf6c06c523d9394be41bc0174c43d1476f274abb342955aac93cc8014737b3b','25000','item2', null, '4546'],
        ['TOKEN-PUBLICO','15000','item3', null, '4547']
      ],
      'order'         => 123,
      'urlreturn'     => 'https://youwebsite.com/urlreturn',
      'urlnotify'     => 'https://youwebsite.com/urlnotify'
      ],
    'headers' => [
      'Sign' => 'f96ddc14a73a4dd6e009db2514108a3f44832795cd5ac50e6a80fd0b0ae92112',
      'Authorization' => 'Bearer TOKEN-PUBLICO'
    ]
  ])->getBody();
$response = json_decode($body);

JS

const request = async (data) => {
  const response = await fetch('https://BASE_URL/api/mall', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Sign': 'f96ddc14a73a4dd6e009db2514108a3f44832795cd5ac50e6a80fd0b0ae92112',
      'Authorization': 'Bearer TOKEN-PUBLICO'
    },
    body: JSON.stringify(data)
  });
  const result = await response.json();
  console.log(result)
}
let data = {
  email: "[email protected]",
  payment: 1,
  merchant: [
    ["81b6179e4feeef2b50af71d660f830de", "30000", "item1", null, "4545"],
    ["bcf6c06c523d9394be41bc0174c43d1476f274abb342955aac93cc8014737b3b","25000","item2", null, "4546"],
    ["TOKEN-PUBLICO","15000","item3", null, "4547"]
  ],
  order: 123,
  urlreturn: "https://youwebsite.com/urlreturn",
  urlnotify: "https://youwebsite.com/urlnotify"
};
request(data);

Respuestas

200

200

{
  "status": "success",
  "id": "malld200058ab44739ddee2adcd2f5",
  "individual_orders": [
    {
      "merchant": "81b6179e4feeef2b50af71d660f830de",
      "amount": 30000,
      "subject": "item1",
      "event": null,
      "identificador": "9917068816213146",
      "individual_order": "9654"
    },
    {
      "merchant": "81b6179e4feeef2b50af71d66f7830de",
      "amount": 25000,
      "subject": "item2",
      "event": null,
      "identificador": "9917068816213146",
      "individual_order": "9654"
    },
    {
      "merchant": "81b6179e4fffff2b50af71d66f7830de",
      "amount": 15000,
      "subject": "item3",
      "event": null,
      "identificador": "9917068816213146",
      "individual_order": "9654"
    }
  ],
  "url": "https://BASE_URL/gateway/mall/malld200058ab44739ddee2adcd2f5"
}

Campos de la respuesta

Parámetro	Tipo	Descripción
status	string	Estatus de transacción.Los posibles estados que puede obtener son los siguientes: pending success rejected refunded partial refunded Ejemplo: success
id	string	Identificador de la transacción creado por payku. Ejemplo: malld200058ab44739ddee2adcd2f5
individual_orders	array of objects	Arreglo que contiene información de los beneficiarios. Ejemplo: [{"merchant":"81b6179e4feeef2b50af71d660f830de","amount":30000,"subject":"item1","event":null,"identificador":"9917068816213146","individual_order":"9654"},{"merchant":"81b6179e4feeef2b50af71d66f7830de","amount":25000,"subject":"item2","event":null,"identificador":"9917068816213146","individual_order":"9654"},{"merchant":"81b6179e4fffff2b50af71d66f7830de","amount":15000,"subject":"item3","event":null,"identificador":"9917068816213146","individual_order":"9654"}]
merchant	string	Nombre del beneficiario.
amount	string	Monto del producto o servicio.
detail	string	Descripción de la transacción.
event	string	ID del evento, si no poseé evento debe pasar null.
identificador	string	Identificador de la transacción. Ejemplo: 9917068816213146
individual_order	string	Identificador individual de la transacción. Ejemplo: 4546
url	string	URL a redireccionar al usuario. Ejemplo: https://BASE_URL/gateway/mall/malld200058ab44739ddee2adcd2f5

400

400

Error en la solicitud.

{
  "status": "failed",
  "type": "Unprocessable Entity",
  "message_error": "subject:invalid,amount:is empty,email:is empty,order:invalid"
}

Campos de la respuesta

Parámetro	Tipo	Descripción
status	string	Estatus de la solicitud. Ejemplo: failed
type	string	Tipo de error ocurrido. Ejemplo: Unprocessable Entity
message_error	string	Mensaje de error Ejemplo: subject:invalid,amount:is empty,email:is empty,order:invalid

401

401

Token Publico incorrecto.

{
  "type": "Unauthorized",
  "message_error": {
    "error": "waiting token public"
  }
}

Campos de la respuesta

Parámetro	Tipo	Descripción
type	string	Tipo de error ocurrido. Ejemplo: Unauthorized
message_error	object
error	string	Mensaje de error Ejemplo: waiting token public

Obtener transacción Mall

GET/api/mall/{identificadorTrasaccion}

Este método permite obtener la información de un pago realizado en payku

Parámetros de ruta

Parámetro	Tipo	Descripción
idrequerido	string	id de la transacción a solicitar máximo 30 caracteres

CURL

curl -X GET \
https://BASE-URL/api/mall/ID-IDENTIFICADOR  \
-H 'Accept: application/json, text/plain, */*' \
-H 'Authorization: Bearer TOKEN-PUBLICO' \
-H 'Content-Type: application/json' \
-H 'Host: BASE-URL ' \

PHP

$client = new \GuzzleHttp\Client();
  $body = $client->request('GET', 'https://BASE_URL/api/mall/malld200058ab44739ddee2adcd2f5', [
    'headers' => [
      'Sign' => 'f96ddc14a73a4dd6e009db2514108a3f44832795cd5ac50e6a80fd0b0ae92112',
      'Authorization' => 'Bearer TOKEN-PUBLICO'
    ]
  ])->getBody();
$response = json_decode($body);

JS

const request = async () => {
  const response = await fetch('https://BASE_URL/api/mall/malld200058ab44739ddee2adcd2f5', {
    method: 'GET',
    headers: {
      'Content-Type': 'application/json',
      'Sign' => 'f96ddc14a73a4dd6e009db2514108a3f44832795cd5ac50e6a80fd0b0ae92112',
      'Authorization' => 'Bearer TOKEN-PUBLICO'
    },
  });
  const result = await response.json();
  console.log(result)
}
request();

Respuestas

200

200

{
  "status": "success",
  "id": "malld200058ab44739ddee2adcd2f5",
  "created_at": "2023-10-16 11:23:19",
  "amount": "30000",
  "payment": {
    "media": "Webpay",
    "verification_key": "d60aaa661ea74d824373806c8aa38137",
    "authorization_code": "441864",
    "last_4_digits": "5135",
    "card_type": "",
    "currency": "CLP"
  },
  "merchant": [
    {
      "name": "John Doe",
      "amount": 30000,
      "subject": "item1"
    },
    {
      "name": "Jane Doe",
      "amount": 25000,
      "subject": "item2"
    },
    {
      "name": "Enteprise",
      "amount": 15000,
      "subject": "item3"
    }
  ]
}

Campos de la respuesta

Parámetro	Tipo	Descripción
status	string	Estatus de transacción.Los posibles estados que puede obtener son los siguientes: pending success rejected refunded partial refunded Ejemplo: success
id	string	Identificador de la transacción creado por payku. Ejemplo: malld200058ab44739ddee2adcd2f5
created_at	string	Fecha de registro. Ejemplo: 2023-10-16 11:23:19
amount	string	Monto. Ejemplo: 30000
payment	object
media	string	Medio de pago, utilizado por el usuario. Ejemplo: Webpay
verification_key	string	Código de verificación creado por payku. Ejemplo: d60aaa661ea74d824373806c8aa38137
authorization_code	string	Código de autorización. Ejemplo: 441864
last_4_digits	string	Últimos 4 dígitos de la tarjeta afiliada. Ejemplo: 5135
card_type	string	Tipo de tarjeta. Ejemplo:
currency	string	Moneda. Ejemplo: CLP
merchant	array of objects	Arreglo que contiene información de los beneficiarios. Ejemplo: [{"name":"John Doe","amount":30000,"subject":"item1"},{"name":"Jane Doe","amount":25000,"subject":"item2"},{"name":"Enteprise","amount":15000,"subject":"item3"}]
name	string	Nombre del beneficiario.
amount	string	Monto del producto o servicio.
subject	string	Descripción del producto o servicio.

400

400

Error en la solicitud.

{
  "status": "failed",
  "type": "Unprocessable Entity",
  "message_error": "subject:invalid,amount:is empty,email:is empty,order:invalid"
}

Campos de la respuesta

Parámetro	Tipo	Descripción
status	string	Estatus de la solicitud. Ejemplo: failed
type	string	Tipo de error ocurrido. Ejemplo: Unprocessable Entity
message_error	string	Mensaje de error Ejemplo: subject:invalid,amount:is empty,email:is empty,order:invalid

401

401

Token Publico incorrecto.

{
  "type": "Unauthorized",
  "message_error": {
    "error": "waiting token public"
  }
}

Campos de la respuesta

Parámetro	Tipo	Descripción
type	string	Tipo de error ocurrido. Ejemplo: Unauthorized
message_error	object
error	string	Mensaje de error Ejemplo: waiting token public

404

404

Identificador no existe.

{
  "status": "failed",
  "type": "Not Found",
  "id": "is not valid"
}

Campos de la respuesta

Parámetro	Tipo	Descripción
status	string	Estatus de la solicitud. Ejemplo: failed
type	string	Tipo de error ocurrido. Ejemplo: Not Found
id	string	Información de id Ejemplo: is not valid