Pago

Se identifica como pago, a una transacción realizada por el usuario dentro de una sesión de pago.

Reembolsos

El endpoint de reembolsos permite revertir una transacción aprobada. Ver más en Reembolsos

POST/api/reverse

Reembolsar pago

Permite reembolsar un pago aprobado con el código de referencia interna internalReference.

Solicitud

  • Name
    auth
    Type
    Authentication
    is Required
    REQUIRED
    Description

    La autenticación del sitio. Ver más en Autenticación

    • Name
      login
      Type
      string
      is optional
      Description

      Identificador del sitio.

      Longitud mínima:1
    • Name
      tranKey
      Type
      string
      is optional
      Description

      Credencial tranKey generado.
      Ver más en Autenticación

      Longitud mínima:1
    • Name
      nonce
      Type
      string
      is optional
      Description

      Valor aleatorio para cada solicitud codificado en Base64.

      Longitud mínima:1
    • Name
      seed
      Type
      string
      is optional
      Description

      Fecha actual, la cual se genera en formato ISO 8601.

      Longitud mínima:1
  • Name
    internalReference
    Type
    integer
    is Required
    REQUIRED
    Description

    Referencia interna única de la transacción

    Ejemplo:543423
  • Name
    amount
    Type
    Amount
    is optional
    Description

    Información del monto a cobrar. Esta propiedad se envía cuando se desea realizar un reembolso con un valor menor al monto total de la transacción.

    • Name
      currency
      Type
      string
      is optional
      Description

      Código alfabético de la moneda a usar (ISO 4217 alpha code)
      EJ: USD

      Ejemplo:COP
    • Name
      total
      Type
      number
      is optional
      Description

      Valor total en la moneda base indicada
      EJ: 1000 equivalen a Mil dolares

      Ejemplo:2000
    • Name
      taxes
      Type
      array[Taxes]
      is optional
      Description

      Estructura para definir impuestos en el proceso de pago.

      • Name
        kind
        Type
        string
        is optional
        Description

        Identificador del tipo de impuesto

        Uno de: valueAddedTax exciseDuty ice airportTax stateTax reducedStateTax municipalTax.

        Valores permitidos:valueAddedTaxexciseDutyiceairportTaxstateTaxreducedStateTaxmunicipalTax
        Ejemplo:valueAddedTax
      • Name
        amount
        Type
        number
        is optional
        Description

        Monto total del impuesto
        EJ: 200

      • Name
        base
        Type
        number
        is optional
        Description

        Monto base sobre el cual se calcula el impuesto
        EJ: 1000

    • Name
      details
      Type
      array[Details]
      is optional
      Description

      Estructura para definir detalles adicionales del monto en el proceso de pago.

      • Name
        kind
        Type
        string
        is optional
        Description

        Identificador del tipo de detalle. Uno de: discount additional vatDevolutionBase shipping handlingFee insurance giftWrap subtotal fee tip airline interests

        Valores permitidos:discountadditionalvatDevolutionBaseshippinghandlingFeeinsurancegiftWrapsubtotalfeetipairlineinterests
        Ejemplo:discount
      • Name
        amount
        Type
        number
        is optional
        Description

        Monto total del detalle

        EJ: 200

Solicitud

POST
/api/reverse
curl -X "POST" https://checkout-test.placetopay.com/api/session/000000 \
-H "Content-Type: application/json" \
-d '{
    "auth": {
        "login": "c51ce410c124a10e0db5e4b97fc2af39",
        "tranKey": "VQOcRcVH2DfL6Y4B4SaK6yhoH/VOUveZ3xT16OQnvxE=",
        "nonce": "NjE0OWVkODgwYjNhNw==",
        "seed": "2021-09-21T09:34:48-05:00"
    },
    "internalReference": 1
}'

Respuesta

