API de facturas
Para consultas contactate a pay@increase.app
Recurso para obtener las facturas generadas en Increase Pay o generar facturas nuevas para pagos unicos
Cómo probar
Recuerda usar la Base URL de staging para hacer pruebas:
https://gateway.staging.increase.app/pay/public/v1/
Crear una factura
POST
https://gateway.increase.app/pay/public/v1/invoices
Headers
Content-Type:application/json
Authorization: Bearer <access_token>
Parámetro | Tipo | Descripción |
---|---|---|
customer_id* | String | id del cliente asociado |
payment_method_id | String | Metodo de pago del cliente |
currency* | String | Moneda |
amount* | String | Monto total de la factura |
success_url | String | URl de exito (https://www.tuempresa.com/gracias) |
items* | String | Conceptos a facturar |
external_reference | String | Identificador de la factura en tu sistema |
Dentro de Items podrás enviar los siguientes campos
Parámetro | Tipo | Descripción |
---|---|---|
currency* | String | Moneda |
quantity* | Number | Cantidad |
description* | String | Producto o Servicio a Facturar |
unit_price* | String | Monto unitario |
amount* | String | Monto total del item (quantity x unit price) |
Los parámetros con * son obligatorios. En caso de enviar el payment_method_id en vacio la factura otorgará luego de crearse un "checkout_link" desde donde el usuario final podrá cargar el medio de pago.
Si la invoice fue creada con success_url
al momento del cliente realizar el pago será redirigido al sitio cargado. Enviaremos también los parametros customer_id
, invoice_id
y payment_method_id
Body
{
"customer_id": "e9af012e-23a6-4b96-9918-2307ffb3aaa6",
"amount": "600.0",
"external_reference": "ID de mi sitio",
"currency": "ARS",
"success_url": "https://increase.app/gracias",
"items": [
{
"currency": "ARS",
"quantity": 3,
"description": "Linea 1",
"unit_price": "50.0",
"amount": "150.0"
},
{
"currency": "ARS",
"description": "test",
"quantity": 1,
"unit_price": "450.0",
"amount": "450.0"
}
]
}
Response
{
"id": "2b4f5310-4be1-4e39-b596-de5676c41705",
"status": "open",
"amount": "100.0",
"external_reference": "ID de mi sitio",
"customer": {
"id": "00000000-0000-0000-0000-000000000001",
"external_id": null,
"email": "7brenton_keeling@farrell.name",
"language": "ES",
"timezone": "Buenos Aires",
"first_name": null,
"last_name": null,
"billing_info": {},
"created_at": "2020-03-27T17:23:10-03:00"
},
"payments": [
{
"id": "da23e4a3-90b1-4edb-83ed-fa7053bdb74f",
"status": "open",
"amount": "100.0",
"currency": "ARS",
"payment_method": {
"id": "00000000-0000-0000-0000-000000000001",
"external_id": null,
"data": {
"type": "cbu",
"country": "ARG",
"number": "19101134**4200"
},
"created_at": "2020-03-27T17:23:10-03:00"
},
"events": [],
"created_at": "2020-03-27T17:23:10-03:00",
"rejection_code": null,
"rejection_type": null,
"rejection_description": null,
"paid_at": null
}
],
"currency": "ARS",
"created_at": "2020-03-27T17:23:10-03:00",
"paid_at": null,
"checkout_link": "http://localhost:3000/checkout/bac25f0c-db78-4e38-a951-a255e6a2976a?customer_id=00000000-0000-0000-0000-000000000001&invoice_id=2b4f5310-4be1-4e39-b596-de5676c41705&hash_value=MG4wRVBML3dBeHlHdXBZOHlkTzErbWxKQkdJeWF5RUdvNkx5UWJlNEsvRHdJU0QvTjJzOU9sY1ZiSFN2L25jVWJKM200MGcrVUJqSWRxMUM4N0ZMbTBwdzFrQ3ZLWmdCeSsvUCs4ZFYzaVA4K2JUSDgwZ3o5dGU3NSs4eWJiSnJ1bXl6eEkvK3NNbmdSQT09LS15cXdqNUd5TWxYUWhRT3ZXLS1OZjFXeXRjYW5Rcm1USUJjbnpsdElRPT0=",
"success_url": "https://increase.app/gracias",
"items": [
{
"id": "438be5ee-33ee-44e1-ac39-f3c3874c108f",
"description": "test",
"quantity": 1,
"unit_price": "50.0",
"amount": "50.0",
"currency": "ARS",
"item_number": 0,
"invoiceable_id": null,
"invoiceable_type": null,
"product_name": null
},
{
"id": "35af8dbe-a5b5-42dd-a9f4-49161851a036",
"description": "maiores voluptas",
"quantity": 50,
"unit_price": "50.0",
"amount": "50.0",
"currency": "ARS",
"item_number": 0,
"invoiceable_id": null,
"invoiceable_type": null,
"product_name": null
}
]
}
Obtener todas las facturas
GET
https://gateway.increase.app/pay/public/v1/invoices
Headers
Content-Type:application/json
Authorization: Bearer <access_token>
Success response
{
"data": [
{
"id": "62a0ef32-91cf-400b-ba85-05fdae8ac0a1",
"status": "open",
"amount": "15.0",
"customer": {
"id": "e9af012e-23a6-4b96-9918-2307ffb3aaa6",
"email": "mailcliente@gmail.com",
"first_name": "Juan",
"last_name": "Perez"
},
"payments": [],
"subscriptions": [
{
"id": "a739c9c9-b0ff-4102-a6da-eded25cde828",
"plan": {
"id": "57b7a2bb-ce27-47fb-88c8-e856f27e30d7",
"name": "Test_Automatico_Plan"
},
"customer": {
"id": "e9af012e-23a6-4b96-9918-2307ffb3aaa6",
"email": "mailcliente@gmail.com",
"first_name": "Juan",
"last_name": "Perez"
},
"quantity": 1,
"amount": "15.0",
"net_amount": "15.0",
"currency": "ARS",
"status": "pending",
"canceled_at": null,
"paused_at": null,
"trial_period_end": "2020-03-03T16:18:39-03:00",
"next_billing_date": "2020-06-03T16:18:39-03:00",
"created_at": "2020-03-03T16:18:39-03:00",
"product": {
"id": "9c1e30d8-04c4-4fae-b486-0ddeda8dea30",
"name": "Test_Automatico"
},
"activate_at": null,
"cancel_at": null
}
],
"currency": "ARS",
"created_at": "2020-03-03T16:18:39-03:00",
"paid_at": null,
"checkout_link": "https://pay.increase.app/invoice/8898b790-b8f4-44d0-b2db-10c4a881da63?invoice_id=62a0ef32-91cf-400b-ba85-05fdae8ac0a1",
"success_url": "https://increase.app/gracias"
}
],
"current_page": 1,
"per_page": 20,
"total_pages": 7,
"total_elements": 124
}
Obtener una factura específica
GET
https://gateway.increase.app/pay/public/v1/invoices/<id>
Headers
Content-Type:application/json
Authorization: Bearer <access_token>
Success response
{
"id": "62a0ef32-91cf-400b-ba85-05fdae8ac0a1",
"status": "open",
"amount": "15.0",
"customer": {
"id": "e9af012e-23a6-4b96-9918-2307ffb3aaa6",
"external_id": null,
"email": "clienteprueba@ejemplo.com",
"language": "ES",
"timezone": "Buenos Aires",
"first_name": "Juan",
"last_name": "Perez",
"billing_info": {
"id": "9e8aea0b-87d2-453e-9eb6-b74960d5f35d",
"address_line_1": "Hidalgo 142",
"address_line_2": "",
"country": "ARG",
"city": "caba",
"state": "caba",
"zip_code": "1405",
"phone": "1551125155",
"tax_id": "203720423123"
},
"created_at": "2020-03-03T16:18:09-03:00"
},
"payments": [],
"subscriptions": [
{
"id": "a739c9c9-b0ff-4102-a6da-eded25cde828",
"plan": {
"id": "57b7a2bb-ce27-47fb-88c8-e856f27e30d7",
"name": "Test_Automatico_Plan"
},
"customer": {
"id": "e9af012e-23a6-4b96-9918-2307ffb3aaa6",
"email": "clienteprueba@ejemplo.com",
"first_name": "Juan",
"last_name": "Perez"
},
"quantity": 1,
"amount": "15.0",
"net_amount": "15.0",
"currency": "ARS",
"status": "pending",
"canceled_at": null,
"paused_at": null,
"trial_period_end": "2020-03-03T16:18:39-03:00",
"next_billing_date": "2020-06-03T16:18:39-03:00",
"created_at": "2020-03-03T16:18:39-03:00",
"payment_method": null,
"product": {
"id": "9c1e30d8-04c4-4fae-b486-0ddeda8dea30",
"name": "Test_Automatico"
},
"external_id": null,
"activate_at": null,
"cancel_at": null,
"checkout_link": "https://pay.staging.increase.app/checkout/8898b790-b8f4-44d0-b2db-10c4a881da63?subscription_id=a739c9c9-b0ff-4102-a6da-eded25cde828&hash_value=RnhNZHIzTlhaa0dJRGlmNkNRc3Vrd2FTdUFRTVRxSTVjRG9Ic1dTcmkrVnE2SXd5eDZza3lSVlgyTEtuRXZmcGExL0VzR01aUmdDVHE4eWhvVEU9LS03cDRBQUxaUXg4SlRXQnBtLS1NQmhRVXY3MkFkMlBqTHFad29GRDNBPT0="
}
],
"currency": "ARS",
"created_at": "2020-03-03T16:18:39-03:00",
"paid_at": null,
"checkout_link": "https://pay.staging.increase.app/invoice/8898b790-b8f4-44d0-b2db-10c4a881da63?invoice_id=62a0ef32-91cf-400b-ba85-05fdae8ac0a1&hash_value=b0RtMzczNklaYkhUcmlzeTNjOXZ0N0RmUnFabzVVc0s4WVdadDRIbjF4eEhPeWduaVRRQnIyc1BrZkZEZTdsZyt3NlVRTHE0Z0ZuSi0tZEFTUmsyaURCeWJkaWdINS0tWFNTU2RITTF2TFBNMDBoVGQ4N1Vvdz09",
"items": [
{
"id": "37b200de-3f71-41d7-abcf-5846a7e674ca",
"description": "Test_Automatico_Plan",
"quantity": 1,
"unit_price": "15.0",
"amount": "15.0",
"currency": "ARS",
"item_number": 0,
"invoiceable_id": "a739c9c9-b0ff-4102-a6da-eded25cde828",
"invoiceable_type": "Subscription",
"product_name": "Test_Automatico"
}
]
}
Obtener todas las facturas de un cliente específico
GET
https://gateway.increase.app/pay/public/v1/invoices?page=1&per_page=12?customer_id=<customer_id>
Headers
Content-Type:application/json
Authorization: Bearer <access_token>