module:api/PaymentApi(apiClientopt)

new module:api/PaymentApi(apiClientopt)

This class subject to change without prior notice, Please dont use this class directly.

Constructs a new PaymentApi.
Parameters:
Name Type Attributes Description
apiClient module:ApiClient <optional>

Optional API client implementation to use, default to module:ApiClient#instance if unspecified.

Methods

createPayment(channel, client_key, product, timestamp, idempotent_request_key, requestor_type, id_customer, create_payment_request, opts, callback)

Create Payment The API is used to make payments to service a customer account. Client systems can provide the unique identifier for the payment in their system as payment_reference.<p>Fee amount and fee type are conditional and should be provided if the details of the fee to be charged are maintained in the client system. The fee types that are supported in EBPP are add_to_principal and bill_separately. Alternatively, the fee information can be setup in EBPP, in which case, these fields are ignored. If fee information is setup in the system, the details of the fee are returned in the response.

Parameters:
Name Type Description
channel String

The channel through which the API is invoked.

client_key String

The unique identifier assigned by EBPP to the client.

product module:models/String

The product identifier corresponding to the API.

timestamp String

The timestamp for the moment when the API request is created.

idempotent_request_key String

The unique token that clients can generate and maintain in order to identify an API request.

requestor_type module:models/String

Type of the requestor of the API.

id_customer String

The unique identifier assigned by EBPP to the customer.

create_payment_request module:models/CreatePaymentRequest

JSON containing all the fields required to make a payment.

opts Object

Optional parameters

Properties
Name Type Description
requestor String

The identifier for the requestor of the API. If the requestor_type is <b>system</b>, requestor is optional.

x_opay_headers String

Intended for the future use.

callback module:api/PaymentApi~createPaymentCallback

The callback function, accepting three arguments: error, data, response data is of type: module:models/PaymentResponse

deletePayment(channel, client_key, product, timestamp, idempotent_request_key, requestor_type, id_payment, id_customer, delete_payment_request, opts, callback)

Delete Payment The API is used to delete or cancel a payment. Payments that are under processing or have already been processed cannot be deleted.

Parameters:
Name Type Description
channel String

The channel through which the API is invoked.

client_key String

The unique identifier assigned by EBPP to the client.

product module:models/String

The product identifier corresponding to the API.

timestamp String

The timestamp for the moment when the API request is created.

idempotent_request_key String

The unique token that clients can generate and maintain in order to identify an API request.

requestor_type module:models/String

Type of the requestor of the API.

id_payment String

The unique identifier assigned by EBPP to the payment.

id_customer String

The unique identifier assigned by EBPP to the customer.

delete_payment_request module:models/DeletePaymentRequest

Details of payment to be deleted/cancelled

opts Object

Optional parameters

Properties
Name Type Description
requestor String

The identifier for the requestor of the API. If the requestor_type is <b>system</b>, requestor is optional.

x_opay_headers String

Intended for the future use.

callback module:api/PaymentApi~deletePaymentCallback

The callback function, accepting three arguments: error, data, response data is of type: module:models/DeleteResponse

getPayment(channel, client_key, product, timestamp, idempotent_request_key, requestor_type, id_payment, id_customer, opts, callback)

Get Payment The API is used to retrieve the details of a payment by id.

Parameters:
Name Type Description
channel String

The channel through which the API is invoked.

client_key String

The unique identifier assigned by EBPP to the client.

product module:models/String

The product identifier corresponding to the API.

timestamp String

The timestamp for the moment when the API request is created.

idempotent_request_key String

The unique token that clients can generate and maintain in order to identify an API request.

requestor_type module:models/String

Type of the requestor of the API.

id_payment String

The unique identifier assigned by EBPP to the payment.

id_customer String

The unique identifier assigned by EBPP to the customer.

opts Object

Optional parameters

Properties
Name Type Description
requestor String

The identifier for the requestor of the API. If the requestor_type is <b>system</b>, requestor is optional.

x_opay_headers String