OK

  • Name
    status
    Type
    Status
    is optional
    Description

    Estructura que contiene la información de la respuesta sobre una solicitud o pago, e informa el estado actual de la misma.

    • Name
      status
      Type
      string
      is optional
      Description

      Estado de una petición o pago

      Valores permitidos:APPROVEDPENDINGREJECTEDAPPROVED_PARTIALPARTIAL_EXPIREDFAILED
      Ejemplo:APPROVED
      Longitud mínima:1
    • Name
      reason
      Type
      string|number|null
      is optional
      Description

      Código del motivo proporcionado.

      Ejemplo:00
    • Name
      message
      Type
      string|null
      is optional
      Description

      Descripción del código de razón.

      Ejemplo:La petición ha sido aprobada exitosamente
      Longitud mínima:1
    • Name
      date
      Type
      string
      is optional
      Description

      Fecha y hora en que se genera el estado de pago.

      Ejemplo:2022-07-27T14:51:27-05:00
      Formato:date-time
      Longitud mínima:1
  • Name
    payment
    Type
    PaymentResponse
    is optional
    Description
    • Name
      status
      Type
      Status
      is optional
      Description

      Estructura que contiene la información de la respuesta sobre una solicitud o pago, e informa el estado actual de la misma.

      • Name
        status
        Type
        string
        is optional
        Description

        Estado de una petición o pago

        Valores permitidos:APPROVEDPENDINGREJECTEDAPPROVED_PARTIALPARTIAL_EXPIREDFAILED
        Ejemplo:APPROVED
        Longitud mínima:1
      • Name
        reason
        Type
        string|number|null
        is optional
        Description

        Código del motivo proporcionado.

        Ejemplo:00
      • Name
        message
        Type
        string|null
        is optional
        Description

        Descripción del código de razón.

        Ejemplo:La petición ha sido aprobada exitosamente
        Longitud mínima:1
      • Name
        date
        Type
        string
        is optional
        Description

        Fecha y hora en que se genera el estado de pago.

        Ejemplo:2022-07-27T14:51:27-05:00
        Formato:date-time
        Longitud mínima:1
    • Name
      internalReference
      Type
      string
      is optional
      Description
    • Name
      paymentMethod
      Type
      string
      is optional
      Description
    • Name
      paymentMethodName
      Type
      string
      is optional
      Description
    • Name
      issuerName
      Type
      string
      is optional
      Description
    • Name
      amount
      Type
      AmountConversion
      is optional
      Description

      Estructura para definir el factor de conversión y los valores.

      • Name
        from
        Type
        AmountBase
        is optional
        Description

        Estructura que representa una cantidad que define la moneda y el total.

        • Name
          currency
          Type
          string
          is optional
          Description

          Moneda acorde al ISO 4217 (alphabetic code).

          Ejemplo:COP
        • Name
          total
          Type
          number|string
          is optional
          Description

          Valor total.

          Ejemplo:10000
      • Name
        to
        Type
        AmountBase
        is optional
        Description

        Estructura que representa una cantidad que define la moneda y el total.

        • Name
          currency
          Type
          string
          is optional
          Description

          Moneda acorde al ISO 4217 (alphabetic code).

          Ejemplo:COP
        • Name
          total
          Type
          number|string
          is optional
          Description

          Valor total.

          Ejemplo:10000
      • Name
        factor
        Type
        number|string
        is optional
        Description

        Factor de conversión

        Ejemplo:1
    • Name
      authorization
      Type
      string
      is optional
      Description
    • Name
      reference
      Type
      string
      is optional
      Description
    • Name
      franchise
      Type
      string
      is optional
      Description
    • Name
      refunded
      Type
      boolean
      is optional
      Description
    • Name
      processorFields
      Type
      PaymentResponse
      is optional
      Description

      Campos adicionales que pueden variar en el tiempo según la información disponible para el medio de pago. Ver más en Datos de procesamiento

      • Name
        keyword
        Type
        string
        is optional
        Description
      • Name
        value
        Type
        string|object|integer|array
        is optional
        Description
      • Name
        displayOn
        Type
        string
        is optional
        Description
    • Name
      receipt
      Type
      string
      is optional
      Description

Respuesta

