NAME

Stancer::Dispute - Dispute representation

VERSION

version 1.0.1

ATTRIBUTES

amount

Read-only integer.

Dispute amount.

currency

Read-only string.

Dispute currency.

order_id

Read-only string.

External order id.

payment

Read-only instance of Stancer::Payment.

Related payment object.

response

Read-only 2 or 4 characters string.

API response code.

METHODS

Stancer::Dispute->new() : self

Stancer::Dispute->new($token) : self

Stancer::Dispute->new(%args) : self

Stancer::Dispute->new(\%args) : self

This method accept an optional string, it will be used as an entity ID for API calls.

# Get an empty new payment
my $new = Stancer::Dispute->new();

# Get an existing payment
my $exist = Stancer::Dispute->new($token);

Dispute->list(%terms) : DisputeIterator

Dispute->list(\%terms) : DisputeIterator

List all disputes.

%terms must be an hash or a reference to an hash (\%terms) with at least one of the following key :

created

Must be an unix timestamp, a DateTime or a DateTime::Span object which will filter payments created after this value. If a DateTime::Span is passed, created_until will be ignored and replaced with DateTime::Span->end.

created_until

Must be an unix timestamp or a DateTime object which will filter payments created before this value. If a DateTime::Span is passed to created, this value will be ignored.

limit

Must be an integer between 1 and 100 and will limit the number of objects to be returned. API defaults is to return 10 elements.

start

Must be an integer and will be used as a pagination cursor, starts at 0.

USAGE

Logging

We use the Log::Any framework for logging events. You may tell where it should log using any available Log::Any::Adapter module.

For example, to log everything to a file you just have to add a line to your script, like this: #! /usr/bin/env perl use Log::Any::Adapter (File => '/var/log/payment.log'); use Stancer::Dispute;

You must import Log::Any::Adapter before our libraries, to initialize the logger instance before use.

You can choose your log level on import directly: use Log::Any::Adapter (File => '/var/log/payment.log', log_level => 'info');

Read the Log::Any documentation to know what other options you have.

SECURITY

  • Never, never, NEVER register a card or a bank account number in your database.

  • Always uses HTTPS in card/SEPA in communication.

  • Our API will never give you a complete card/SEPA number, only the last four digits. If you need to keep track, use these last four digit.

BUGS

Please report any bugs or feature requests on the bugtracker website https://gitlab.com/wearestancer/library/lib-perl/-/issues or by email to bug-stancer@rt.cpan.org.

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR

Joel Da Silva <jdasilva@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2018-2024 by Stancer / Iliad78.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)