2.4.0 • Published 2 years ago

@classapp-tech/mundiapilib v2.4.0

Weekly downloads
-
License
MIT
Repository
-
Last release
2 years ago

Disclaimer

This lib was created from a fork of the original Mundipagg NodeJS repo.

Getting started

Mundipagg API

How to Build

The generated SDK relies on Node Package Manager (NPM) being available to resolve dependencies. If you don't already have NPM installed, please go ahead and follow instructions to install NPM from here. The SDK also requires Node to be installed. If Node isn't already installed, please install it from here

NPM is installed by default when Node is installed

To check if node and npm have been successfully installed, write the following commands in command prompt:

  • node --version
  • npm -version

Version Check

Now use npm to resolve all dependencies by running the following command in the root directory (of the SDK folder):

npm install

Resolve Dependencies

Resolve Dependencies

This will install all dependencies in the node_modules folder.

Once dependencies are resolved, you will need to move the folder MundiAPILib in to your node_modules folder.

How to Use

The following section explains how to use the library in a new project.

1. Open Project Folder

Open an IDE/Text Editor for JavaScript like Sublime Text. The basic workflow presented here is also applicable if you prefer using a different editor or IDE.

Click on File and select Open Folder.

Open Folder

Select the folder of your SDK and click on Select Folder to open it up in Sublime Text. The folder will become visible in the bar on the left.

Open Project

2. Creating a Test File

Now right click on the folder name and select the New File option to create a new test file. Save it as index.js Now import the generated NodeJS library using the following lines of code:

var lib = require('lib');

Save changes.

Create new file

Save new file

3. Running The Test File

To run the index.js file, open up the command prompt and navigate to the Path where the SDK folder resides. Type the following command to run the file:

node index.js

Run file

How to Test

These tests use Mocha framework for testing, coupled with Chai for assertions. These dependencies need to be installed for tests to run. Tests can be run in a number of ways:

Method 1 (Run all tests)

  1. Navigate to the root directory of the SDK folder from command prompt.
  2. Type mocha --recursive to run all the tests.

Method 2 (Run all tests)

  1. Navigate to the ../test/Controllers/ directory from command prompt.
  2. Type mocha * to run all the tests.