{
    "status": {
        "status": "APPROVED",
        "reason": "00",
        "message": "Aprobada",
        "date": "2021-12-07T16:01:19-05:00"
    },
    "payment": {
        "status": {
        "status": "APPROVED",
        "reason": "00",
        "message": "Aprobada",
        "date": "2021-12-07T16:01:18-05:00"
        },
        "internalReference": 1,
        "paymentMethod": "visa",
        "paymentMethodName": "Visa",
        "issuerName": "JPMORGAN CHASE BANK, N.A.",
        "amount": {
        "from": {
            "currency": "USD",
            "total": 100
        },
        "to": {
            "currency": "USD",
            "total": 100
        },
        "factor": 1
        },
        "authorization": "123456",
        "reference": "12345",
        "receipt": "230955511860",
        "franchise": "PS_VS",
        "refunded": false,
        "processorFields": [
        {
            "keyword": "merchantCode",
            "value": "1465675",
            "displayOn": "none"
        },
        {
            "keyword": "terminalNumber",
            "value": "00990099",
            "displayOn": "none"
        },
        {
            "keyword": "credit",
            "value": {
            "code": "1",
            "type": "00",
            "groupCode": "C",
            "installments": 1
            },
            "displayOn": "none"
        },
        {
            "keyword": "totalAmount",
            "value": 52,
            "displayOn": "none"
        },
        {
            "keyword": "interestAmount",
            "value": 0,
            "displayOn": "none"
        },
        {
            "keyword": "installmentAmount",
            "value": 0,
            "displayOn": "none"
        },
        {
            "keyword": "iceAmount",
            "value": 0,
            "displayOn": "none"
        },
        {
            "keyword": "bin",
            "value": "411111",
            "displayOn": "none"
        },
        {
            "keyword": "expiration",
            "value": "1223",
            "displayOn": "none"
        },
        {
            "keyword": "lastDigits",
            "value": "1111",
            "displayOn": "none"
        },
        {
            "keyword": "id",
            "value": "a10fe0690cfe557283310ba90746e159",
            "displayOn": "none"
        },
        {
            "keyword": "b24",
            "value": "00",
            "displayOn": "none"
        }
        ]
    }
}
POST/api/transaction

Acciones de transacción

Permite realizar operaciones básicas de preauthorización como checkout, reauthorization, (No aplica para Puerto Rico) por otro lado también permite revertir un pago aprobado con el código de referencia interna reverse.

Solicitud

Estructura que permite realizar solicitudes de preauthorización como checkout, reauthorization y reverse

  • Name
    auth
    Type
    Authentication
    is Required
    REQUIRED
    Description

    La autenticación del sitio. Ver más en Autenticación

    • Name
      login
      Type
      string
      is optional
      Description

      Identificador del sitio.

      Longitud mínima:1
    • Name
      tranKey
      Type
      string
      is optional
      Description

      Credencial tranKey generado.
      Ver más en Autenticación

      Longitud mínima:1
    • Name
      nonce
      Type
      string
      is optional
      Description

      Valor aleatorio para cada solicitud codificado en Base64.

      Longitud mínima:1
    • Name
      seed
      Type
      string
      is optional
      Description

      Fecha actual, la cual se genera en formato ISO 8601.

      Longitud mínima:1
  • Name
    action
    Type
    string
    is Required
    REQUIRED
    Description

    Tipo de operación a realizar sobre la transacción

    reverse para reembolsar una transacción.
    reauthorization para modificar una transacción de checkin.
    checkout para cerrar y cobrar una transacción de checkin.

    Valores permitidos:checkoutreauthorizationreverse
    Ejemplo:checkout
  • Name
    internalReference
    Type
    integer
    is Required
    REQUIRED
    Description

    Referencia interna única de la transacción

    Ejemplo:543423
  • Name
    amount
    Type
    Amount
    is optional
    Description

    Información del monto a cobrar

    • Name
      currency
      Type
      string
      is optional
      Description

      Código alfabético de la moneda a usar (ISO 4217 alpha code)
      EJ: USD

      Ejemplo:COP
    • Name
      total
      Type
      number
      is optional
      Description

      Valor total en la moneda base indicada
      EJ: 1000 equivalen a Mil dolares

      Ejemplo:2000
    • Name
      taxes
      Type
      array[Taxes]
      is optional
      Description

      Estructura para definir impuestos en el proceso de pago.

      • Name
        kind
        Type
        string
        is optional
        Description

        Identificador del tipo de impuesto

        Uno de: valueAddedTax exciseDuty ice airportTax stateTax reducedStateTax municipalTax.

        Valores permitidos:valueAddedTaxexciseDutyiceairportTaxstateTaxreducedStateTaxmunicipalTax
        Ejemplo:valueAddedTax
      • Name
        amount
        Type
        number
        is optional
        Description

        Monto total del impuesto
        EJ: 200

      • Name
        base
        Type
        number
        is optional
        Description

        Monto base sobre el cual se calcula el impuesto
        EJ: 1000

    • Name
      details
      Type
      array[Details]
      is optional
      Description

      Estructura para definir detalles adicionales del monto en el proceso de pago.

      • Name
        kind
        Type
        string
        is optional
        Description

        Identificador del tipo de detalle. Uno de: discount additional vatDevolutionBase shipping handlingFee insurance giftWrap subtotal fee tip airline interests

        Valores permitidos:discountadditionalvatDevolutionBaseshippinghandlingFeeinsurancegiftWrapsubtotalfeetipairlineinterests
        Ejemplo:discount
      • Name
        amount
        Type
        number
        is optional
        Description

        Monto total del detalle

        EJ: 200

