Page History

...

Status

colour	Blue
title	POST

https://api.paypertic.com/v2/suscripciones

Parámetros del mensaje

Advanced Tables - Table Plus

heading	0
multiple	false
enableHeadingAttributes	false
enableSorting	false
enableHighlighting	false

Nombre

Tipo

Formato

Descripción

type

String

Tipo de suscripción. Valores:

subscription: Genera cobranzas de acuerdo al importe, concepto y periodicidad otorgadas.
adhesionadhesión: Las cobranzas son informadas por la entidad.
plan: Genera cobranzas como subscription, pero el pagador no puede cancelarlas.

Status

colour	Red
title	REQUERIDO

collector_id

String

Identificador del comercio.

Status

colour	Red
title	REQUERIDO

return_url

String

URL a la cual redirige el formulario de ingreso de datos una vez realizada la suscripción.

back_url

String

URL a la cual redirige el formulario de pago al realizar clic en el boton botón regresar.

notification_url

String

URL a la cual se estaran estarán enviado las notificaciones del pago.

detail

Object

Detalle de la suscripción.

También se puede enviar suscripciones a diferentes comercios los cuales deben declarar y registrar la relación de los mismos.

Status

colour	Red
title	REQUERIDO

external_reference

String

Referencia o id externo a la plataforma para uso del comercio.

concept_id

String

Identificador del concepto de la suscripción definido por el comercio.

concept_description

String

Descripcion Descripción del concepto de la suscripción definido por el comercio.

amount

Float

##.00

Monto de la suscripción.

collector_id

String

Identificador del comercio. Se puede enviar un identificador distinto al del comercio que esta realizando la transacción, los cuales deben declarar y registrar la relación de los mismos.

rate

Float

##.00

Tasa de interes interés anual a cobrar pasada la fecha de vencimiento.

charge_delay

Float

##.00

Monto fijo a cobrar pasada la fecha de vencimiento.

currency_id

String

Identificador de moneda. Valores:

USD: Dolar estadounidense
EUR: Euro
ARS: Pesos Argentinos
BRL: Reales BrazilerosBrasileros
COP: Pesos Colombianos

Status

colour	Red
title	REQUERIDO

payment_method

Object

authorization_transaction_id

String

ID de transacción de autorización.

media_payment_id

Integer

Identificador del medio de pago.

number

String

Número del medio de pago.

promotion_id

String

Identificador de la promoción.

expiration_year

Integer

Año de expiración de la tarjeta

expiration_month

Integer

Mes de expiración de la tarjeta

securotysecurity_code

String

Codigo Código de seguridad de la tarjeta.

holder

Object

Titular del medio de pago.

name

String

Nombre.

identification

Object

Documento del titular.

type

String

Tipo de documento.

number

String

Número.

country

String

ISO 3166-1 alfa-3

País de expedicionexpedición.

payer

Object

Datos del pagador.

Status

colour	Red
title	REQUERIDO

id

String

Identificador del pagador. Se obtiene del servicio de CUSTOMERS

external_reference

String

Referencia del pagador en la entidad.

name

String

Nombre.

email

String

Email.

identification

Object

Documento del pagador.

type

String

Tipo de documento.

number

String

Número.

country

String

ISO 3166-1 alfa-3

País de expedicionexpedición.

phones

Array (Object)

Lisado Listado de números telefónicos.

description

String

Descipción Descripción del número.

country_code

Integer

Código de país.

area_code

Integer

Código de área.

number

Integer

Números telefónico.

extension

Integer

Extensión.

due_day

IntegerDias

yyyy-MM-dd'T'HH:mm:ssZ

RFC 822 time zone

Días desde el comienzo del período hasta la fecha de vencimiento

(

. Es decir, fecha aproximada en la que se realizara el cobro.

Por defecto 1/3 del tiempo que dura el período
Las fechas a utilizar van desde el 1 al 20 (inclusive) de cada mes.

last_due_day

IntegerDias

yyyy-MM-dd'T'HH:mm:ssZ

RFC 822 time zone

Días desde el comienzo del período hasta el último vencimiento (Por defecto al finalizar el período de la suscripción).

start_date

Integer

yyyy-MM-dd'T'HH:mm:ssZ

RFC 822 time zone

Fecha de inicio de la suscripción. (siempre y cuando la suscripción se encuentre activa)

start_in_current_period

Boolean

True / False

True: La suscripción activa comienza a generar cobros en el periodo actual.

False: La suscripción comienza en el siguiente periodo.

metadata

Object

Objeto JSON para adjuntar datos a la suscripción.

recurrence

String

Tipos de recurrencia (por defecto monthly):

daily: Diaramente.
weekly: Semanalmente.
biweeklyfortnight: Quincenalmente.
monthly: Mensual.
bymonthlybimonthly: bimestral.
quarterly: trimestral.
fourmonth: cuatrimestral.
biannual: semestral.
annual: anual.

periods

Integer

Cantidad de periodos de duración de la suscripción (por defecto 0, infinitos periodos).

start_date

Date

yyyy-MM-dd'T'HH:mm:ssZ

RFC 822 time zone

Fecha a partir de la cual comenzará la suscripción (debe ser mayor a la fecha actual).

Code Block

language	js
firstline	0
title	Suscripción con campos mínimos.
linenumbers	true
collapse	true

{
    "type": "subscription",
    "collector_id": "999",
    "currency_id": "ARS",
    "recurrence":"monthly",
    "detail":
		{
            "external_reference": "344999",
            "concept_id":"4499",
            "concept_description":"Concepto Prueba",
            "amount":44 999.499
        },
    "payer": {
    	"id":"999",
        "name": "GustavoPagador SimonePrueba",
        "email": "kevinf@payperticprueba@paypertic.com",
        "identification": {
            "type":"ARG_DNI",
            "number":"1658070799999999",
            "country":"ARG"
        }
    }
}

Error posibles

4000 Invalid request.
40 4022 Invalid subscription id.
40 4021 Invalid subscription type.
40 4023 Invalid subscription status
4004 Invalid collector.
4005 Invalid payment method.
4006 Invalid currency.
4007 Invalid url return.
4008 Invalid back url.
4009 Invalid url notification.
4010 Invalid media payment.
4011 Invalid expiration year.
4012 Invalid expiration month.
4013 Invalid identification type.
4014 Invalid identification type.
40 4024 Invalid due day.40
4016 Invalid last due daydate.
4017 Invalid security code.
4018 Invalid transaction amount.
4019 Invalid action.
4020 Invalid authorization transaction id.
40 4112 Details of subscription can't be null.
4031 External reference can not be null.
4032 Concept id can not be null.
4033 Concept description can not be null.
4034 Amount can not be null.
4036 Card holder can not be null.
4037 Card holder name can not be null.
4038 Card holder identification can not be null.
4039 Identification number can not be null.
4050 Parameter not allowed.
4051 Unrelated collector.
4053 Rate out of range.
4054 Charge delay out of range.
4057 Payment number not allowed.
4058 Security code not allowed.
4059 Holder not allowed.
4060 Parameter not found.
4100 Access denied.
5001 Internal service error.

...

Page tree

Versions Compared

Old Version 7

New Version Current

Key

Parámetros del mensaje

Error posibles