Method 3 (Run specific controller's tests)

  1. Navigate to the ../test/Controllers/ directory from command prompt.
  2. Type mocha MundiAPIController to run all the tests in that controller file.

To increase mocha's default timeout, you can change the TEST_TIMEOUT parameter's value in TestBootstrap.js.

Run Tests

Initialization

Authentication

In order to setup authentication in the API client, you need the following information.

ParameterDescription
basicAuthUserNameThe username to use with basic authentication
basicAuthPasswordThe password to use with basic authentication

API client can be initialized as following:

const lib = require('lib');

// Configuration parameters and credentials
lib.Configuration.basicAuthUserName = "basicAuthUserName"; // The username to use with basic authentication
lib.Configuration.basicAuthPassword = "basicAuthPassword"; // The password to use with basic authentication

Class Reference

List of Controllers

Class: CustomersController

Get singleton instance

The singleton instance of the CustomersController class can be accessed from the API Client.

var controller = lib.CustomersController;

Method: createAccessToken

Creates a access token for a customer

function createAccessToken(customerId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer Id
requestRequiredRequest for creating a access token
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var customerId = customer_id;
    var request = new CreateAccessTokenRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.createAccessToken(customerId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: updateCustomer

Updates a customer

function updateCustomer(customerId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer id
requestRequiredRequest for updating a customer
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var customerId = customer_id;
    var request = new UpdateCustomerRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateCustomer(customerId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: deleteAccessTokens

Delete a Customer's access tokens

function deleteAccessTokens(customerId, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer Id

Example Usage

    var customerId = customer_id;

    controller.deleteAccessTokens(customerId, function(error, response, context) {

    
    });

Method: getCustomer

Get a customer

function getCustomer(customerId, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer Id

Example Usage

    var customerId = customer_id;

    controller.getCustomer(customerId, function(error, response, context) {

    
    });

Method: getAddresses

Gets all adressess from a customer

function getAddresses(customerId, page, size, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer id
pageOptionalPage number
sizeOptionalPage size

Example Usage

    var customerId = customer_id;
    var page = 177;
    var size = 177;

    controller.getAddresses(customerId, page, size, function(error, response, context) {

    
    });

Method: getAccessToken

Get a Customer's access token

function getAccessToken(customerId, tokenId, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer Id
tokenIdRequiredToken Id

Example Usage

    var customerId = customer_id;
    var tokenId = token_id;

    controller.getAccessToken(customerId, tokenId, function(error, response, context) {

    
    });

Method: getAddress

Get a customer's address

function getAddress(customerId, addressId, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer id
addressIdRequiredAddress Id

Example Usage

    var customerId = customer_id;
    var addressId = address_id;

    controller.getAddress(customerId, addressId, function(error, response, context) {

    
    });

Method: createCard

Creates a new card for a customer

function createCard(customerId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer id
requestRequiredRequest for creating a card
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var customerId = customer_id;
    var request = new CreateCardRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.createCard(customerId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: renewCard

Renew a card

function renewCard(customerId, cardId, idempotencyKey, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer id
cardIdRequiredCard Id
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var customerId = customer_id;
    var cardId = card_id;
    var idempotencyKey = 'idempotency-key';

    controller.renewCard(customerId, cardId, idempotencyKey, function(error, response, context) {

    
    });

Method: createCustomer

Creates a new customer

function createCustomer(request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
requestRequiredRequest for creating a customer
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var request = new CreateCustomerRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.createCustomer(request, idempotencyKey, function(error, response, context) {

    
    });

Method: updateAddress

Updates an address

function updateAddress(customerId, addressId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer Id
addressIdRequiredAddress Id
requestRequiredRequest for updating an address
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var customerId = customer_id;
    var addressId = address_id;
    var request = new UpdateAddressRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateAddress(customerId, addressId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: getAccessTokens

Get all access tokens from a customer

function getAccessTokens(customerId, page, size, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer Id
pageOptionalPage number
sizeOptionalPage size

Example Usage

    var customerId = customer_id;
    var page = 177;
    var size = 177;

    controller.getAccessTokens(customerId, page, size, function(error, response, context) {

    
    });

Method: updateCustomerMetadata

Updates the metadata a customer

function updateCustomerMetadata(customerId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
customerIdRequiredThe customer id
requestRequiredRequest for updating the customer metadata
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var customerId = customer_id;
    var request = new UpdateMetadataRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateCustomerMetadata(customerId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: deleteAddress

Delete a Customer's address

function deleteAddress(customerId, addressId, idempotencyKey, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer Id
addressIdRequiredAddress Id
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var customerId = customer_id;
    var addressId = address_id;
    var idempotencyKey = 'idempotency-key';

    controller.deleteAddress(customerId, addressId, idempotencyKey, function(error, response, context) {

    
    });

Method: updateCard

Updates a card

function updateCard(customerId, cardId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer Id
cardIdRequiredCard id
requestRequiredRequest for updating a card
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var customerId = customer_id;
    var cardId = card_id;
    var request = new UpdateCardRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateCard(customerId, cardId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: deleteAccessToken

Delete a customer's access token

function deleteAccessToken(customerId, tokenId, idempotencyKey, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer Id
tokenIdRequiredToken Id
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var customerId = customer_id;
    var tokenId = token_id;
    var idempotencyKey = 'idempotency-key';

    controller.deleteAccessToken(customerId, tokenId, idempotencyKey, function(error, response, context) {

    
    });

Method: createAddress

Creates a new address for a customer

function createAddress(customerId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer Id
requestRequiredRequest for creating an address
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var customerId = customer_id;
    var request = new CreateAddressRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.createAddress(customerId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: getCard

Get a customer's card

function getCard(customerId, cardId, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer id
cardIdRequiredCard id

Example Usage

    var customerId = customer_id;
    var cardId = card_id;

    controller.getCard(customerId, cardId, function(error, response, context) {

    
    });

Method: getCards

Get all cards from a customer

function getCards(customerId, page, size, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer Id
pageOptionalPage number
sizeOptionalPage size

Example Usage

    var customerId = customer_id;
    var page = 177;
    var size = 177;

    controller.getCards(customerId, page, size, function(error, response, context) {

    
    });

Method: deleteCard

Delete a customer's card

function deleteCard(customerId, cardId, idempotencyKey, callback)

Parameters

ParameterTagsDescription
customerIdRequiredCustomer Id
cardIdRequiredCard Id
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var customerId = customer_id;
    var cardId = card_id;
    var idempotencyKey = 'idempotency-key';

    controller.deleteCard(customerId, cardId, idempotencyKey, function(error, response, context) {

    
    });

Method: getCustomers

Get all Customers

function getCustomers(name, document, page, size, email, code, callback)

Parameters

ParameterTagsDescription
nameOptionalName of the Customer
documentOptionalDocument of the Customer
pageOptional DefaultValueCurrent page the the search
sizeOptional DefaultValueQuantity pages of the search
emailOptionalCustomer's email
codeOptionalCustomer's code

Example Usage

    var name = 'name';
    var document = 'document';
    var page = 177;
    var size = 177;
    var email = 'email';
    var code = 'Code';

    controller.getCustomers(name, document, page, size, email, code, function(error, response, context) {

    
    });

Back to List of Controllers

Class: ChargesController

Get singleton instance

The singleton instance of the ChargesController class can be accessed from the API Client.

var controller = lib.ChargesController;

Method: getCharge

Get a charge from its id

function getCharge(chargeId, callback)

Parameters

ParameterTagsDescription
chargeIdRequiredCharge id

Example Usage

    var chargeId = charge_id;

    controller.getCharge(chargeId, function(error, response, context) {

    
    });

Method: confirmPayment

TODO: Add a method description

function confirmPayment(chargeId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
chargeIdRequiredTODO: Add a parameter description
requestOptionalRequest for confirm payment
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var chargeId = charge_id;
    var request = new CreateConfirmPaymentRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.confirmPayment(chargeId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: updateChargeCard

Updates the card from a charge

function updateChargeCard(chargeId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
chargeIdRequiredCharge id
requestRequiredRequest for updating a charge's card
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var chargeId = charge_id;
    var request = new UpdateChargeCardRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateChargeCard(chargeId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: getCharges

Lists all charges

function getCharges(page, size, code, status, paymentMethod, customerId, orderId, createdSince, createdUntil, callback)

Parameters

ParameterTagsDescription
pageOptionalPage number
sizeOptionalPage size
codeOptionalFilter for charge's code
statusOptionalFilter for charge's status
paymentMethodOptionalFilter for charge's payment method
customerIdOptionalFilter for charge's customer id
orderIdOptionalFilter for charge's order id
createdSinceOptionalFilter for the beginning of the range for charge's creation
createdUntilOptionalFilter for the end of the range for charge's creation

Example Usage

    var page = 177;
    var size = 177;
    var code = 'code';
    var status = 'status';
    var paymentMethod = payment_method;
    var customerId = customer_id;
    var orderId = order_id;
    var createdSince = date("D M d, Y G:i");
    var createdUntil = date("D M d, Y G:i");

    controller.getCharges(page, size, code, status, paymentMethod, customerId, orderId, createdSince, createdUntil, function(error, response, context) {

    
    });

Method: cancelCharge

Cancel a charge

function cancelCharge(chargeId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
chargeIdRequiredCharge id
requestOptionalRequest for cancelling a charge
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var chargeId = charge_id;
    var request = new CreateCancelChargeRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.cancelCharge(chargeId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: retryCharge

Retries a charge

function retryCharge(chargeId, idempotencyKey, callback)

Parameters

ParameterTagsDescription
chargeIdRequiredCharge id
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var chargeId = charge_id;
    var idempotencyKey = 'idempotency-key';

    controller.retryCharge(chargeId, idempotencyKey, function(error, response, context) {

    
    });

Method: updateChargePaymentMethod

Updates a charge's payment method

function updateChargePaymentMethod(chargeId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
chargeIdRequiredCharge id
requestRequiredRequest for updating the payment method from a charge
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var chargeId = charge_id;
    var request = new UpdateChargePaymentMethodRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateChargePaymentMethod(chargeId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: updateChargeMetadata

Updates the metadata from a charge

function updateChargeMetadata(chargeId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
chargeIdRequiredThe charge id
requestRequiredRequest for updating the charge metadata
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var chargeId = charge_id;
    var request = new UpdateMetadataRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateChargeMetadata(chargeId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: captureCharge

Captures a charge

function captureCharge(chargeId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
chargeIdRequiredCharge id
requestOptionalRequest for capturing a charge
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var chargeId = charge_id;
    var request = new CreateCaptureChargeRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.captureCharge(chargeId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: updateChargeDueDate

Updates the due date from a charge

function updateChargeDueDate(chargeId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
chargeIdRequiredCharge Id
requestRequiredRequest for updating the due date
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var chargeId = charge_id;
    var request = new UpdateChargeDueDateRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateChargeDueDate(chargeId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: createCharge

Creates a new charge

function createCharge(request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
requestRequiredRequest for creating a charge
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var request = new CreateChargeRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.createCharge(request, idempotencyKey, function(error, response, context) {

    
    });

Method: getChargeTransactions

TODO: Add a method description

function getChargeTransactions(chargeId, page, size, callback)

Parameters

ParameterTagsDescription
chargeIdRequiredCharge Id
pageOptionalPage number
sizeOptionalPage size

Example Usage

    var chargeId = charge_id;
    var page = 177;
    var size = 177;

    controller.getChargeTransactions(chargeId, page, size, function(error, response, context) {

    
    });

Method: getChargesSummary

TODO: Add a method description

function getChargesSummary(status, createdSince, createdUntil, callback)

Parameters

ParameterTagsDescription
statusRequiredTODO: Add a parameter description
createdSinceOptionalTODO: Add a parameter description
createdUntilOptionalTODO: Add a parameter description

Example Usage

    var status = 'status';
    var createdSince = date("D M d, Y G:i");
    var createdUntil = date("D M d, Y G:i");

    controller.getChargesSummary(status, createdSince, createdUntil, function(error, response, context) {

    
    });

Back to List of Controllers

Class: RecipientsController

Get singleton instance

The singleton instance of the RecipientsController class can be accessed from the API Client.

var controller = lib.RecipientsController;

Method: updateRecipientMetadata

Updates recipient metadata

function updateRecipientMetadata(recipientId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredRecipient id
requestRequiredMetadata
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var recipientId = recipient_id;
    var request = new UpdateMetadataRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateRecipientMetadata(recipientId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: updateRecipientTransferSettings

TODO: Add a method description

function updateRecipientTransferSettings(recipientId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredRecipient Identificator
requestRequiredTODO: Add a parameter description
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var recipientId = recipient_id;
    var request = new UpdateTransferSettingsRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateRecipientTransferSettings(recipientId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: getAnticipation

Gets an anticipation

function getAnticipation(recipientId, anticipationId, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredRecipient id
anticipationIdRequiredAnticipation id

Example Usage

    var recipientId = recipient_id;
    var anticipationId = anticipation_id;

    controller.getAnticipation(recipientId, anticipationId, function(error, response, context) {

    
    });

Method: getRecipients

Retrieves paginated recipients information

function getRecipients(page, size, callback)

Parameters

ParameterTagsDescription
pageOptionalPage number
sizeOptionalPage size

Example Usage

    var page = 177;
    var size = 177;

    controller.getRecipients(page, size, function(error, response, context) {

    
    });

Method: getBalance

Get balance information for a recipient

function getBalance(recipientId, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredRecipient id

Example Usage

    var recipientId = recipient_id;

    controller.getBalance(recipientId, function(error, response, context) {

    
    });

Method: getAnticipations

Retrieves a paginated list of anticipations from a recipient

function getAnticipations(recipientId, page, size, status, timeframe, paymentDateSince, paymentDateUntil, createdSince, createdUntil, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredRecipient id
pageOptionalPage number
sizeOptionalPage size
statusOptionalFilter for anticipation status
timeframeOptionalFilter for anticipation timeframe
paymentDateSinceOptionalFilter for start range for anticipation payment date
paymentDateUntilOptionalFilter for end range for anticipation payment date
createdSinceOptionalFilter for start range for anticipation creation date
createdUntilOptionalFilter for end range for anticipation creation date

Example Usage

    var recipientId = recipient_id;
    var page = 177;
    var size = 177;
    var status = 'status';
    var timeframe = 'timeframe';
    var paymentDateSince = date("D M d, Y G:i");
    var paymentDateUntil = date("D M d, Y G:i");
    var createdSince = date("D M d, Y G:i");
    var createdUntil = date("D M d, Y G:i");

    controller.getAnticipations(recipientId, page, size, status, timeframe, paymentDateSince, paymentDateUntil, createdSince, createdUntil, function(error, response, context) {

    
    });

Method: createAnticipation

Creates an anticipation

function createAnticipation(recipientId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredRecipient id
requestRequiredAnticipation data
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var recipientId = recipient_id;
    var request = new CreateAnticipationRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.createAnticipation(recipientId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: updateRecipientDefaultBankAccount

Updates the default bank account from a recipient

function updateRecipientDefaultBankAccount(recipientId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredRecipient id
requestRequiredBank account data
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var recipientId = recipient_id;
    var request = new UpdateRecipientBankAccountRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateRecipientDefaultBankAccount(recipientId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: getRecipient

Retrieves recipient information

function getRecipient(recipientId, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredRecipiend id

Example Usage

    var recipientId = recipient_id;

    controller.getRecipient(recipientId, function(error, response, context) {

    
    });

Method: getAnticipationLimits

Gets the anticipation limits for a recipient

function getAnticipationLimits(recipientId, timeframe, paymentDate, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredRecipient id
timeframeRequiredTimeframe
paymentDateRequiredAnticipation payment date

Example Usage

    var recipientId = recipient_id;
    var timeframe = 'timeframe';
    var paymentDate = date("D M d, Y G:i");

    controller.getAnticipationLimits(recipientId, timeframe, paymentDate, function(error, response, context) {

    
    });

Method: getTransfer

Gets a transfer

function getTransfer(recipientId, transferId, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredRecipient id
transferIdRequiredTransfer id

Example Usage

    var recipientId = recipient_id;
    var transferId = transfer_id;

    controller.getTransfer(recipientId, transferId, function(error, response, context) {

    
    });

Method: getTransfers

Gets a paginated list of transfers for the recipient

function getTransfers(recipientId, page, size, status, createdSince, createdUntil, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredRecipient id
pageOptionalPage number
sizeOptionalPage size
statusOptionalFilter for transfer status
createdSinceOptionalFilter for start range of transfer creation date
createdUntilOptionalFilter for end range of transfer creation date

Example Usage

    var recipientId = recipient_id;
    var page = 85;
    var size = 85;
    var status = 'status';
    var createdSince = date("D M d, Y G:i");
    var createdUntil = date("D M d, Y G:i");

    controller.getTransfers(recipientId, page, size, status, createdSince, createdUntil, function(error, response, context) {

    
    });

Method: updateRecipient

Updates a recipient

function updateRecipient(recipientId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredRecipient id
requestRequiredRecipient data
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var recipientId = recipient_id;
    var request = new UpdateRecipientRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateRecipient(recipientId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: createRecipient

Creates a new recipient

function createRecipient(request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
requestRequiredRecipient data
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var request = new CreateRecipientRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.createRecipient(request, idempotencyKey, function(error, response, context) {

    
    });

Method: createTransfer

Creates a transfer for a recipient

function createTransfer(recipientId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredRecipient Id
requestRequiredTransfer data
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var recipientId = recipient_id;
    var request = new CreateTransferRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.createTransfer(recipientId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: createWithdraw

TODO: Add a method description

function createWithdraw(recipientId, request, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredTODO: Add a parameter description
requestRequiredTODO: Add a parameter description

Example Usage

    var recipientId = recipient_id;
    var request = new CreateWithdrawRequest({"key":"value"});

    controller.createWithdraw(recipientId, request, function(error, response, context) {

    
    });

Method: getWithdrawById

TODO: Add a method description

function getWithdrawById(recipientId, withdrawalId, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredTODO: Add a parameter description
withdrawalIdRequiredTODO: Add a parameter description

Example Usage

    var recipientId = recipient_id;
    var withdrawalId = withdrawal_id;

    controller.getWithdrawById(recipientId, withdrawalId, function(error, response, context) {

    
    });

Method: getWithdrawals

Gets a paginated list of transfers for the recipient

function getWithdrawals(recipientId, page, size, status, createdSince, createdUntil, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredTODO: Add a parameter description
pageOptionalTODO: Add a parameter description
sizeOptionalTODO: Add a parameter description
statusOptionalTODO: Add a parameter description
createdSinceOptionalTODO: Add a parameter description
createdUntilOptionalTODO: Add a parameter description

Example Usage

    var recipientId = recipient_id;
    var page = 85;
    var size = 85;
    var status = 'status';
    var createdSince = date("D M d, Y G:i");
    var createdUntil = date("D M d, Y G:i");

    controller.getWithdrawals(recipientId, page, size, status, createdSince, createdUntil, function(error, response, context) {

    
    });

Method: updateAutomaticAnticipationSettings

Updates recipient metadata

function updateAutomaticAnticipationSettings(recipientId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
recipientIdRequiredRecipient id
requestRequiredMetadata
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var recipientId = recipient_id;
    var request = new UpdateAutomaticAnticipationSettingsRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateAutomaticAnticipationSettings(recipientId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: getRecipientByCode

Retrieves recipient information

function getRecipientByCode(code, callback)

Parameters

ParameterTagsDescription
codeRequiredRecipient code

Example Usage

    var code = 'code';

    controller.getRecipientByCode(code, function(error, response, context) {

    
    });

Back to List of Controllers

Class: SubscriptionsController

Get singleton instance

The singleton instance of the SubscriptionsController class can be accessed from the API Client.

var controller = lib.SubscriptionsController;

Method: createDiscount

Creates a discount

function createDiscount(subscriptionId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
subscriptionIdRequiredSubscription id
requestRequiredRequest for creating a discount
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var subscriptionId = subscription_id;
    var request = new CreateDiscountRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.createDiscount(subscriptionId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: getSubscriptionItem

Get Subscription Item

function getSubscriptionItem(subscriptionId, itemId, callback)

Parameters

ParameterTagsDescription
subscriptionIdRequiredSubscription Id
itemIdRequiredItem id

Example Usage

    var subscriptionId = subscription_id;
    var itemId = item_id;

    controller.getSubscriptionItem(subscriptionId, itemId, function(error, response, context) {

    
    });

Method: deleteUsage

Deletes a usage

function deleteUsage(subscriptionId, itemId, usageId, idempotencyKey, callback)

Parameters

ParameterTagsDescription
subscriptionIdRequiredThe subscription id
itemIdRequiredThe subscription item id
usageIdRequiredThe usage id
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var subscriptionId = subscription_id;
    var itemId = item_id;
    var usageId = usage_id;
    var idempotencyKey = 'idempotency-key';

    controller.deleteUsage(subscriptionId, itemId, usageId, idempotencyKey, function(error, response, context) {

    
    });

Method: cancelSubscription

Cancels a subscription

function cancelSubscription(subscriptionId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
subscriptionIdRequiredSubscription id
requestOptionalRequest for cancelling a subscription
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var subscriptionId = subscription_id;
    var request = new CreateCancelSubscriptionRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.cancelSubscription(subscriptionId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: deleteIncrement

Deletes a increment

function deleteIncrement(subscriptionId, incrementId, idempotencyKey, callback)

Parameters

ParameterTagsDescription
subscriptionIdRequiredSubscription id
incrementIdRequiredIncrement id
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var subscriptionId = subscription_id;
    var incrementId = increment_id;
    var idempotencyKey = 'idempotency-key';

    controller.deleteIncrement(subscriptionId, incrementId, idempotencyKey, function(error, response, context) {

    
    });

Method: getSubscriptionCycleById

TODO: Add a method description

function getSubscriptionCycleById(subscriptionId, cycleId, callback)

Parameters

ParameterTagsDescription
subscriptionIdRequiredThe subscription id
cycleIdRequiredTODO: Add a parameter description

Example Usage

    var subscriptionId = subscription_id;
    var cycleId = 'cycleId';

    controller.getSubscriptionCycleById(subscriptionId, cycleId, function(error, response, context) {

    
    });

Method: updateSubscriptionStartAt

Updates the start at date from a subscription

function updateSubscriptionStartAt(subscriptionId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
subscriptionIdRequiredThe subscription id
requestRequiredRequest for updating the subscription start date
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var subscriptionId = subscription_id;
    var request = new UpdateSubscriptionStartAtRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateSubscriptionStartAt(subscriptionId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: updateSubscriptionPaymentMethod

Updates the payment method from a subscription

function updateSubscriptionPaymentMethod(subscriptionId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
subscriptionIdRequiredSubscription id
requestRequiredRequest for updating the paymentmethod from a subscription
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var subscriptionId = subscription_id;
    var request = new UpdateSubscriptionPaymentMethodRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateSubscriptionPaymentMethod(subscriptionId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: updateCurrentCycleStatus

TODO: Add a method description

function updateCurrentCycleStatus(subscriptionId, request, idempotencyKey, callback)

Parameters

ParameterTagsDescription
subscriptionIdRequiredSubscription Id
requestRequiredRequest for updating the end date of the subscription current status
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var subscriptionId = subscription_id;
    var request = new UpdateCurrentCycleStatusRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateCurrentCycleStatus(subscriptionId, request, idempotencyKey, function(error, response, context) {

    
    });

Method: createSubscription

Creates a new subscription

function createSubscription(body, idempotencyKey, callback)

Parameters

ParameterTagsDescription
bodyRequiredRequest for creating a subscription
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var body = new CreateSubscriptionRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.createSubscription(body, idempotencyKey, function(error, response, context) {

    
    });

Method: getUsagesDetails

TODO: Add a method description

function getUsagesDetails(subscriptionId, cycleId, size, page, itemId, group, callback)

Parameters

ParameterTagsDescription
subscriptionIdRequiredSubscription Identifier
cycleIdOptionalCycle id
sizeOptionalPage size
pageOptionalPage number
itemIdOptionalIdentificador do item
groupOptionalidentificador da loja (account) de cada item

Example Usage

    var subscriptionId = subscription_id;
    var cycleId = cycle_id;
    var size = 85;
    var page = 85;
    var itemId = item_id;
    var group = 'group';

    controller.getUsagesDetails(subscriptionId, cycleId, size, page, itemId, group, function(error, response, context) {

    
    });

Method: renewSubscription

TODO: Add a method description

function renewSubscription(subscriptionId, idempotencyKey, callback)

Parameters

ParameterTagsDescription
subscriptionIdRequiredTODO: Add a parameter description
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var subscriptionId = subscription_id;
    var idempotencyKey = 'idempotency-key';

    controller.renewSubscription(subscriptionId, idempotencyKey, function(error, response, context) {

    
    });

Method: updateSubscriptionItem

Updates a subscription item

function updateSubscriptionItem(subscriptionId, itemId, body, idempotencyKey, callback)

Parameters

ParameterTagsDescription
subscriptionIdRequiredSubscription Id
itemIdRequiredItem id
bodyRequiredRequest for updating a subscription item
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var subscriptionId = subscription_id;
    var itemId = item_id;
    var body = new UpdateSubscriptionItemRequest({"key":"value"});
    var idempotencyKey = 'idempotency-key';

    controller.updateSubscriptionItem(subscriptionId, itemId, body, idempotencyKey, function(error, response, context) {

    
    });

Method: createAnUsage

Create Usage

function createAnUsage(subscriptionId, itemId, idempotencyKey, callback)

Parameters

ParameterTagsDescription
subscriptionIdRequiredSubscription id
itemIdRequiredItem id
idempotencyKeyOptionalTODO: Add a parameter description

Example Usage

    var subscriptionId = subscription_id;
    var itemId = item_id;
    var idempotencyKey = 'idempotency-key';

    controller.createAnUsage(subscriptionId, itemId, idempotencyKey, function(error, response, context) {

    
    });

Method: getIncrementById

TODO: Add a method description

function getIncrementById(subscriptionId, incrementId, callback)

Parameters

ParameterTagsDescription
subscriptionIdRequiredThe subscription Id
incrementIdRequiredThe increment Id

Example Usage

    var subscriptionId = subscription_id;
    var incrementId = increment_id;

    controller.getIncrementById(subscriptionId, incrementId, function(error, response, context) {

    
    });

Method: (https://apidocs.io/img/method.png ".SubscriptionsController.delete

2.4.0

2 years ago