Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
334 changes: 267 additions & 67 deletions openapi/api.yaml

Large diffs are not rendered by default.

103 changes: 88 additions & 15 deletions src/main/java/com/recurly/v3/Client.java
Original file line number Diff line number Diff line change
Expand Up @@ -296,6 +296,23 @@ public Transaction verifyBillingInfo(String accountId, BillingInfoVerify body) {
return this.makeRequest("POST", path, body, returnType);
}

/**
* Verify an account's credit card billing cvv
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/verify_billing_info_cvv">verify_billing_info_cvv api documentation</a>
* @param accountId Account ID or code. For ID no prefix is used e.g. `e28zov4fw0v2`. For code use prefix `code-`, e.g. `code-bob`.
* @param body The body of the request.
* @return Transaction information from verify.
*/
public Transaction verifyBillingInfoCvv(String accountId, BillingInfoVerifyCVV body) {
final String url = "/accounts/{account_id}/billing_info/verify_cvv";
final HashMap<String, String> urlParams = new HashMap<String, String>();
urlParams.put("account_id", accountId);
final String path = this.interpolatePath(url, urlParams);
Type returnType = Transaction.class;
return this.makeRequest("POST", path, body, returnType);
}

/**
* Get the list of billing information associated with an account
*
Expand Down Expand Up @@ -385,6 +402,62 @@ public void removeABillingInfo(String accountId, String billingInfoId) {
this.makeRequest("DELETE", path);
}

/**
* Verify a billing information's credit card
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/verify_billing_infos">verify_billing_infos api documentation</a>
* @param accountId Account ID or code. For ID no prefix is used e.g. `e28zov4fw0v2`. For code use prefix `code-`, e.g. `code-bob`.
* @param billingInfoId Billing Info ID. Can ONLY be used for sites utilizing the Wallet feature.
* @return Transaction information from verify.
*/
public Transaction verifyBillingInfos(String accountId, String billingInfoId) {
final String url = "/accounts/{account_id}/billing_infos/{billing_info_id}/verify";
final HashMap<String, String> urlParams = new HashMap<String, String>();
urlParams.put("account_id", accountId);
urlParams.put("billing_info_id", billingInfoId);
final String path = this.interpolatePath(url, urlParams);
Type returnType = Transaction.class;
return this.makeRequest("POST", path, returnType);
}

/**
* Verify a billing information's credit card
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/verify_billing_infos">verify_billing_infos api documentation</a>
* @param accountId Account ID or code. For ID no prefix is used e.g. `e28zov4fw0v2`. For code use prefix `code-`, e.g. `code-bob`.
* @param billingInfoId Billing Info ID. Can ONLY be used for sites utilizing the Wallet feature.
* @param body The body of the request.
* @return Transaction information from verify.
*/
public Transaction verifyBillingInfos(String accountId, String billingInfoId, BillingInfoVerify body) {
final String url = "/accounts/{account_id}/billing_infos/{billing_info_id}/verify";
final HashMap<String, String> urlParams = new HashMap<String, String>();
urlParams.put("account_id", accountId);
urlParams.put("billing_info_id", billingInfoId);
final String path = this.interpolatePath(url, urlParams);
Type returnType = Transaction.class;
return this.makeRequest("POST", path, body, returnType);
}

/**
* Verify a billing information's credit card cvv
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/verify_billing_infos_cvv">verify_billing_infos_cvv api documentation</a>
* @param accountId Account ID or code. For ID no prefix is used e.g. `e28zov4fw0v2`. For code use prefix `code-`, e.g. `code-bob`.
* @param billingInfoId Billing Info ID. Can ONLY be used for sites utilizing the Wallet feature.
* @param body The body of the request.
* @return Transaction information from verify.
*/
public Transaction verifyBillingInfosCvv(String accountId, String billingInfoId, BillingInfoVerifyCVV body) {
final String url = "/accounts/{account_id}/billing_infos/{billing_info_id}/verify_cvv";
final HashMap<String, String> urlParams = new HashMap<String, String>();
urlParams.put("account_id", accountId);
urlParams.put("billing_info_id", billingInfoId);
final String path = this.interpolatePath(url, urlParams);
Type returnType = Transaction.class;
return this.makeRequest("POST", path, body, returnType);
}