Intended for the future use.

callback module:api/PaymentApi~getPaymentCallback

The callback function, accepting three arguments: error, data, response data is of type: module:models/PaymentResponse

retrieveFeePayment(channel, client_key, product, timestamp, idempotent_request_key, requestor_type, id_fee, id_customer, opts, callback)

Get Fee Payment The API is used to retrieve the details of a fee payment by id.

Parameters:
Name Type Description
channel String

The channel through which the API is invoked.

client_key String

The unique identifier assigned by OrbiPay to the client.

product module:models/String

The product identifier corresponding to the API.

timestamp String

The timestamp for the moment when the API request is created.

idempotent_request_key String

The unique token that clients can generate and maintain in order to identify an API request.

requestor_type module:models/String

Type of the requestor of the API.

id_fee String

The unique identifier assigned by OrbiPay to the FeePayment.

id_customer String

The unique identifier assigned by OrbiPay to the customer.

opts Object

Optional parameters

Properties
Name Type Description
requestor String

The identifier for the requestor of the API. If the requestor_type is <b>system</b>, requestor is optional.

x_opay_headers String

Intended for the future use.

callback module:api/PaymentApi~retrieveFeePaymentCallback

The callback function, accepting three arguments: error, data, response data is of type: module:models/PaymentResponse

retrievePayments(channel, client_key, product, timestamp, idempotent_request_key, requestor_type, opts, callback)

Retrieve Payments The API is used to retrieve the payments made by a customer. Payments can be filtered using the confirmation number, customer account, funding account, status and payment schedule type, by date range and others mentioned below. If no dates are provided for retrieval, payments in the last six months and all the payments scheduled for a future date are returned. In case a payment has failed due to ACH returns, then the payment return date and the return code will be available in the response. If the requestor type is customer then the id_customer request parameter is mandatory.

Parameters:
Name Type Description
channel String

The channel through which the API is invoked.

client_key String

The unique identifier assigned by EBPP to the client.

product module:models/String

The product identifier corresponding to the API.

timestamp String

The timestamp for the moment when the API request is created.

idempotent_request_key String

The unique token that clients can generate and maintain in order to identify an API request.

requestor_type module:models/String

Type of the requestor of the API.

opts Object

Optional parameters

Properties
Name Type Description
requestor String

The identifier for the requestor of the API. If the requestor_type is <b>system</b>, requestor is optional.

x_opay_headers String

Intended for the future use.

id_customer String

The unique identifier assigned by EBPP to the customer.

id_funding_account String

The unique identifier assigned by EBPP to the funding account

id_customer_account String

The unique identifier assigned by EBPP to the customer account

confirmation_number String

The confirmation number or reference provided to the customer for the successful payment.

status Array.<module:models/String>

The status of the payment. This can take multiple values in the format key=value1&key=value2....

payment_schedule_type Array.<module:models/String>

The schedule type for the payment setup. This can take multiple values in the format key=value1&key=value2....

from_date String

The date from which payments, matching the criteria specified, need to be retrieved.

to_date String

The date upto which payments, matching the criteria specified, need to be retrieved.

page_size String

The maximum number of objects returned in the query.

query_id String

query id of the Retrieve/Search Customers lookup.

from_index String

To fetch the next set of objects that start after this object

to_index String

To fetch the previous set of objects that end at this object

callback module:api/PaymentApi~retrievePaymentsCallback

The callback function, accepting three arguments: error, data, response data is of type: module:models/PaymentsResponse

simplePayment(channel, client_key, product, timestamp, idempotent_request_key, requestor_type, simple_payment_request, opts, callback)

Simple Payment The API is used to make payments to service a customer account. Client systems can provide the unique identifier for the payment in their system as payment_reference. Fee amount and fee type are conditional and should be provided if the details of the fee to be charged are maintained in the client system. The fee types that are supported in EBPP are add_to_principal and bill_separately. Alternatively, the fee information can be setup in EBPP, in which case, these fields are ignored. If fee information is setup in the system, the details of the fee are returned in the response. This API updates the details of the customer, customer account and the funding account if those exist in EBPP or creates them otherwise.

