Pagarme API
This client library is a Ruby gem which can be compiled and used in your Ruby and Ruby on Rails project. This library requires a few gems from the RubyGems repository.
Open the command line interface or the terminal and navigate to the folder containing the source code.
Run gem build pagarme_core_api.gemspec
to build the gem.
Once built, the gem can be installed on the current work environment using gem install pagarme_core_api-5.7.5.gem
The following section explains how to use the PagarmeCoreApi Ruby Gem in a new Rails project using RubyMine™. The basic workflow presented here is also applicable if you prefer using a different editor or IDE.
1. Starting a new project
Close any existing projects in RubyMine™ by selecting File -> Close Project
. Next, click on Create New Project
to create a new project from scratch.
Next, provide TestApp
as the project name, choose Rails Application
as the project type, and click OK
.
In the next dialog make sure that correct Ruby SDK is being used (minimum 2.0.0) and click OK
.
This will create a new Rails Application project with an existing set of files and folder.
2. Add reference of the gem
In order to use the PagarmeCoreApi gem in the new project we must add a gem reference. Locate the Gemfile
in the Project Explorer window under the TestApp
project node. The file contains references to all gems being used in the project. Here, add the reference to the library gem by adding the following line: gem 'pagarme_core_api', '~> 5.7.5'
3. Adding a new Rails Controller
Once the TestApp
project is created, a folder named controllers
will be visible in the Project Explorer under the following path: TestApp > app > controllers
. Right click on this folder and select New -> Run Rails Generator...
.
Selecting the said option will popup a small window where the generator names are displayed. Here, select the controller
template.
Next, a popup window will ask you for a Controller name and included Actions. For controller name provide Hello
and include an action named Index
and click OK
.
A new controller class anmed HelloController
will be created in a file named hello_controller.rb
containing a method named Index
. In this method, add code for initialization and a sample for its usage.
You can test the generated SDK and the server with automatically generated test
cases as follows:
From terminal/cmd navigate to the root directory of the SDK.
Invoke: bundle exec rake
In order to setup authentication and initialization of the API client, you need the following information.
Parameter
Description
service_referer_name
TODO: add a description
basic_auth_user_name
The username to use with basic authentication
basic_auth_password
The password to use with basic authentication
API client can be initialized as following.
# Configuration parameters and credentials
service_referer_name = 'service_referer_name'
basic_auth_user_name = 'basic_auth_user_name' # The username to use with basic authentication
basic_auth_password = 'basic_auth_password' # The password to use with basic authentication
client = PagarmeCoreApi ::PagarmeCoreApiClient . new (
service_referer_name : service_referer_name ,
basic_auth_user_name : basic_auth_user_name ,
basic_auth_password : basic_auth_password
)
The added initlization code can be debugged by putting a breakpoint in the Index
method and running the project in debug mode by selecting Run -> Debug 'Development: TestApp'
.
SubscriptionsController
The singleton instance of the SubscriptionsController
class can be accessed from the API Client.
subscriptions_controller = client . subscriptions
update_subscription_card
Updates the credit card from a subscription
def update_subscription_card ( subscription_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription id
body
Required
Request for updating a card
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
body = UpdateSubscriptionCardRequest . new
idempotency_key = 'idempotency-key'
result = subscriptions_controller . update_subscription_card ( subscription_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_an_usage
Create Usage
def create_an_usage ( subscription_id ,
item_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription id
item_id
Required
Item id
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
item_id = 'item_id'
idempotency_key = 'idempotency-key'
result = subscriptions_controller . create_an_usage ( subscription_id , item_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_subscription_payment_method
Updates the payment method from a subscription
def update_subscription_payment_method ( subscription_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription id
body
Required
Request for updating the paymentmethod from a subscription
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
body = UpdateSubscriptionPaymentMethodRequest . new
idempotency_key = 'idempotency-key'
result = subscriptions_controller . update_subscription_payment_method ( subscription_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_subscription_item
Creates a new Subscription item
def create_subscription_item ( subscription_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription id
body
Required
Request for creating a subscription item
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
body = CreateSubscriptionItemRequest . new
idempotency_key = 'idempotency-key'
result = subscriptions_controller . create_subscription_item ( subscription_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_subscription_item
Get Subscription Item
def get_subscription_item ( subscription_id ,
item_id ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription Id
item_id
Required
Item id
subscription_id = 'subscription_id'
item_id = 'item_id'
result = subscriptions_controller . get_subscription_item ( subscription_id , item_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_subscription_affiliation_id
UpdateSubscriptionAffiliationId
def update_subscription_affiliation_id ( subscription_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
TODO: Add a parameter description
body
Required
Request for updating a subscription affiliation id
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
body = UpdateSubscriptionAffiliationIdRequest . new
idempotency_key = 'idempotency-key'
result = subscriptions_controller . update_subscription_affiliation_id ( subscription_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_increments
GetIncrements
def get_increments ( subscription_id ,
page = nil ,
size = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
The subscription id
page
Optional
Page number
size
Optional
Page size
subscription_id = 'subscription_id'
page = 120
size = 120
result = subscriptions_controller . get_increments ( subscription_id , page , size )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_subscription_due_days
Updates the boleto due days from a subscription
def update_subscription_due_days ( subscription_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription Id
body
Required
TODO: Add a parameter description
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
body = UpdateSubscriptionDueDaysRequest . new
idempotency_key = 'idempotency-key'
result = subscriptions_controller . update_subscription_due_days ( subscription_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_subscription_start_at
Updates the start at date from a subscription
def update_subscription_start_at ( subscription_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
The subscription id
body
Required
Request for updating the subscription start date
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
body = UpdateSubscriptionStartAtRequest . new
idempotency_key = 'idempotency-key'
result = subscriptions_controller . update_subscription_start_at ( subscription_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_subscription_cycle_by_id
GetSubscriptionCycleById
def get_subscription_cycle_by_id ( subscription_id ,
cycle_id ) ; end
Parameter
Tags
Description
subscription_id
Required
The subscription id
cycle_id
Required
TODO: Add a parameter description
subscription_id = 'subscription_id'
cycle_id = 'cycleId'
result = subscriptions_controller . get_subscription_cycle_by_id ( subscription_id , cycle_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
delete_discount
Deletes a discount
def delete_discount ( subscription_id ,
discount_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription id
discount_id
Required
Discount Id
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
discount_id = 'discount_id'
idempotency_key = 'idempotency-key'
result = subscriptions_controller . delete_discount ( subscription_id , discount_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_subscription_items
Get Subscription Items
def get_subscription_items ( subscription_id ,
page = nil ,
size = nil ,
name = nil ,
code = nil ,
status = nil ,
description = nil ,
created_since = nil ,
created_until = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
The subscription id
page
Optional
Page number
size
Optional
Page size
name
Optional
The item name
code
Optional
Identification code in the client system
status
Optional
The item statis
description
Optional
The item description
created_since
Optional
Filter for item's creation date start range
created_until
Optional
Filter for item's creation date end range
subscription_id = 'subscription_id'
page = 120
size = 120
name = 'name'
code = 'code'
status = 'status'
description = 'description'
created_since = 'created_since'
created_until = 'created_until'
result = subscriptions_controller . get_subscription_items ( subscription_id , page , size , name , code , status , description , created_since , created_until )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_subscription_item
Updates a subscription item
def update_subscription_item ( subscription_id ,
item_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription Id
item_id
Required
Item id
body
Required
Request for updating a subscription item
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
item_id = 'item_id'
body = UpdateSubscriptionItemRequest . new
idempotency_key = 'idempotency-key'
result = subscriptions_controller . update_subscription_item ( subscription_id , item_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_subscription
Creates a new subscription
def create_subscription ( body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
body
Required
Request for creating a subscription
idempotency_key
Optional
TODO: Add a parameter description
body = CreateSubscriptionRequest . new
idempotency_key = 'idempotency-key'
result = subscriptions_controller . create_subscription ( body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_discount_by_id
GetDiscountById
def get_discount_by_id ( subscription_id ,
discount_id ) ; end
Parameter
Tags
Description
subscription_id
Required
The subscription id
discount_id
Required
TODO: Add a parameter description
subscription_id = 'subscription_id'
discount_id = 'discountId'
result = subscriptions_controller . get_discount_by_id ( subscription_id , discount_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_subscription_billing_date
Updates the billing date from a subscription
def update_subscription_billing_date ( subscription_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
The subscription id
body
Required
Request for updating the subscription billing date
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
body = UpdateSubscriptionBillingDateRequest . new
idempotency_key = 'idempotency-key'
result = subscriptions_controller . update_subscription_billing_date ( subscription_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_latest_period_end_at
UpdateLatestPeriodEndAt
def update_latest_period_end_at ( subscription_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
TODO: Add a parameter description
body
Required
Request for updating the end date of the current signature cycle
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
body = UpdateCurrentCycleEndDateRequest . new
idempotency_key = 'idempotency-key'
result = subscriptions_controller . update_latest_period_end_at ( subscription_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_discount
Creates a discount
def create_discount ( subscription_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription id
body
Required
Request for creating a discount
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
body = CreateDiscountRequest . new
idempotency_key = 'idempotency-key'
result = subscriptions_controller . create_discount ( subscription_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
delete_usage
Deletes a usage
def delete_usage ( subscription_id ,
item_id ,
usage_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
The subscription id
item_id
Required
The subscription item id
usage_id
Required
The usage id
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
item_id = 'item_id'
usage_id = 'usage_id'
idempotency_key = 'idempotency-key'
result = subscriptions_controller . delete_usage ( subscription_id , item_id , usage_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_usages
Lists all usages from a subscription item
def get_usages ( subscription_id ,
item_id ,
page = nil ,
size = nil ,
code = nil ,
group = nil ,
used_since = nil ,
used_until = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
The subscription id
item_id
Required
The subscription item id
page
Optional
Page number
size
Optional
Page size
code
Optional
Identification code in the client system
group
Optional
Identification group in the client system
used_since
Optional
TODO: Add a parameter description
used_until
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
item_id = 'item_id'
page = 120
size = 120
code = 'code'
group = 'group'
used_since = DateTime . now
used_until = DateTime . now
result = subscriptions_controller . get_usages ( subscription_id , item_id , page , size , code , group , used_since , used_until )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_current_cycle_status
UpdateCurrentCycleStatus
def update_current_cycle_status ( subscription_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription Id
body
Required
Request for updating the end date of the subscription current status
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
body = UpdateCurrentCycleStatusRequest . new
idempotency_key = 'idempotency-key'
subscriptions_controller . update_current_cycle_status ( subscription_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
cancel_subscription
Cancels a subscription
def cancel_subscription ( subscription_id ,
idempotency_key = nil ,
body = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription id
idempotency_key
Optional
TODO: Add a parameter description
body
Optional
Request for cancelling a subscription
subscription_id = 'subscription_id'
idempotency_key = 'idempotency-key'
body = CreateCancelSubscriptionRequest . new
result = subscriptions_controller . cancel_subscription ( subscription_id , idempotency_key , body )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_increment
Creates a increment
def create_increment ( subscription_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription id
body
Required
Request for creating a increment
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
body = CreateIncrementRequest . new
idempotency_key = 'idempotency-key'
result = subscriptions_controller . create_increment ( subscription_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_subscription_metadata
Updates the metadata from a subscription
def update_subscription_metadata ( subscription_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
The subscription id
body
Required
Request for updating the subscrption metadata
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
body = UpdateMetadataRequest . new
idempotency_key = 'idempotency-key'
result = subscriptions_controller . update_subscription_metadata ( subscription_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_discounts
GetDiscounts
def get_discounts ( subscription_id ,
page ,
size ) ; end
Parameter
Tags
Description
subscription_id
Required
The subscription id
page
Required
Page number
size
Required
Page size
subscription_id = 'subscription_id'
page = 120
size = 120
result = subscriptions_controller . get_discounts ( subscription_id , page , size )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_subscription_minium_price
Atualização do valor mínimo da assinatura
def update_subscription_minium_price ( subscription_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription Id
body
Required
Request da requisição com o valor mínimo que será configurado
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
body = UpdateSubscriptionMinimumPriceRequest . new
idempotency_key = 'idempotency-key'
result = subscriptions_controller . update_subscription_minium_price ( subscription_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_split_subscription
UpdateSplitSubscription
def update_split_subscription ( id ,
body ) ; end
Parameter
Tags
Description
id
Required
Subscription's id
body
Required
TODO: Add a parameter description
id = 'id'
body = UpdateSubscriptionSplitRequest . new
result = subscriptions_controller . update_split_subscription ( id , body )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_subscriptions
Gets all subscriptions
def get_subscriptions ( page = nil ,
size = nil ,
code = nil ,
billing_type = nil ,
customer_id = nil ,
plan_id = nil ,
card_id = nil ,
status = nil ,
next_billing_since = nil ,
next_billing_until = nil ,
created_since = nil ,
created_until = nil ) ; end
Parameter
Tags
Description
page
Optional
Page number
size
Optional
Page size
code
Optional
Filter for subscription's code
billing_type
Optional
Filter for subscription's billing type
customer_id
Optional
Filter for subscription's customer id
plan_id
Optional
Filter for subscription's plan id
card_id
Optional
Filter for subscription's card id
status
Optional
Filter for subscription's status
next_billing_since
Optional
Filter for subscription's next billing date start range
next_billing_until
Optional
Filter for subscription's next billing date end range
created_since
Optional
Filter for subscription's creation date start range
created_until
Optional
Filter for subscriptions creation date end range
page = 120
size = 120
code = 'code'
billing_type = 'billing_type'
customer_id = 'customer_id'
plan_id = 'plan_id'
card_id = 'card_id'
status = 'status'
next_billing_since = DateTime . now
next_billing_until = DateTime . now
created_since = DateTime . now
created_until = DateTime . now
result = subscriptions_controller . get_subscriptions ( page , size , code , billing_type , customer_id , plan_id , card_id , status , next_billing_since , next_billing_until , created_since , created_until )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_subscription
Gets a subscription
def get_subscription ( subscription_id ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription id
subscription_id = 'subscription_id'
result = subscriptions_controller . get_subscription ( subscription_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
delete_increment
Deletes a increment
def delete_increment ( subscription_id ,
increment_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription id
increment_id
Required
Increment id
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
increment_id = 'increment_id'
idempotency_key = 'idempotency-key'
result = subscriptions_controller . delete_increment ( subscription_id , increment_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_increment_by_id
GetIncrementById
def get_increment_by_id ( subscription_id ,
increment_id ) ; end
Parameter
Tags
Description
subscription_id
Required
The subscription Id
increment_id
Required
The increment Id
subscription_id = 'subscription_id'
increment_id = 'increment_id'
result = subscriptions_controller . get_increment_by_id ( subscription_id , increment_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_subscription_cycles
GetSubscriptionCycles
def get_subscription_cycles ( subscription_id ,
page ,
size ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription Id
page
Required
Page number
size
Required
Page size
subscription_id = 'subscription_id'
page = 'page'
size = 'size'
result = subscriptions_controller . get_subscription_cycles ( subscription_id , page , size )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
renew_subscription
RenewSubscription
def renew_subscription ( subscription_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
TODO: Add a parameter description
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
idempotency_key = 'idempotency-key'
result = subscriptions_controller . renew_subscription ( subscription_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
delete_subscription_item
Deletes a subscription item
def delete_subscription_item ( subscription_id ,
subscription_item_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription id
subscription_item_id
Required
Subscription item id
idempotency_key
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
subscription_item_id = 'subscription_item_id'
idempotency_key = 'idempotency-key'
result = subscriptions_controller . delete_subscription_item ( subscription_id , subscription_item_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_usage_report
GetUsageReport
def get_usage_report ( subscription_id ,
period_id ) ; end
Parameter
Tags
Description
subscription_id
Required
The subscription Id
period_id
Required
The period Id
subscription_id = 'subscription_id'
period_id = 'period_id'
result = subscriptions_controller . get_usage_report ( subscription_id , period_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
Back to List of Controllers
OrdersController
The singleton instance of the OrdersController
class can be accessed from the API Client.
orders_controller = client . orders
get_orders
Gets all orders
def get_orders ( page = nil ,
size = nil ,
code = nil ,
status = nil ,
created_since = nil ,
created_until = nil ,
customer_id = nil ) ; end
Parameter
Tags
Description
page
Optional
Page number
size
Optional
Page size
code
Optional
Filter for order's code
status
Optional
Filter for order's status
created_since
Optional
Filter for order's creation date start range
created_until
Optional
Filter for order's creation date end range
customer_id
Optional
Filter for order's customer id
page = 120
size = 120
code = 'code'
status = 'status'
created_since = DateTime . now
created_until = DateTime . now
customer_id = 'customer_id'
result = orders_controller . get_orders ( page , size , code , status , created_since , created_until , customer_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_order
Creates a new Order
def create_order ( body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
body
Required
Request for creating an order
idempotency_key
Optional
TODO: Add a parameter description
body = CreateOrderRequest . new
idempotency_key = 'idempotency-key'
result = orders_controller . create_order ( body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_order_item
CreateOrderItem
def create_order_item ( order_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
order_id
Required
Order Id
body
Required
Order Item Model
idempotency_key
Optional
TODO: Add a parameter description
order_id = 'orderId'
body = CreateOrderItemRequest . new
idempotency_key = 'idempotency-key'
result = orders_controller . create_order_item ( order_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_order_item
GetOrderItem
def get_order_item ( order_id ,
item_id ) ; end
Parameter
Tags
Description
order_id
Required
Order Id
item_id
Required
Item Id
order_id = 'orderId'
item_id = 'itemId'
result = orders_controller . get_order_item ( order_id , item_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
delete_order_item
DeleteOrderItem
def delete_order_item ( order_id ,
item_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
order_id
Required
Order Id
item_id
Required
Item Id
idempotency_key
Optional
TODO: Add a parameter description
order_id = 'orderId'
item_id = 'itemId'
idempotency_key = 'idempotency-key'
result = orders_controller . delete_order_item ( order_id , item_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_order_metadata
Updates the metadata from an order
def update_order_metadata ( order_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
order_id
Required
The order id
body
Required
Request for updating the order metadata
idempotency_key
Optional
TODO: Add a parameter description
order_id = 'order_id'
body = UpdateMetadataRequest . new
idempotency_key = 'idempotency-key'
result = orders_controller . update_order_metadata ( order_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
delete_all_order_items
DeleteAllOrderItems
def delete_all_order_items ( order_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
order_id
Required
Order Id
idempotency_key
Optional
TODO: Add a parameter description
order_id = 'orderId'
idempotency_key = 'idempotency-key'
result = orders_controller . delete_all_order_items ( order_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_order_item
UpdateOrderItem
def update_order_item ( order_id ,
item_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
order_id
Required
Order Id
item_id
Required
Item Id
body
Required
Item Model
idempotency_key
Optional
TODO: Add a parameter description
order_id = 'orderId'
item_id = 'itemId'
body = UpdateOrderItemRequest . new
idempotency_key = 'idempotency-key'
result = orders_controller . update_order_item ( order_id , item_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
close_order
CloseOrder
def close_order ( id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
id
Required
Order Id
body
Required
Update Order Model
idempotency_key
Optional
TODO: Add a parameter description
id = 'id'
body = UpdateOrderStatusRequest . new
idempotency_key = 'idempotency-key'
result = orders_controller . close_order ( id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_order
Gets an order
def get_order ( order_id ) ; end
Parameter
Tags
Description
order_id
Required
Order id
order_id = 'order_id'
result = orders_controller . get_order ( order_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
Back to List of Controllers
PlansController
The singleton instance of the PlansController
class can be accessed from the API Client.
plans_controller = client . plans
get_plan
Gets a plan
def get_plan ( plan_id ) ; end
Parameter
Tags
Description
plan_id
Required
Plan id
plan_id = 'plan_id'
result = plans_controller . get_plan ( plan_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_plan
Creates a new plan
def create_plan ( body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
body
Required
Request for creating a plan
idempotency_key
Optional
TODO: Add a parameter description
body = CreatePlanRequest . new
idempotency_key = 'idempotency-key'
result = plans_controller . create_plan ( body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_plan
Updates a plan
def update_plan ( plan_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
plan_id
Required
Plan id
body
Required
Request for updating a plan
idempotency_key
Optional
TODO: Add a parameter description
plan_id = 'plan_id'
body = UpdatePlanRequest . new
idempotency_key = 'idempotency-key'
result = plans_controller . update_plan ( plan_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_plan_item
Gets a plan item
def get_plan_item ( plan_id ,
plan_item_id ) ; end
Parameter
Tags
Description
plan_id
Required
Plan id
plan_item_id
Required
Plan item id
plan_id = 'plan_id'
plan_item_id = 'plan_item_id'
result = plans_controller . get_plan_item ( plan_id , plan_item_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_plan_item
Adds a new item to a plan
def create_plan_item ( plan_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
plan_id
Required
Plan id
body
Required
Request for creating a plan item
idempotency_key
Optional
TODO: Add a parameter description
plan_id = 'plan_id'
body = CreatePlanItemRequest . new
idempotency_key = 'idempotency-key'
result = plans_controller . create_plan_item ( plan_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_plans
Gets all plans
def get_plans ( page = nil ,
size = nil ,
name = nil ,
status = nil ,
billing_type = nil ,
created_since = nil ,
created_until = nil ) ; end
Parameter
Tags
Description
page
Optional
Page number
size
Optional
Page size
name
Optional
Filter for Plan's name
status
Optional
Filter for Plan's status
billing_type
Optional
Filter for plan's billing type
created_since
Optional
Filter for plan's creation date start range
created_until
Optional
Filter for plan's creation date end range
page = 120
size = 120
name = 'name'
status = 'status'
billing_type = 'billing_type'
created_since = DateTime . now
created_until = DateTime . now
result = plans_controller . get_plans ( page , size , name , status , billing_type , created_since , created_until )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
delete_plan
Deletes a plan
def delete_plan ( plan_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
plan_id
Required
Plan id
idempotency_key
Optional
TODO: Add a parameter description
plan_id = 'plan_id'
idempotency_key = 'idempotency-key'
result = plans_controller . delete_plan ( plan_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_plan_metadata
Updates the metadata from a plan
def update_plan_metadata ( plan_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
plan_id
Required
The plan id
body
Required
Request for updating the plan metadata
idempotency_key
Optional
TODO: Add a parameter description
plan_id = 'plan_id'
body = UpdateMetadataRequest . new
idempotency_key = 'idempotency-key'
result = plans_controller . update_plan_metadata ( plan_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_plan_item
Updates a plan item
def update_plan_item ( plan_id ,
plan_item_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
plan_id
Required
Plan id
plan_item_id
Required
Plan item id
body
Required
Request for updating the plan item
idempotency_key
Optional
TODO: Add a parameter description
plan_id = 'plan_id'
plan_item_id = 'plan_item_id'
body = UpdatePlanItemRequest . new
idempotency_key = 'idempotency-key'
result = plans_controller . update_plan_item ( plan_id , plan_item_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
delete_plan_item
Removes an item from a plan
def delete_plan_item ( plan_id ,
plan_item_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
plan_id
Required
Plan id
plan_item_id
Required
Plan item id
idempotency_key
Optional
TODO: Add a parameter description
plan_id = 'plan_id'
plan_item_id = 'plan_item_id'
idempotency_key = 'idempotency-key'
result = plans_controller . delete_plan_item ( plan_id , plan_item_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
Back to List of Controllers
InvoicesController
The singleton instance of the InvoicesController
class can be accessed from the API Client.
invoices_controller = client . invoices
cancel_invoice
Cancels an invoice
def cancel_invoice ( invoice_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
invoice_id
Required
Invoice id
idempotency_key
Optional
TODO: Add a parameter description
invoice_id = 'invoice_id'
idempotency_key = 'idempotency-key'
result = invoices_controller . cancel_invoice ( invoice_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_invoice
Gets an invoice
def get_invoice ( invoice_id ) ; end
Parameter
Tags
Description
invoice_id
Required
Invoice Id
invoice_id = 'invoice_id'
result = invoices_controller . get_invoice ( invoice_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_invoice
Create an Invoice
def create_invoice ( subscription_id ,
cycle_id ,
idempotency_key = nil ,
body = nil ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription Id
cycle_id
Required
Cycle Id
idempotency_key
Optional
TODO: Add a parameter description
body
Optional
TODO: Add a parameter description
subscription_id = 'subscription_id'
cycle_id = 'cycle_id'
idempotency_key = 'idempotency-key'
body = CreateInvoiceRequest . new
result = invoices_controller . create_invoice ( subscription_id , cycle_id , idempotency_key , body )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_invoice_metadata
Updates the metadata from an invoice
def update_invoice_metadata ( invoice_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
invoice_id
Required
The invoice id
body
Required
Request for updating the invoice metadata
idempotency_key
Optional
TODO: Add a parameter description
invoice_id = 'invoice_id'
body = UpdateMetadataRequest . new
idempotency_key = 'idempotency-key'
result = invoices_controller . update_invoice_metadata ( invoice_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_invoices
Gets all invoices
def get_invoices ( page = nil ,
size = nil ,
code = nil ,
customer_id = nil ,
subscription_id = nil ,
created_since = nil ,
created_until = nil ,
status = nil ,
due_since = nil ,
due_until = nil ,
customer_document = nil ) ; end
Parameter
Tags
Description
page
Optional
Page number
size
Optional
Page size
code
Optional
Filter for Invoice's code
customer_id
Optional
Filter for Invoice's customer id
subscription_id
Optional
Filter for Invoice's subscription id
created_since
Optional
Filter for Invoice's creation date start range
created_until
Optional
Filter for Invoices creation date end range
status
Optional
Filter for Invoice's status
due_since
Optional
Filter for Invoice's due date start range
due_until
Optional
Filter for Invoice's due date end range
customer_document
Optional
TODO: Add a parameter description
page = 120
size = 120
code = 'code'
customer_id = 'customer_id'
subscription_id = 'subscription_id'
created_since = DateTime . now
created_until = DateTime . now
status = 'status'
due_since = DateTime . now
due_until = DateTime . now
customer_document = 'customer_document'
result = invoices_controller . get_invoices ( page , size , code , customer_id , subscription_id , created_since , created_until , status , due_since , due_until , customer_document )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_partial_invoice
GetPartialInvoice
def get_partial_invoice ( subscription_id ) ; end
Parameter
Tags
Description
subscription_id
Required
Subscription Id
subscription_id = 'subscription_id'
result = invoices_controller . get_partial_invoice ( subscription_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_invoice_status
Updates the status from an invoice
def update_invoice_status ( invoice_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
invoice_id
Required
Invoice Id
body
Required
Request for updating an invoice's status
idempotency_key
Optional
TODO: Add a parameter description
invoice_id = 'invoice_id'
body = UpdateInvoiceStatusRequest . new
idempotency_key = 'idempotency-key'
result = invoices_controller . update_invoice_status ( invoice_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
Back to List of Controllers
CustomersController
The singleton instance of the CustomersController
class can be accessed from the API Client.
customers_controller = client . customers
delete_card
Delete a customer's card
def delete_card ( customer_id ,
card_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
customer_id
Required
Customer Id
card_id
Required
Card Id
idempotency_key
Optional
TODO: Add a parameter description
customer_id = 'customer_id'
card_id = 'card_id'
idempotency_key = 'idempotency-key'
result = customers_controller . delete_card ( customer_id , card_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_address
Updates an address
def update_address ( customer_id ,
address_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
customer_id
Required
Customer Id
address_id
Required
Address Id
body
Required
Request for updating an address
idempotency_key
Optional
TODO: Add a parameter description
customer_id = 'customer_id'
address_id = 'address_id'
body = UpdateAddressRequest . new
idempotency_key = 'idempotency-key'
result = customers_controller . update_address ( customer_id , address_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_address
Get a customer's address
def get_address ( customer_id ,
address_id ) ; end
Parameter
Tags
Description
customer_id
Required
Customer id
address_id
Required
Address Id
customer_id = 'customer_id'
address_id = 'address_id'
result = customers_controller . get_address ( customer_id , address_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_access_tokens
Get all access tokens from a customer
def get_access_tokens ( customer_id ,
page = nil ,
size = nil ) ; end
Parameter
Tags
Description
customer_id
Required
Customer Id
page
Optional
Page number
size
Optional
Page size
customer_id = 'customer_id'
page = 162
size = 162
result = customers_controller . get_access_tokens ( customer_id , page , size )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_customer
Updates a customer
def update_customer ( customer_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
customer_id
Required
Customer id
body
Required
Request for updating a customer
idempotency_key
Optional
TODO: Add a parameter description
customer_id = 'customer_id'
body = UpdateCustomerRequest . new
idempotency_key = 'idempotency-key'
result = customers_controller . update_customer ( customer_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
renew_card
Renew a card
def renew_card ( customer_id ,
card_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
customer_id
Required
Customer id
card_id
Required
Card Id
idempotency_key
Optional
TODO: Add a parameter description
customer_id = 'customer_id'
card_id = 'card_id'
idempotency_key = 'idempotency-key'
result = customers_controller . renew_card ( customer_id , card_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_customers
Get all Customers
def get_customers ( name = nil ,
document = nil ,
page = 1 ,
size = 10 ,
email = nil ,
code = nil ) ; end
Parameter
Tags
Description
name
Optional
Name of the Customer
document
Optional
Document of the Customer
page
Optional
DefaultValue
Current page the the search
size
Optional
DefaultValue
Quantity pages of the search
email
Optional
Customer's email
code
Optional
Customer's code
name = 'name'
document = 'document'
page = 1
size = 10
email = 'email'
code = 'Code'
result = customers_controller . get_customers ( name , document , page , size , email , code )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
delete_access_tokens
Delete a Customer's access tokens
def delete_access_tokens ( customer_id ) ; end
Parameter
Tags
Description
customer_id
Required
Customer Id
customer_id = 'customer_id'
result = customers_controller . delete_access_tokens ( customer_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_customer
Get a customer
def get_customer ( customer_id ) ; end
Parameter
Tags
Description
customer_id
Required
Customer Id
customer_id = 'customer_id'
result = customers_controller . get_customer ( customer_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_card
Updates a card
def update_card ( customer_id ,
card_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
customer_id
Required
Customer Id
card_id
Required
Card id
body
Required
Request for updating a card
idempotency_key
Optional
TODO: Add a parameter description
customer_id = 'customer_id'
card_id = 'card_id'
body = UpdateCardRequest . new
idempotency_key = 'idempotency-key'
result = customers_controller . update_card ( customer_id , card_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
delete_address
Delete a Customer's address
def delete_address ( customer_id ,
address_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
customer_id
Required
Customer Id
address_id
Required
Address Id
idempotency_key
Optional
TODO: Add a parameter description
customer_id = 'customer_id'
address_id = 'address_id'
idempotency_key = 'idempotency-key'
result = customers_controller . delete_address ( customer_id , address_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_access_token
Creates a access token for a customer
def create_access_token ( customer_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
customer_id
Required
Customer Id
body
Required
Request for creating a access token
idempotency_key
Optional
TODO: Add a parameter description
customer_id = 'customer_id'
body = CreateAccessTokenRequest . new
idempotency_key = 'idempotency-key'
result = customers_controller . create_access_token ( customer_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_address
Creates a new address for a customer
def create_address ( customer_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
customer_id
Required
Customer Id
body
Required
Request for creating an address
idempotency_key
Optional
TODO: Add a parameter description
customer_id = 'customer_id'
body = CreateAddressRequest . new
idempotency_key = 'idempotency-key'
result = customers_controller . create_address ( customer_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_cards
Get all cards from a customer
def get_cards ( customer_id ,
page = nil ,
size = nil ) ; end
Parameter
Tags
Description
customer_id
Required
Customer Id
page
Optional
Page number
size
Optional
Page size
customer_id = 'customer_id'
page = 162
size = 162
result = customers_controller . get_cards ( customer_id , page , size )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_customer_metadata
Updates the metadata a customer
def update_customer_metadata ( customer_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
customer_id
Required
The customer id
body
Required
Request for updating the customer metadata
idempotency_key
Optional
TODO: Add a parameter description
customer_id = 'customer_id'
body = UpdateMetadataRequest . new
idempotency_key = 'idempotency-key'
result = customers_controller . update_customer_metadata ( customer_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_card
Get a customer's card
def get_card ( customer_id ,
card_id ) ; end
Parameter
Tags
Description
customer_id
Required
Customer id
card_id
Required
Card id
customer_id = 'customer_id'
card_id = 'card_id'
result = customers_controller . get_card ( customer_id , card_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
delete_access_token
Delete a customer's access token
def delete_access_token ( customer_id ,
token_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
customer_id
Required
Customer Id
token_id
Required
Token Id
idempotency_key
Optional
TODO: Add a parameter description
customer_id = 'customer_id'
token_id = 'token_id'
idempotency_key = 'idempotency-key'
result = customers_controller . delete_access_token ( customer_id , token_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_access_token
Get a Customer's access token
def get_access_token ( customer_id ,
token_id ) ; end
Parameter
Tags
Description
customer_id
Required
Customer Id
token_id
Required
Token Id
customer_id = 'customer_id'
token_id = 'token_id'
result = customers_controller . get_access_token ( customer_id , token_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_addresses
Gets all adressess from a customer
def get_addresses ( customer_id ,
page = nil ,
size = nil ) ; end
Parameter
Tags
Description
customer_id
Required
Customer id
page
Optional
Page number
size
Optional
Page size
customer_id = 'customer_id'
page = 162
size = 162
result = customers_controller . get_addresses ( customer_id , page , size )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_customer
Creates a new customer
def create_customer ( body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
body
Required
Request for creating a customer
idempotency_key
Optional
TODO: Add a parameter description
body = CreateCustomerRequest . new
idempotency_key = 'idempotency-key'
result = customers_controller . create_customer ( body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_card
Creates a new card for a customer
def create_card ( customer_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
customer_id
Required
Customer id
body
Required
Request for creating a card
idempotency_key
Optional
TODO: Add a parameter description
customer_id = 'customer_id'
body = CreateCardRequest . new
idempotency_key = 'idempotency-key'
result = customers_controller . create_card ( customer_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
Back to List of Controllers
ChargesController
The singleton instance of the ChargesController
class can be accessed from the API Client.
charges_controller = client . charges
capture_charge
Captures a charge
def capture_charge ( charge_id ,
idempotency_key = nil ,
body = nil ) ; end
Parameter
Tags
Description
charge_id
Required
Charge id
idempotency_key
Optional
TODO: Add a parameter description
body
Optional
Request for capturing a charge
charge_id = 'charge_id'
idempotency_key = 'idempotency-key'
body = CreateCaptureChargeRequest . new
result = charges_controller . capture_charge ( charge_id , idempotency_key , body )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_charge_transactions
GetChargeTransactions
def get_charge_transactions ( charge_id ,
page = nil ,
size = nil ) ; end
Parameter
Tags
Description
charge_id
Required
Charge Id
page
Optional
Page number
size
Optional
Page size
charge_id = 'charge_id'
page = 162
size = 162
result = charges_controller . get_charge_transactions ( charge_id , page , size )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_charges
Lists all charges
def get_charges ( page = nil ,
size = nil ,
code = nil ,
status = nil ,
payment_method = nil ,
customer_id = nil ,
order_id = nil ,
created_since = nil ,
created_until = nil ) ; end
Parameter
Tags
Description
page
Optional
Page number
size
Optional
Page size
code
Optional
Filter for charge's code
status
Optional
Filter for charge's status
payment_method
Optional
Filter for charge's payment method
customer_id
Optional
Filter for charge's customer id
order_id
Optional
Filter for charge's order id
created_since
Optional
Filter for the beginning of the range for charge's creation
created_until
Optional
Filter for the end of the range for charge's creation
page = 162
size = 162
code = 'code'
status = 'status'
payment_method = 'payment_method'
customer_id = 'customer_id'
order_id = 'order_id'
created_since = DateTime . now
created_until = DateTime . now
result = charges_controller . get_charges ( page , size , code , status , payment_method , customer_id , order_id , created_since , created_until )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_charge_payment_method
Updates a charge's payment method
def update_charge_payment_method ( charge_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
charge_id
Required
Charge id
body
Required
Request for updating the payment method from a charge
idempotency_key
Optional
TODO: Add a parameter description
charge_id = 'charge_id'
body = UpdateChargePaymentMethodRequest . new
idempotency_key = 'idempotency-key'
result = charges_controller . update_charge_payment_method ( charge_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_charge_due_date
Updates the due date from a charge
def update_charge_due_date ( charge_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
charge_id
Required
Charge Id
body
Required
Request for updating the due date
idempotency_key
Optional
TODO: Add a parameter description
charge_id = 'charge_id'
body = UpdateChargeDueDateRequest . new
idempotency_key = 'idempotency-key'
result = charges_controller . update_charge_due_date ( charge_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
confirm_payment
ConfirmPayment
def confirm_payment ( charge_id ,
idempotency_key = nil ,
body = nil ) ; end
Parameter
Tags
Description
charge_id
Required
TODO: Add a parameter description
idempotency_key
Optional
TODO: Add a parameter description
body
Optional
Request for confirm payment
charge_id = 'charge_id'
idempotency_key = 'idempotency-key'
body = CreateConfirmPaymentRequest . new
result = charges_controller . confirm_payment ( charge_id , idempotency_key , body )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_charge
Get a charge from its id
def get_charge ( charge_id ) ; end
Parameter
Tags
Description
charge_id
Required
Charge id
charge_id = 'charge_id'
result = charges_controller . get_charge ( charge_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
retry_charge
Retries a charge
def retry_charge ( charge_id ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
charge_id
Required
Charge id
idempotency_key
Optional
TODO: Add a parameter description
charge_id = 'charge_id'
idempotency_key = 'idempotency-key'
result = charges_controller . retry_charge ( charge_id , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_charge_metadata
Updates the metadata from a charge
def update_charge_metadata ( charge_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
charge_id
Required
The charge id
body
Required
Request for updating the charge metadata
idempotency_key
Optional
TODO: Add a parameter description
charge_id = 'charge_id'
body = UpdateMetadataRequest . new
idempotency_key = 'idempotency-key'
result = charges_controller . update_charge_metadata ( charge_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_charge_card
Updates the card from a charge
def update_charge_card ( charge_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
charge_id
Required
Charge id
body
Required
Request for updating a charge's card
idempotency_key
Optional
TODO: Add a parameter description
charge_id = 'charge_id'
body = UpdateChargeCardRequest . new
idempotency_key = 'idempotency-key'
result = charges_controller . update_charge_card ( charge_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
cancel_charge
Cancel a charge
def cancel_charge ( charge_id ,
idempotency_key = nil ,
body = nil ) ; end
Parameter
Tags
Description
charge_id
Required
Charge id
idempotency_key
Optional
TODO: Add a parameter description
body
Optional
Request for cancelling a charge
charge_id = 'charge_id'
idempotency_key = 'idempotency-key'
body = CreateCancelChargeRequest . new
result = charges_controller . cancel_charge ( charge_id , idempotency_key , body )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_charges_summary
GetChargesSummary
def get_charges_summary ( status ,
created_since = nil ,
created_until = nil ) ; end
Parameter
Tags
Description
status
Required
TODO: Add a parameter description
created_since
Optional
TODO: Add a parameter description
created_until
Optional
TODO: Add a parameter description
status = 'status'
created_since = DateTime . now
created_until = DateTime . now
result = charges_controller . get_charges_summary ( status , created_since , created_until )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_charge
Creates a new charge
def create_charge ( body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
body
Required
Request for creating a charge
idempotency_key
Optional
TODO: Add a parameter description
body = CreateChargeRequest . new
idempotency_key = 'idempotency-key'
result = charges_controller . create_charge ( body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
Back to List of Controllers
RecipientsController
The singleton instance of the RecipientsController
class can be accessed from the API Client.
recipients_controller = client . recipients
get_transfer
Gets a transfer
def get_transfer ( recipient_id ,
transfer_id ) ; end
Parameter
Tags
Description
recipient_id
Required
Recipient id
transfer_id
Required
Transfer id
recipient_id = 'recipient_id'
transfer_id = 'transfer_id'
result = recipients_controller . get_transfer ( recipient_id , transfer_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_recipient
Retrieves recipient information
def get_recipient ( recipient_id ) ; end
Parameter
Tags
Description
recipient_id
Required
Recipiend id
recipient_id = 'recipient_id'
result = recipients_controller . get_recipient ( recipient_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_recipient_metadata
Updates recipient metadata
def update_recipient_metadata ( recipient_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
recipient_id
Required
Recipient id
body
Required
Metadata
idempotency_key
Optional
TODO: Add a parameter description
recipient_id = 'recipient_id'
body = UpdateMetadataRequest . new
idempotency_key = 'idempotency-key'
result = recipients_controller . update_recipient_metadata ( recipient_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_transfer
Creates a transfer for a recipient
def create_transfer ( recipient_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
recipient_id
Required
Recipient Id
body
Required
Transfer data
idempotency_key
Optional
TODO: Add a parameter description
recipient_id = 'recipient_id'
body = CreateTransferRequest . new
idempotency_key = 'idempotency-key'
result = recipients_controller . create_transfer ( recipient_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_automatic_anticipation_settings
Updates recipient metadata
def update_automatic_anticipation_settings ( recipient_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
recipient_id
Required
Recipient id
body
Required
Metadata
idempotency_key
Optional
TODO: Add a parameter description
recipient_id = 'recipient_id'
body = UpdateAutomaticAnticipationSettingsRequest . new
idempotency_key = 'idempotency-key'
result = recipients_controller . update_automatic_anticipation_settings ( recipient_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_balance
Get balance information for a recipient
def get_balance ( recipient_id ) ; end
Parameter
Tags
Description
recipient_id
Required
Recipient id
recipient_id = 'recipient_id'
result = recipients_controller . get_balance ( recipient_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_anticipations
Retrieves a paginated list of anticipations from a recipient
def get_anticipations ( recipient_id ,
page = nil ,
size = nil ,
status = nil ,
timeframe = nil ,
payment_date_since = nil ,
payment_date_until = nil ,
created_since = nil ,
created_until = nil ) ; end
Parameter
Tags
Description
recipient_id
Required
Recipient id
page
Optional
Page number
size
Optional
Page size
status
Optional
Filter for anticipation status
timeframe
Optional
Filter for anticipation timeframe
payment_date_since
Optional
Filter for start range for anticipation payment date
payment_date_until
Optional
Filter for end range for anticipation payment date
created_since
Optional
Filter for start range for anticipation creation date
created_until
Optional
Filter for end range for anticipation creation date
recipient_id = 'recipient_id'
page = 162
size = 162
status = 'status'
timeframe = 'timeframe'
payment_date_since = DateTime . now
payment_date_until = DateTime . now
created_since = DateTime . now
created_until = DateTime . now
result = recipients_controller . get_anticipations ( recipient_id , page , size , status , timeframe , payment_date_since , payment_date_until , created_since , created_until )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_withdraw_by_id
GetWithdrawById
def get_withdraw_by_id ( recipient_id ,
withdrawal_id ) ; end
Parameter
Tags
Description
recipient_id
Required
TODO: Add a parameter description
withdrawal_id
Required
TODO: Add a parameter description
recipient_id = 'recipient_id'
withdrawal_id = 'withdrawal_id'
result = recipients_controller . get_withdraw_by_id ( recipient_id , withdrawal_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_withdraw
CreateWithdraw
def create_withdraw ( recipient_id ,
body ) ; end
Parameter
Tags
Description
recipient_id
Required
TODO: Add a parameter description
body
Required
TODO: Add a parameter description
recipient_id = 'recipient_id'
body = CreateWithdrawRequest . new
result = recipients_controller . create_withdraw ( recipient_id , body )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_recipient
Updates a recipient
def update_recipient ( recipient_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
recipient_id
Required
Recipient id
body
Required
Recipient data
idempotency_key
Optional
TODO: Add a parameter description
recipient_id = 'recipient_id'
body = UpdateRecipientRequest . new
idempotency_key = 'idempotency-key'
result = recipients_controller . update_recipient ( recipient_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_anticipation
Creates an anticipation
def create_anticipation ( recipient_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
recipient_id
Required
Recipient id
body
Required
Anticipation data
idempotency_key
Optional
TODO: Add a parameter description
recipient_id = 'recipient_id'
body = CreateAnticipationRequest . new
idempotency_key = 'idempotency-key'
result = recipients_controller . create_anticipation ( recipient_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_recipient_default_bank_account
Updates the default bank account from a recipient
def update_recipient_default_bank_account ( recipient_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
recipient_id
Required
Recipient id
body
Required
Bank account data
idempotency_key
Optional
TODO: Add a parameter description
recipient_id = 'recipient_id'
body = UpdateRecipientBankAccountRequest . new
idempotency_key = 'idempotency-key'
result = recipients_controller . update_recipient_default_bank_account ( recipient_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_recipient_by_code
Retrieves recipient information
def get_recipient_by_code ( code ) ; end
Parameter
Tags
Description
code
Required
Recipient code
code = 'code'
result = recipients_controller . get_recipient_by_code ( code )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_anticipation_limits
Gets the anticipation limits for a recipient
def get_anticipation_limits ( recipient_id ,
timeframe ,
payment_date ) ; end
Parameter
Tags
Description
recipient_id
Required
Recipient id
timeframe
Required
Timeframe
payment_date
Required
Anticipation payment date
recipient_id = 'recipient_id'
timeframe = 'timeframe'
payment_date = DateTime . now
result = recipients_controller . get_anticipation_limits ( recipient_id , timeframe , payment_date )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_recipients
Retrieves paginated recipients information
def get_recipients ( page = nil ,
size = nil ) ; end
Parameter
Tags
Description
page
Optional
Page number
size
Optional
Page size
page = 162
size = 162
result = recipients_controller . get_recipients ( page , size )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
create_recipient
Creates a new recipient
def create_recipient ( body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
body
Required
Recipient data
idempotency_key
Optional
TODO: Add a parameter description
body = CreateRecipientRequest . new
idempotency_key = 'idempotency-key'
result = recipients_controller . create_recipient ( body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_transfers
Gets a paginated list of transfers for the recipient
def get_transfers ( recipient_id ,
page = nil ,
size = nil ,
status = nil ,
created_since = nil ,
created_until = nil ) ; end
Parameter
Tags
Description
recipient_id
Required
Recipient id
page
Optional
Page number
size
Optional
Page size
status
Optional
Filter for transfer status
created_since
Optional
Filter for start range of transfer creation date
created_until
Optional
Filter for end range of transfer creation date
recipient_id = 'recipient_id'
page = 70
size = 70
status = 'status'
created_since = DateTime . now
created_until = DateTime . now
result = recipients_controller . get_transfers ( recipient_id , page , size , status , created_since , created_until )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_withdrawals
Gets a paginated list of transfers for the recipient
def get_withdrawals ( recipient_id ,
page = nil ,
size = nil ,
status = nil ,
created_since = nil ,
created_until = nil ) ; end
Parameter
Tags
Description
recipient_id
Required
TODO: Add a parameter description
page
Optional
TODO: Add a parameter description
size
Optional
TODO: Add a parameter description
status
Optional
TODO: Add a parameter description
created_since
Optional
TODO: Add a parameter description
created_until
Optional
TODO: Add a parameter description
recipient_id = 'recipient_id'
page = 70
size = 70
status = 'status'
created_since = DateTime . now
created_until = DateTime . now
result = recipients_controller . get_withdrawals ( recipient_id , page , size , status , created_since , created_until )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_anticipation
Gets an anticipation
def get_anticipation ( recipient_id ,
anticipation_id ) ; end
Parameter
Tags
Description
recipient_id
Required
Recipient id
anticipation_id
Required
Anticipation id
recipient_id = 'recipient_id'
anticipation_id = 'anticipation_id'
result = recipients_controller . get_anticipation ( recipient_id , anticipation_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
update_recipient_transfer_settings
UpdateRecipientTransferSettings
def update_recipient_transfer_settings ( recipient_id ,
body ,
idempotency_key = nil ) ; end
Parameter
Tags
Description
recipient_id
Required
Recipient Identificator
body
Required
TODO: Add a parameter description
idempotency_key
Optional
TODO: Add a parameter description
recipient_id = 'recipient_id'
body = UpdateTransferSettingsRequest . new
idempotency_key = 'idempotency-key'
result = recipients_controller . update_recipient_transfer_settings ( recipient_id , body , idempotency_key )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_default_recipient
GetDefaultRecipient
def get_default_recipient ; end
result = recipients_controller . get_default_recipient ( )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
Back to List of Controllers
TokensController
The singleton instance of the TokensController
class can be accessed from the API Client.
tokens_controller = client . tokens
create_token
Tags: Skips Authentication
CreateToken
def create_token ( public_key ,
body ,
idempotency_key = nil ,
app_id = nil ) ; end
Parameter
Tags
Description
public_key
Required
Public key
body
Required
Request for creating a token
idempotency_key
Optional
TODO: Add a parameter description
app_id
Optional
TODO: Add a parameter description
public_key = 'public_key'
body = CreateTokenRequest . new
idempotency_key = 'idempotency-key'
app_id = 'appId'
result = tokens_controller . create_token ( public_key , body , idempotency_key , app_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_token
Tags: Skips Authentication
Gets a token from its id
def get_token ( id ,
public_key ,
app_id = nil ) ; end
Parameter
Tags
Description
id
Required
Token id
public_key
Required
Public key
app_id
Optional
TODO: Add a parameter description
id = 'id'
public_key = 'public_key'
app_id = 'appId'
result = tokens_controller . get_token ( id , public_key , app_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
Back to List of Controllers
TransfersController
The singleton instance of the TransfersController
class can be accessed from the API Client.
transfers_controller = client . transfers
get_transfers1
Gets all transfers
result = transfers_controller . get_transfers1 ( )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
get_transfer_by_id
GetTransferById
def get_transfer_by_id ( transfer_id ) ; end
Parameter
Tags
Description
transfer_id
Required
TODO: Add a parameter description
transfer_id = 'transfer_id'
result = transfers_controller . get_transfer_by_id ( transfer_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
post_create_transfer
CreateTransfer
def post_create_transfer ( body ) ; end
Parameter
Tags
Description
body
Required
TODO: Add a parameter description
body = CreateTransfer . new
result = transfers_controller . post_create_transfer ( body )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
Back to List of Controllers
TransactionsController
The singleton instance of the TransactionsController
class can be accessed from the API Client.
transactions_controller = client . transactions
get_transaction
GetTransaction
def get_transaction ( transaction_id ) ; end
Parameter
Tags
Description
transaction_id
Required
TODO: Add a parameter description
transaction_id = 'transaction_id'
result = transactions_controller . get_transaction ( transaction_id )
Error Code
Error Description
400
Invalid request
401
Invalid API key
404
An informed resource was not found
412
Business validation error
422
Contract validation error
500
Internal server error
Back to List of Controllers