Solicitud

POST
/api/transaction
curl -X "POST" https://checkout-test.placetopay.com/api/transaction \
    -H "Content-Type: application/json" \
    -d "{
        "auth": {
            "login": "c51ce410c124a10e0db5e4b97fc2af39",
            "tranKey": "VQOcRcVH2DfL6Y4B4SaK6yhoH/VOUveZ3xT16OQnvxE=",
            "nonce": "NjE0OWVkODgwYjNhNw==",
            "seed": "2021-09-21T09:34:48-05:00"
        },
        "internalReference": 640,
        "amount": {
            "currency": "USD",
            "total": "500"
        },
        "action": "checkout"
    }"

Respuesta

OK

  • Name
    reference
    Type
    string
    is Required
    REQUIRED
    Description

    Referencia única del pago. compuesta por hasta 32 caracteres alfanuméricos y símbolos permitidos EJ: PAYMENT_0001_ABC, Venta_1234-ABCD#2024/03/15$500, Ord: 1001/2023

    Ejemplo:PAYMENT_0001_ABC
  • Name
    description
    Type
    string
    is Required
    REQUIRED
    Description

    Descripción del proceso a realizar, permitiendo hasta 250 caracteres alfanuméricos, acentuados y símbolos comunes.

    Ejemplo:Cita con el Dr. Pérez a las 10:00 am. 5/12/2024, por $100.00
  • Name
    amount
    Type
    Amount
    is Required
    REQUIRED
    Description

    Información del monto a cobrar

    • Name
      currency
      Type
      string
      is optional
      Description

      Código alfabético de la moneda a usar (ISO 4217 alpha code)
      EJ: USD

      Ejemplo:COP
    • Name
      total
      Type
      number
      is optional
      Description

      Valor total en la moneda base indicada
      EJ: 1000 equivalen a Mil dolares

      Ejemplo:2000
    • Name
      taxes
      Type
      array[Taxes]
      is optional
      Description

      Estructura para definir impuestos en el proceso de pago.

      • Name
        kind
        Type
        string
        is optional
        Description

        Identificador del tipo de impuesto

        Uno de: valueAddedTax exciseDuty ice airportTax stateTax reducedStateTax municipalTax.

        Valores permitidos:valueAddedTaxexciseDutyiceairportTaxstateTaxreducedStateTaxmunicipalTax
        Ejemplo:valueAddedTax
      • Name
        amount
        Type
        number
        is optional
        Description

        Monto total del impuesto
        EJ: 200

      • Name
        base
        Type
        number
        is optional
        Description

        Monto base sobre el cual se calcula el impuesto
        EJ: 1000

    • Name
      details
      Type
      array[Details]
      is optional
      Description

      Estructura para definir detalles adicionales del monto en el proceso de pago.

      • Name
        kind
        Type
        string
        is optional
        Description

        Identificador del tipo de detalle. Uno de: discount additional vatDevolutionBase shipping handlingFee insurance giftWrap subtotal fee tip airline interests

        Valores permitidos:discountadditionalvatDevolutionBaseshippinghandlingFeeinsurancegiftWrapsubtotalfeetipairlineinterests
        Ejemplo:discount
      • Name
        amount
        Type
        number
        is optional
        Description

        Monto total del detalle

        EJ: 200

  • Name
    allowPartial
    Type
    boolean
    is optional
    Description

    Define si el monto a ser cobrado puede ser pagado en varias transacciones. Cuando es true el usuario podrá completar el pago en varias transacciones.

    Valor por defecto:false
  • Name
    shipping
    Type
    Person
    is optional
    Description

    Estructura para relacionar información de envío.

    • Name
      document
      Type
      string
      is optional
      Description

      Documento de identidad

      Ejemplo:1122334455
      Longitud mínima:1
    • Name
      documentType
      Type
      string
      is optional
      Description

      Identificador del tipo de documento. Ver opciones en Tipos de documento

      EJ: CC para "Cédula de Ciudadanía" en Colombia.

      Ejemplo:CC
      Longitud mínima:1
    • Name
      name
      Type
      string
      is optional
      Description

      Nombre de la persona o empresa

      Ejemplo:Juan José
      Longitud mínima:1
    • Name
      surname
      Type
      string
      is optional
      Description

      Apellido de la persona. No aplica cuando el tipo de documento corresponde al de una empresa

      Ejemplo:Peréz Pinzon
      Longitud mínima:1
    • Name
      company
      Type
      string
      is optional
      Description

      Nombre de la compañia a la que pertenece la persona

      EJ: Placetopay

      Ejemplo:Evertec
    • Name
      email
      Type
      string
      is optional
      Description

      Correo eléctronico del usuario o empresa

      Ejemplo:[email protected]
      Longitud mínima:1
    • Name
      mobile
      Type
      string
      is optional
      Description

      Número de teléfono del usuario o empresa

      Ejemplo:+573214445566
      Longitud mínima:1
    • Name
      address
      Type
      object
      is optional
      Description

      Estructura para anexar información del domicilio o dirección

      • Name
        country
        Type
        string
        is optional
        Description

        El país en el que se encuentra la dirección. Código ISO 3166-1 alpha-2.

        Ejemplo:CO
        Longitud máxima:2
        Longitud mínima:2
      • Name
        state
        Type
        string
        is optional
        Description

        Departamento del domicilio

        Ejemplo:Antioquia
        Longitud mínima:1
      • Name
        city
        Type
        string
        is optional
        Description

        Ciudad del domicilio

        Ejemplo:Medellín
        Longitud mínima:1
      • Name
        postalCode
        Type
        string
        is optional
        Description

        Código postal del domicilio

        Ejemplo:050012
        Longitud mínima:1
      • Name
        street
        Type
        string
        is optional
        Description

        Dirección del domicilio

        Ejemplo:Calle 12 #33a-12, Apto 101
        Longitud mínima:1
      • Name
        phone
        Type
        string
        is optional
        Description

        Número telefónico del domicilio

        Ejemplo:+573214445566
        Longitud mínima:1
  • Name
    items
    Type
    array[Item]
    is optional
    Description

    Estructura para relacionar productos o artículos en el proceso.

    • Name
      sku
      Type
      string
      is optional
      Description

      Identificador SKU del artículo.
      EJ: SKU-12345

      Ejemplo:SKU-12345
    • Name
      name
      Type
      string
      is optional
      Description

      Nombre del artículo.
      EJ: Manta de lana

      Ejemplo:product_1
      Longitud mínima:1
    • Name
      category
      Type
      string
      is optional
      Description

      Categoría del artículo. Uno de: digital physical

      Valores permitidos:digitalphysical
      Ejemplo:physical
      Longitud mínima:1
    • Name
      qty
      Type
      number
      is optional
      Description

      Cantidad de artículos de este tipo.
      EJ: 23

      Ejemplo:1
    • Name
      price
      Type
      number
      is optional
      Description

      Costo total del artículo.
      EJ: 1400

      Ejemplo:1400
    • Name
      tax
      Type
      number
      is optional
      Description

      Monto en impuestos del artículo.
      EJ: 100

  • Name
    fields
    Type
    array[NameValuePair]
    is optional
    Description

    Estructura para relacionar información adicional en el proceso. Ver más en Campos Adicionales

    • Name
      keyword
      Type
      string
      is optional
      Description

      Identificador o índice del dato a anexar.
      EJ: cmsInvoiceId

      Ejemplo:1111
      Longitud mínima:1
    • Name
      value
      Type
      string|object|array|number|boolean
      is optional
      Description

      Valor del dato a anexar.
      EJ: ID_2233

      Ejemplo:lastDigits
      Longitud mínima:1
    • Name
      displayOn
      Type
      string
      is optional
      Description

      Indica en qué condiciones se muestra el dato anexo. Ver más en Campos Adicionales

      Uno de: none, payment, receipt, both, approved.

      Ejemplo:none
      Longitud mínima:1
  • Name
    recurring
    Type
    object
    is optional
    Description

    Estructura para indicar la frecuencia de un cobro recurrente.

    • Name
      periodicity
      Type
      string
      is optional
      Description

      Periodicidad del cobro
      D Día, M Mes, Y Año

      Valores permitidos:DMY
      Ejemplo:D
    • Name
      interval
      Type
      number
      is optional
      Description

      Intervalo asociado a la periodicidad
      EJ: 15 para días.

      Ejemplo:1
      Longitud máxima:127
      Longitud mínima:1
    • Name
      nextPayment
      Type
      string
      is optional
      Description

      Fecha del próximo pago
      EJ: 2019-08-24

      Ejemplo:2019-08-24
      Formato:date
    • Name
      maxPeriods
      Type
      number
      is optional
      Description

      Número máximo de periodos. Usar -1 en caso de que no haya límite
      EJ: 12 para máximo 12 cobros

      Ejemplo:1
      Longitud máxima:32767
      Longitud mínima:-1
    • Name
      dueDate
      Type
      string
      is optional
      Description

      Fecha de vencimiento de la recurrencia
      EJ: 2019-09-24

      Ejemplo:2019-09-24
      Formato:date
    • Name
      notificationUrl
      Type
      string
      is optional
      Description

      URL en el que el servicio notificará cada vez que se haga un cobro
      EJ: https://merchant.com/notification

      Ejemplo:https://checkout.placetopay.com
  • Name
    subscribe
    Type
    boolean
    is optional
    Description

    Cuando se envía true, se genera una sesión de pago con suscripción.

    En el proceso de pago, el usuario puede elegir si quiere o no guardar su medio de pago para que sea usado en futuros cobros.

    Valor por defecto:false
  • Name
    dispersion
    Type
    array[DispersionDetail]
    is optional
    Description

    Cuando se define, se genera una sesión de pago con dispersión. El pago generado puede ser dividido en diferentes destinos según las condiciones dadas.

    • Name
      amount
      Type
      Amount
      is optional
      Description

      Monto a "dispersar" en este destino.

      • Name
        currency
        Type
        string
        is optional
        Description

        Código alfabético de la moneda a usar (ISO 4217 alpha code)
        EJ: USD

        Ejemplo:COP
      • Name
        total
        Type
        number
        is optional
        Description

        Valor total en la moneda base indicada
        EJ: 1000 equivalen a Mil dolares

        Ejemplo:2000
      • Name
        taxes
        Type
        array[Taxes]
        is optional
        Description

        Estructura para definir impuestos en el proceso de pago.

        • Name
          kind
          Type
          string
          is optional
          Description

          Identificador del tipo de impuesto

          Uno de: valueAddedTax exciseDuty ice airportTax stateTax reducedStateTax municipalTax.

          Valores permitidos:valueAddedTaxexciseDutyiceairportTaxstateTaxreducedStateTaxmunicipalTax
          Ejemplo:valueAddedTax
        • Name
          amount
          Type
          number
          is optional
          Description

          Monto total del impuesto
          EJ: 200

        • Name
          base
          Type
          number
          is optional
          Description

          Monto base sobre el cual se calcula el impuesto
          EJ: 1000

      • Name
        details
        Type
        array[Details]
        is optional
        Description

        Estructura para definir detalles adicionales del monto en el proceso de pago.

        • Name
          kind
          Type
          string
          is optional
          Description

          Identificador del tipo de detalle. Uno de: discount additional vatDevolutionBase shipping handlingFee insurance giftWrap subtotal fee tip airline interests

          Valores permitidos:discountadditionalvatDevolutionBaseshippinghandlingFeeinsurancegiftWrapsubtotalfeetipairlineinterests
          Ejemplo:discount
        • Name
          amount
          Type
          number
          is optional
          Description

          Monto total del detalle

          EJ: 200

    • Name
      agreement
      Type
      string|number
      is optional
      Description

      Id del destino de este monto. Puede ser el id de un sitio.

      EJ: 122

    • Name
      agreementType
      Type
      string
      is optional
      Description

      Tipo de destino de este monto.
      MERCHANT para sitios, AIRLINE para aerolineas.

      Valores permitidos:MERCHANTAIRLINE
      Ejemplo:MERCHANT
  • Name
    modifiers
    Type
    array[Modifiers]
    is optional
    Description

    Estructura para definir modificadores en el cobro.

    Aplica para leyes de impuestos en paises especificos.

    • Name
      type
      Type
      string
      is optional
      Description

      Identificador del tipo de modificador.
      Sólo FEDERAL_GOVERMENT es soportado actualmente.

      Valores permitidos:FEDERAL_GOVERNMENT
      Ejemplo:FEDERAL_GOVERNMENT
    • Name
      code
      Type
      number
      is optional
      Description

      Código del modificador.

      Para FEDERAL_GOVERMENT representa el número de ley para descuento.
      17934 Servicios Gastronómicos
      18083 IMESI Brasil - Argentina
      19210 Inclusión Financiera
      18910 Asignaciones Familiares
      18999 Reintegro Inmobiliarias

      Valores permitidos:1793418083192101891018999
      Ejemplo:17934
    • Name
      additional
      Type
      object
      is optional
      Description

      Estructura para anexar información al modificador

      • Name
        invoice
        Type
        string
        is optional
        Description

        Requerido cuando modifiers.[n].type es FEDERAL_GOVERMENT. Indica el número de factura.

        Ejemplo:123456789
        Longitud máxima:9
  • Name
    processorFields
    Type
    array[NameValuePair]
    is optional
    Description

    Estructura que puede variar en el tiempo según la información disponible para el medio de pago. Ver más en Datos de procesamiento

    • Name
      keyword
      Type
      string
      is optional
      Description

      Identificador o índice del dato a anexar.
      EJ: cmsInvoiceId

      Ejemplo:1111
      Longitud mínima:1
    • Name
      value
      Type
      string|object|array|number|boolean
      is optional
      Description

      Valor del dato a anexar.
      EJ: ID_2233

      Ejemplo:lastDigits
      Longitud mínima:1
    • Name
      displayOn
      Type
      string
      is optional
      Description

      Indica en qué condiciones se muestra el dato anexo. Ver más en Campos Adicionales

      Uno de: none, payment, receipt, both, approved.

      Ejemplo:none
      Longitud mínima:1