Parameters:
Name Type Description
channel String

The channel through which the API is invoked.

client_key String

The unique identifier assigned by EBPP to the client.

product module:models/String

The product identifier corresponding to the API.

timestamp String

The timestamp for the moment when the API request is created.

idempotent_request_key String

The unique token that clients can generate and maintain in order to identify an API request.

requestor_type module:models/String

Type of the requestor of the API.

simple_payment_request module:models/SimplePaymentRequest

JSON containing all the fields required to make a payment.

opts Object

Optional parameters

Properties
Name Type Description
requestor String

The identifier for the requestor of the API. If the requestor_type is <b>system</b>, requestor is optional.

x_opay_headers String

Intended for the future use.

save_funding_account module:models/String

query param

callback module:api/PaymentApi~simplePaymentCallback

The callback function, accepting three arguments: error, data, response data is of type: module:models/SimplePaymentResponse

updatePayment(channel, client_key, product, timestamp, idempotent_request_key, requestor_type, id_payment, id_customer, update_payment_request, opts, callback)

Update Payment The API is used to edit a payment. Only payments in scheduled status can be edited.

Parameters:
Name Type Description
channel String

The channel through which the API is invoked.

client_key String

The unique identifier assigned by EBPP to the client.

product module:models/String

The product identifier corresponding to the API.

timestamp String

The timestamp for the moment when the API request is created.

idempotent_request_key String

The unique token that clients can generate and maintain in order to identify an API request.

requestor_type module:models/String

Type of the requestor of the API.

id_payment String

The unique identifier assigned by EBPP to the payment.

id_customer String

The unique identifier assigned by EBPP to the customer.

update_payment_request module:models/UpdatePaymentRequest

Details of the Payment to be updated.

opts Object

Optional parameters

Properties
Name Type Description
requestor String

The identifier for the requestor of the API. If the requestor_type is <b>system</b>, requestor is optional.

x_opay_headers String

Intended for the future use.

callback module:api/PaymentApi~updatePaymentCallback

The callback function, accepting three arguments: error, data, response data is of type: module:models/PaymentResponse

Type Definitions

createPaymentCallback(error, data, response)

Callback function to receive the result of the createPayment operation.

Parameters:
Name Type Description
error String

Error message, if any.

data module:models/PaymentResponse

The data returned by the service call.

response String

The complete HTTP response.

deletePaymentCallback(error, data, response)

Callback function to receive the result of the deletePayment operation.

Parameters:
Name Type Description
error String

Error message, if any.

data module:models/DeleteResponse

The data returned by the service call.

response String

The complete HTTP response.

getPaymentCallback(error, data, response)

Callback function to receive the result of the getPayment operation.

Parameters:
Name Type Description
error String

Error message, if any.

data module:models/PaymentResponse

The data returned by the service call.

response String

The complete HTTP response.

retrieveFeePaymentCallback(error, data, response)

Callback function to receive the result of the retrieveFeePayment operation.

Parameters:
Name Type Description
error String

Error message, if any.

data module:models/PaymentResponse

The data returned by the service call.

response String

The complete HTTP response.

retrievePaymentsCallback(error, data, response)

Callback function to receive the result of the retrievePayments operation.

Parameters:
Name Type Description
error String

Error message, if any.

data module:models/PaymentsResponse

The data returned by the service call.

response String

The complete HTTP response.

simplePaymentCallback(error, data, response)

Callback function to receive the result of the simplePayment operation.

Parameters:
Name Type Description
error String

Error message, if any.

data module:models/SimplePaymentResponse

The data returned by the service call.

response String

The complete HTTP response.

updatePaymentCallback(error, data, response)

Callback function to receive the result of the updatePayment operation.

Parameters:
Name Type Description
error String

Error message, if any.

data module:models/PaymentResponse

The data returned by the service call.

response String

The complete HTTP response.