/**
* List the coupon redemptions for an account
*
Expand Down Expand Up @@ -1143,7 +1216,7 @@ public Pager<Invoice> listInvoices(QueryParams queryParams) {
* Fetch an invoice
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/get_invoice">get_invoice api documentation</a>
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`.
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
* @return An invoice.
*/
public Invoice getInvoice(String invoiceId) {
Expand All @@ -1159,7 +1232,7 @@ public Invoice getInvoice(String invoiceId) {
* Update an invoice
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/put_invoice">put_invoice api documentation</a>
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`.
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
* @param body The body of the request.
* @return An invoice.
*/
Expand All @@ -1176,7 +1249,7 @@ public Invoice putInvoice(String invoiceId, InvoiceUpdatable body) {
* Fetch an invoice as a PDF
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/get_invoice_pdf">get_invoice_pdf api documentation</a>
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`.
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
* @return An invoice as a PDF.
*/
public BinaryFile getInvoicePdf(String invoiceId) {
Expand All @@ -1192,7 +1265,7 @@ public BinaryFile getInvoicePdf(String invoiceId) {
* Apply available credit to a pending or past due charge invoice
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/apply_credit_balance">apply_credit_balance api documentation</a>
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`.
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
* @return The updated invoice.
*/
public Invoice applyCreditBalance(String invoiceId) {
Expand All @@ -1208,7 +1281,7 @@ public Invoice applyCreditBalance(String invoiceId) {
* Collect a pending or past due, automatic invoice
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/collect_invoice">collect_invoice api documentation</a>
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`.
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
* @return The updated invoice.
*/
public Invoice collectInvoice(String invoiceId) {
Expand All @@ -1224,7 +1297,7 @@ public Invoice collectInvoice(String invoiceId) {
* Collect a pending or past due, automatic invoice
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/collect_invoice">collect_invoice api documentation</a>
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`.
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
* @param body The body of the request.
* @return The updated invoice.
*/
Expand All @@ -1241,7 +1314,7 @@ public Invoice collectInvoice(String invoiceId, InvoiceCollect body) {
* Mark an open invoice as failed
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/fail_invoice">fail_invoice api documentation</a>
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`.
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
* @return The updated invoice.
*/
public Invoice failInvoice(String invoiceId) {
Expand All @@ -1257,7 +1330,7 @@ public Invoice failInvoice(String invoiceId) {
* Mark an open invoice as successful
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/mark_invoice_successful">mark_invoice_successful api documentation</a>
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`.
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
* @return The updated invoice.
*/
public Invoice markInvoiceSuccessful(String invoiceId) {
Expand All @@ -1273,7 +1346,7 @@ public Invoice markInvoiceSuccessful(String invoiceId) {
* Reopen a closed, manual invoice
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/reopen_invoice">reopen_invoice api documentation</a>
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`.
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
* @return The updated invoice.
*/
public Invoice reopenInvoice(String invoiceId) {
Expand All @@ -1289,7 +1362,7 @@ public Invoice reopenInvoice(String invoiceId) {
* Void a credit invoice.
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/void_invoice">void_invoice api documentation</a>
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`.
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
* @return The updated invoice.
*/
public Invoice voidInvoice(String invoiceId) {
Expand All @@ -1305,7 +1378,7 @@ public Invoice voidInvoice(String invoiceId) {
* Record an external payment for a manual invoices.
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/record_external_transaction">record_external_transaction api documentation</a>
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`.
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
* @param body The body of the request.
* @return The recorded transaction.
*/
Expand All @@ -1322,7 +1395,7 @@ public Transaction recordExternalTransaction(String invoiceId, ExternalTransacti
* List an invoice's line items
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/list_invoice_line_items">list_invoice_line_items api documentation</a>
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`.
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
* @param queryParams The {@link QueryParams} for this endpoint.
* @return A list of the invoice's line items.
*/
Expand All @@ -1341,7 +1414,7 @@ public Pager<LineItem> listInvoiceLineItems(String invoiceId, QueryParams queryP
* List the coupon redemptions applied to an invoice
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/list_invoice_coupon_redemptions">list_invoice_coupon_redemptions api documentation</a>
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`.
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
* @param queryParams The {@link QueryParams} for this endpoint.
* @return A list of the the coupon redemptions associated with the invoice.
*/
Expand All @@ -1360,7 +1433,7 @@ public Pager<CouponRedemption> listInvoiceCouponRedemptions(String invoiceId, Qu
* List an invoice's related credit or charge invoices
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/list_related_invoices">list_related_invoices api documentation</a>
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`.
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
* @return A list of the credit or charge invoices associated with the invoice.
*/
public Pager<Invoice> listRelatedInvoices(String invoiceId) {
Expand All @@ -1376,7 +1449,7 @@ public Pager<Invoice> listRelatedInvoices(String invoiceId) {
* Refund an invoice
*
* @see <a href="https://developers.recurly.com/api/v2019-10-10#operation/refund_invoice">refund_invoice api documentation</a>
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`.
* @param invoiceId Invoice ID or number. For ID no prefix is used e.g. `e28zov4fw0v2`. For number use prefix `number-`, e.g. `number-1000`. For number with prefix or country code, use `number-` and `prefix`, e.g. `number-TEST-FR1001`
* @param body The body of the request.
* @return Returns the new credit invoice.
*/
Expand Down
30 changes: 15 additions & 15 deletions src/main/java/com/recurly/v3/requests/AddOnCreate.java
Original file line number Diff line number Diff line change
Expand Up @@ -146,11 +146,11 @@ public class AddOnCreate extends Request {
private String revenueScheduleType;

/**
* Optional field used by Avalara, Vertex, and Recurly's EU VAT tax feature to determine taxation
* rules. If you have your own AvaTax or Vertex account configured, use their tax codes to assign
* specific tax rules. If you are using Recurly's EU VAT feature, you can use values of `unknown`,
* `physical`, or `digital`. If `item_code`/`item_id` is part of the request then `tax_code` must
* be absent.
* Optional field used by Avalara, Vertex, and Recurly's In-the-Box tax solution to determine
* taxation rules. You can pass in specific tax codes using any of these tax integrations. For
* Recurly's In-the-Box tax offering you can also choose to instead use simple values of
* `unknown`, `physical`, or `digital` tax codes. If `item_code`/`item_id` is part of the request
* then `tax_code` must be absent.
*/
@SerializedName("tax_code")
@Expose
Expand Down Expand Up @@ -465,22 +465,22 @@ public void setRevenueScheduleType(final String revenueScheduleType) {
}

/**
* Optional field used by Avalara, Vertex, and Recurly's EU VAT tax feature to determine taxation
* rules. If you have your own AvaTax or Vertex account configured, use their tax codes to assign
* specific tax rules. If you are using Recurly's EU VAT feature, you can use values of `unknown`,
* `physical`, or `digital`. If `item_code`/`item_id` is part of the request then `tax_code` must
* be absent.
* Optional field used by Avalara, Vertex, and Recurly's In-the-Box tax solution to determine
* taxation rules. You can pass in specific tax codes using any of these tax integrations. For
* Recurly's In-the-Box tax offering you can also choose to instead use simple values of
* `unknown`, `physical`, or `digital` tax codes. If `item_code`/`item_id` is part of the request
* then `tax_code` must be absent.
*/
public String getTaxCode() {
return this.taxCode;
}

/**
* @param taxCode Optional field used by Avalara, Vertex, and Recurly's EU VAT tax feature to
* determine taxation rules. If you have your own AvaTax or Vertex account configured, use
* their tax codes to assign specific tax rules. If you are using Recurly's EU VAT feature,
* you can use values of `unknown`, `physical`, or `digital`. If `item_code`/`item_id` is part
* of the request then `tax_code` must be absent.
* @param taxCode Optional field used by Avalara, Vertex, and Recurly's In-the-Box tax solution to
* determine taxation rules. You can pass in specific tax codes using any of these tax
* integrations. For Recurly's In-the-Box tax offering you can also choose to instead use
* simple values of `unknown`, `physical`, or `digital` tax codes. If `item_code`/`item_id` is
* part of the request then `tax_code` must be absent.
*/
public void setTaxCode(final String taxCode) {
this.taxCode = taxCode;
Expand Down
Loading
Loading