NAME

Stancer::Sepa - Representation of a SEPA account

VERSION

version 1.0.3

ATTRIBUTES

bic

Read/Write string.

BIC code, also called SWIFT code.

check

Read-only instance of Stancer::SepaMail.

Verification results.

country

Read-only string.

Account country

date_birth

Read/Write instance of DateTime.

A DateTime object representing the user birthdate.

This value is mandatory to use Sepa check service.

date_mandate

Read/Write instance of DateTime.

A DateTime object representing the mandate signature date.

This value is mandatory if a mandate is provided.

formatted_iban

Read-only string.

Account number but formatted in 4 characters blocs separated with spaces.

iban

Read/Write string.

Account number

last4

Read-only 4 characters string.

Last four account number

name

Read/Write 4 to 64 characters.

Customer name

mandate

Read/Write 3 to 35 characters.

The mandate referring to the payment

METHODS

Stancer::Sepa->new() : self

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

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

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

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

# Get an empty new sepa account
my $new = Stancer::Sepa->new();

# Get an existing sepa account
my $exist = Stancer::Sepa->new($token);

validate

Will ask for SEPA validation.

See "check" in sepa for more information.

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::Sepa;

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)