Respuesta

{
    "reference": "12345",
    "description": "Prueba de pago",
    "amount": {
        "currency": "COP",
        "total": 2000,
        "taxes": [
        {
            "kind": "valueAddedTax",
            "amount": 1000,
            "base": 0
        }
        ],
        "details": [
        {
            "kind": "discount",
            "amount": 1000
        }
        ]
    },
    "allowPartial": false,
    "shipping": {
        "document": "1122334455",
        "documentType": "CC",
        "name": "John",
        "surname": "Doe",
        "company": "Evertec",
        "email": "[email protected]",
        "mobile": "+5731111111111",
        "address": {
            "street": "Calle falsa 123",
            "city": "Medellín",
            "state": "Poblado",
            "postalCode": "55555",
            "country": "CO",
            "phone": "+573111111111"
        }
    },
    "items": [
        {
        "sku": "12345",
        "name": "product_1",
        "category": "physical",
        "qty": "1",
        "price": 1000,
        "tax": 0
        }
    ],
    "fields": [
        {
        "keyword": "_test_field_value_",
        "value": "_test_field_",
        "displayOn": "approved"
        }
    ],
    "recurring": {
        "periodicity": "D",
        "interval": "1",
        "nextPayment": "2019-08-24",
        "maxPeriods": 1,
        "dueDate ": "2019-09-24",
        "notificationUrl ": "https://checkout.placetopay.com"
    },
    "subscribe": false,
    "dispersion": [
        {
        "agreement": "1299",
        "agreementType": "MERCHANT",
        "amount": {
            "currency": "USD",
            "total": 200
        }
        }
    ],
    "modifiers": [
        {
        "type": "FEDERAL_GOVERNMENT",
        "code": 17934,
        "additional": {
            "invoice": "123345"
        }
        }
    ]
}