Welcome
Guides
Wingback.js
Advanced
curl --request GET \
--url http://127.0.0.1:8080/v1/c/entitlement/{customer_id}/billing \
--header 'wb-key: <api-key>'{
"contract": {
"contract_id": "Cust_c40bea18-c0c9-44b1-bd0c-43f5283e1670",
"status": "active"
},
"customer": {
"status": "active"
},
"payment": {
"payment_provider": "stripe",
"unpaid_invoices_info": [
{
"currency": "usd",
"payment_threshold": "<string>",
"total_unpaid": "<string>",
"unpaid_invoices": [
{
"amount": "<string>",
"due_date": "2023-11-07T05:31:56Z",
"id": "Cust_c40bea18-c0c9-44b1-bd0c-43f5283e1670",
"status": "pending_validation"
}
]
}
],
"wallet_balance": "<string>",
"wallet_balances": [
{
"balance": "<string>",
"currency": "usd",
"customer_id": "Cust_c40bea18-c0c9-44b1-bd0c-43f5283e1670",
"id": "Cust_c40bea18-c0c9-44b1-bd0c-43f5283e1670",
"wb_customer_id": "Cust_c40bea18-c0c9-44b1-bd0c-43f5283e1670"
}
],
"next_payment_due": "2023-11-07T05:31:56Z"
}
}Get Billing Entitlements
Retrieve current plan, payment cycle, payment status and account status for a customer
curl --request GET \
--url http://127.0.0.1:8080/v1/c/entitlement/{customer_id}/billing \
--header 'wb-key: <api-key>'{
"contract": {
"contract_id": "Cust_c40bea18-c0c9-44b1-bd0c-43f5283e1670",
"status": "active"
},
"customer": {
"status": "active"
},
"payment": {
"payment_provider": "stripe",
"unpaid_invoices_info": [
{
"currency": "usd",
"payment_threshold": "<string>",
"total_unpaid": "<string>",
"unpaid_invoices": [
{
"amount": "<string>",
"due_date": "2023-11-07T05:31:56Z",
"id": "Cust_c40bea18-c0c9-44b1-bd0c-43f5283e1670",
"status": "pending_validation"
}
]
}
],
"wallet_balance": "<string>",
"wallet_balances": [
{
"balance": "<string>",
"currency": "usd",
"customer_id": "Cust_c40bea18-c0c9-44b1-bd0c-43f5283e1670",
"id": "Cust_c40bea18-c0c9-44b1-bd0c-43f5283e1670",
"wb_customer_id": "Cust_c40bea18-c0c9-44b1-bd0c-43f5283e1670"
}
],
"next_payment_due": "2023-11-07T05:31:56Z"
}
}Authorizations
Path Parameters
Id of the customer
Query Parameters
Response
Billing information for current cycle
Data to show the billing status of the customer (last payment date, wallet balance, etc)
Describes Contract object for Entitlement endpoint
Show child attributes
Show child attributes
Unique identifier of an object. Consists of object class prefix and a UUID
"Cust_c40bea18-c0c9-44b1-bd0c-43f5283e1670"
Status of the contract:
- Active - Contract is active
- Pending - Contract is not active
- Scheduled - Contract is scheduled to activate in the future
- Canceled - Contract has been canceled
- Moved - User upgraded from this contract to a different one
- NotReady - Contract was created, but billing engine has not completed contract setup
active, pending, scheduled, canceled, moved, not_ready Describes the status of the customer for Entitlement response
Show child attributes
Show child attributes
Status of the Customer
- Active - customer is active
- Inactive - Customer account was deactivated
- Temporary - Customer was created, but registration process was not completed
active, inactive, temporary Information about payment status displayed in the Entitlement API
Show child attributes
Show child attributes
The payment providers known by the backend.
Those variants MUST be kept identical to the variants of the payment_provider enum of the postgres database
authorize, self_handled, stripe "stripe"
List of unpaid invoices
Show child attributes
Show child attributes
A supported currency
The format for parsing and reading is the lowercased ISO 4217 currency code (e.g. "usd")
usd, eur, gbp, brl, ars The configured stored maximum allowed unpaid amount. This limit is not enforced on Wingback side, but may be used as indicator by the user of the Entitlement API
Total sum of unpaid charges
List of unpaid invoices
Show child attributes
Show child attributes
Total amount of the invoice
Due date of the invoice
Unique identifier of an object. Consists of object class prefix and a UUID
"Cust_c40bea18-c0c9-44b1-bd0c-43f5283e1670"
Status of the invoice:
- PendingValidation - Invoice awaits manual review
- ReadyForPayment - invoice can be paid
- Paid - invoice was paid
pending_validation, ready_for_payment, paid Status of the customer's wallet with the same currency as the current contract
List of all customer wallets and their balances
Show child attributes
Show child attributes
Wallet balance
A supported currency
The format for parsing and reading is the lowercased ISO 4217 currency code (e.g. "usd")
usd, eur, gbp, brl, ars Unique identifier of an object. Consists of object class prefix and a UUID
"Cust_c40bea18-c0c9-44b1-bd0c-43f5283e1670"
Unique identifier of an object. Consists of object class prefix and a UUID
"Cust_c40bea18-c0c9-44b1-bd0c-43f5283e1670"
Unique identifier of an object. Consists of object class prefix and a UUID
"Cust_c40bea18-c0c9-44b1-bd0c-43f5283e1670"
Date when the nearest invoice will be due