NAV
shell php

Πλήρες ευρετήριο της υπηρεσίας API

Στη σελίδα αυτή θα βρείτε τον πλήρη κατάλογο με όλες τις λειτουργίες που μπορούν να εκτελεστούν μέσω της υπηρεσίας API του EveryPay.

Διαβάστε περισσότερα σχετικά με τα κλειδιά σας εδω.

Tokens

Τα Tokens είναι προσωρινά, μοναδικά αναγνωριστικά που μπορούν να χρησιμοποιηθούν για να εκτελεστεί μια λειτουργία πληρωμής μέσω πιστωτικής κάρτας, χωρίς να χρειάζεται να μεταδωθούν τα ευαίσθητα στοιχεία της.

Ισχύουν μόνο για μια συναλλαγή και έχουν περιορισμένη διάρκεια ζωής (15 λεπτά), μετά την οποία απορρίπτονται. Αν θέλετε να χρεώνετε μία κάρτα επαναληπτικά (π.χ. συνδρομή), τότε μπορείτε να δημιουργήσετε ένα αντικείμενο Πελάτη και η χρέωση θα γίνεται με χρήση αυτού.

Δημιουργία Τoken

Δημιουργία Token κάρτας με το δημόσιο κλειδί.

curl https://api.everypay.gr/tokens
  -u pk_atFzbY3VB94gFFJ3FxArEWM8DpnuA1y8:
  -d amount=1099
  -d card_number=4242424242424242
  -d expiration_year=2016
  -d expiration_month=05
  -d cvv=334
  -d holder_name="John Doe"
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Token;

Everypay::setApiKey('pk_atFzbY3VB94gFFJ3FxArEWM8DpnuA1y8');

$params = array(
    'amount' => 1099
    'card_number' => '4242424242424242',
    'expiration_year' => '2016',
    'expiration_month' => '05',
    'cvv' => '334',
    'holder_name'=>'John Doe'
);

$token = Token::create($params);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "ctn_zUOwAdOqWe9BjQ86dYTWr13I",
    "is_used": false,
    "has_expired": false,
    "amount": 1099,
    "date_created": "2015-07-24T16:36:39+0300",
    "card": {
        "expiration_month": "05",
        "expiration_year": "2016",
        "last_four": "4242",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "max_installments": 0
    }
}
<?php
stdClass Object
(
    [token] => ctn_zUOwAdOqWe9BjQ86dYTWr13I
    [is_used] => 
    [has_expired] => 
    [amount] => 1099
    [date_created] => 2015-07-24T16:36:39+0300
    [card] => stdClass Object
        (
            [expiration_month] => 05
            [expiration_year] => 2016
            [last_four] => 4242
            [type] => Visa
            [holder_name] => John Doe
            [supports_installments] => 
            [max_installments] => 0
        )

)

Δημιουργία Token κάρτας που υποστηρίζει δόσεις, με το δημόσιο κλειδί.

curl https://api.everypay.gr/tokens
  -u pk_atFzbY3VB94gFFJ3FxArEWM8DpnuA1y8:
  -d amount=10000
  -d card_number=4908440000000003
  -d expiration_year=2016
  -d expiration_month=08
  -d cvv=123
  -d holder_name="John Doe"
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Token;

Everypay::setApiKey('pk_atFzbY3VB94gFFJ3FxArEWM8DpnuA1y8');

$params = array(
    'amount' => 10000
    'card_number' => '4908440000000003',
    'expiration_year' => '2016',
    'expiration_month' => '08',
    'cvv' => '123',
    'holder_name'=>'John Doe'
);

$token = Token::create($params);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "ctn_zUOwAdOqWe9BjQ86dYTWr13I",
    "is_used": false,
    "has_expired": false,
    "amount": 10000,
    "date_created": "2015-07-24T16:36:39+0300",
    "card": {
        "expiration_month": "08",
        "expiration_year": "2016",
        "last_four": "0003",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": true,
        "max_installments": 3
    }
}
<?php
stdClass Object
(
    [token] => ctn_zUOwAdOqWe9BjQ86dYTWr13I
    [is_used] => 
    [has_expired] => 
    [amount] => 10000
    [date_created] => 2015-07-24T16:36:39+0300
    [card] => stdClass Object
        (
            [expiration_month] => 08
            [expiration_year] => 2016
            [last_four] => 0003
            [type] => Visa
            [holder_name] => John Doe
            [supports_installments] => 1
            [max_installments] => 3
        )

)
   
URL https://api.everypay.gr/tokens
Μέθοδος POST
Περιγραφή Δημιουργία αντικειμένου Token, συσχετισμένο με ορισμένες πληροφορίες της κάρτας.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
PUBLIC KEY Ναι string(35) Το δημόσιο κλειδί (ή το ιδιωτικό) δίνεται σαν username για HTTP πρόσβαση.
card_number Ναι integer(16) O αριθμός της κάρτας.
holder_name Ναι string(255) To όνομα κατόχου της κάρτας.
expiration_year Ναι integer(4) Έτος λήξης της κάρτας (4 ψηφία).
expiration_month Ναι integer(2) Μήνας λήξης της κάρτας (2 ψηφία).
cvv Ναι integer(3) Ο τριψήφιος κωδικός ασφαλείας στο πίσω μέρος της κάρτας.
amount Όχι integer Το ποσό της χρέωσης σε cents (χωρίς σημεία στίξης π.χ. 1099 αντί 10,99). Μπορεί να προσδιοριστεί αργότερα κατά τη χρήση του token για κάποια αγορά.

Ανάκτηση Token κάρτας.

Ερώτημα (query) για ένα Token κάρτας που έχει ήδη δημιουργηθεί όπως παραπάνω.

curl https://api.everypay.gr/tokens/ctn_zUOwAdOqWe9BjQ86dYTWr13I 
    -u pk_atFzbY3VB94gFFJ3FxArEWM8DpnuA1y8:
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Token;

Everypay::setApiKey('pk_atFzbY3VB94gFFJ3FxArEWM8DpnuA1y8');

$token_id = 'ctn_zUOwAdOqWe9BjQ86dYTWr13I';

$token = Token::retrieve($token_id);

Απάντηση σε JSON

{
    "token": "ctn_zUOwAdOqWe9BjQ86dYTWr13I",
    "is_used": false,
    "has_expired": false,  
    "amount": 1099,
    "date_created": "2015-07-24T16:36:39+0300",
    "card": {
        "expiration_month": "05",
        "expiration_year": "2016",
        "last_four": "4242",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "max_installments": 0
    }
}
<?php
stdClass Object
(
    [token] => ctn_zUOwAdOqWe9BjQ86dYTWr13I
    [is_used] => 
    [has_expired] => 
    [amount] => 1099
    [date_created] => 2015-07-24T16:36:39+0300
    [card] => stdClass Object
        (
            [expiration_month] => 05
            [expiration_year] => 2016
            [last_four] => 4242
            [type] => Visa
            [holder_name] => John Doe
            [supports_installments] => 
            [max_installments] => 0
        )

)
   
URL https://api.everypay.gr/tokens/{TOKEN_ID}
Μέθοδος GET
Περιγραφή Επιστρέφει τις πληροφορίες για ένα δεδομένο Token.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
PUBLIC KEY Ναι string(35) Το δημόσιο κλειδί (ή το ιδιωτικό) δίνεται σαν username για HTTP πρόσβαση.
{TOKEN_ID} Ναι string(28) To id του token το οποίο μας ενδιαφέρει, μεταδίδεται απευθείας από τη διεύθυνση URL .

Τα πεδία του αντικειμένου Token

Πεδίο Τύπος Περιγραφή
token string(28) To μοναδικό αναγνωριστικό (ID) του Token.
is_used true / false Δείκτης αν το Token αυτό έχει χρησιμοποιηθεί στο παρελθόν.
has_expired true / false Δείκτης αν το Token αυτό έχει ξεπεράσει το χρόνο ζωής του. Τα Tokens που τον έχουν ξεπεράσει δεν μπορούν να χρησιμοποιηθούν.
amount integer Το ποσό της χρέωσης σε cents (χωρίς σημεία στίξης π.χ. 1099 αντί 10,99).
date_created string(255) Ημερομηνία δημιουργίας του Token.
card json Ένα αντικείμενο κάρτας (βλ.παρακάτω).

Τα πεδία του αντικειμένου κάρτας

Πεδίο Τύπος Περιγραφή
expiration_month string(2) Μήνας λήξης της κάρτας.
expiration_year string(4) Έτος λήξης της κάρτας.
last_four string(4) Τα τελευταία 4 ψηφία της κάρτας.
type string(255) Ο τύπος της κάρτας: “Visa”, “Mastercard” κλπ.
holder_name string(255) Το όνομα κατόχου της κάρτας.
supports_installments boolean Το αν υποστηρίζει ή όχι δόσεις η συγκεκριμένη κάρτα.
max_installments integer Ο μέγιστος αριθμός των δόσεων που υποστηρίζει η συγκεκριμένη κάρτα. Αν δεν υποστηρίζει καθόλου δόσεις ο αριθμός είναι 0.

Πελάτες

Το αντικείμενο Πελάτη μπορεί να χρησιμοποιηθεί για περιπτώσεις που απαιτούν αυτοματοποιημένη τιμολόγηση (π.χ. συνδρομή), χωρίς να χρειάζεται να αποθηκεύετε ευαίσθητα δεδομένα στον server της εφαρμογής σας. Δημιουργώντας ένα τέτοιο αντικείμενο θα μπορείτε να εκτελείτε τις συναλλαγές μεταδίδοντας στην υπηρεσία μας μόνο το Token του πελάτη.

Δημιουργία Πελάτη με στοιχεία κάρτας

Δημιουργία Πελάτη με τα στοιχεία της κάρτας και το ιδιωτικό κλειδί.

curl https://api.everypay.gr/customers 
 -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
 -d card_number=4242424242424242 
 -d expiration_year=2016 
 -d expiration_month=05 
 -d email='cofounder@themail.com' 
 -d cvv=334 
 -d holder_name="John Doe" 
 -d description="Club Member" 
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Customer;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'card_number' => '4242424242424242',
    'expiration_year' => '2016',
    'expiration_month' => '05',
    'email' => 'cofounder@themail.com',
    'cvv' => '334',
    'holder_name' => 'John Doe',
    'description' => 'Club Member'
);

$customer = Customer::create($params);

Απάντηση σε JSON για curl ή Object για php

{
    "description": "Club Member",
    "email": "cofounder@themail.com",
    "date_created": "2015-07-28T10:51:12+0300",
    "full_name": null,
    "token": "cus_uVMLP6Ud06CkK3ZglkhHw7IH",
    "is_active": true,
    "date_modified": "2015-07-28T10:51:12+0300",
    "card": {
        "expiration_month": "05",
        "expiration_year": "2016",
        "last_four": "4242",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "max_installments": 0
    }
}
<?php
stdClass Object
(
    [description] => Club Member
    [email] => cofounder@themail.com
    [date_created] => 2015-07-28T10:51:12+0300
    [full_name] => 
    [token] => cus_uVMLP6Ud06CkK3ZglkhHw7IH
    [is_active] => 1
    [date_modified] => 2015-07-28T10:51:12+0300
    [card] => stdClass Object
        (
            [expiration_month] => 05
            [expiration_year] => 2016
            [last_four] => 4242
            [type] => Visa
            [holder_name] => John Doe
            [supports_installments] => 
            [max_installments] => 0
        )
)
   
URL https://api.everypay.gr/customers
Μέθοδος POST
Περιγραφή Δημιουργεί ένα νέο αντικείμενο Πελάτη, συσχετισμένο με ορισμένες πληροφορίες (συμπεριλαμβανομένων των στοιχείων κάρτας). To αντικείμενο αυτό και όλες οι επόμενες κινήσεις του, θα είναι συνδεδεμένο με την εταιρεία της οποίας χρησιμοποιούμε το Ιδωτικό κλειδί.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
card_number Ναι integer(16) O αριθμός της κάρτας.
holder_name Ναι string(255) To όνομα κατόχου της κάρτας.
expiration_year Ναι integer(4) Έτος λήξης της κάρτας (4 ψηφία).
expiration_month Ναι integer(2) Μήνας λήξης της κάρτας (2 ψηφία).
cvv Ναι integer(3) Ο τριψήφιος κωδικός ασφαλείας στο πίσω μέρος της κάρτας.
description Όχι string(255) Μία σύντομη περιγραφή.
email Όχι string(100) H διεύθυνση email του πελάτη.
full_name Όχι string(255) Το όνομα του πελάτη.

Δημιουργία Πελάτη με χρήση Token

Δημιουργία Πελάτη με χρήση Token και το ιδιωτικό κλειδί.

curl https://api.everypay.gr/customers   
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:   
  -d token=ctn_zUOwAdOqWe9BjQ86dYTWr13I  
  -d full_name="Smith Hill Co"
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Customer;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'token' => 'ctn_zUOwAdOqWe9BjQ86dYTWr13I',
    'full_name' => 'Smith Hill Co'
);

$customer = Customer::create($params);

Απάντηση σε JSON για curl ή Object για php

{
    "description": null,
    "email": null,
    "date_created": "2015-07-28T11:19:55+0300",
    "full_name": "Smith Hill Co",
    "token": "cus_b7QO01Ie4csrDAkRjXijK7aM",
    "is_active": true,
    "date_modified": "2015-07-28T11:19:55+0300",
    "card": {
        "expiration_month": "05",
        "expiration_year": "2016",
        "last_four": "4242",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "max_installments": 0
    }
}
<?php
stdClass Object
(
    [description] => 
    [email] => 
    [date_created] => 2015-07-28T11:19:55+0300
    [full_name] => Smith Hill Co
    [token] => cus_b7QO01Ie4csrDAkRjXijK7aM
    [is_active] => 1
    [date_modified] => 2015-07-28T11:19:55+0300
    [card] => stdClass Object
        (
            [expiration_month] => 05
            [expiration_year] => 2016
            [last_four] => 4242
            [type] => Visa
            [holder_name] => John Doe
            [supports_installments] => 
            [max_installments] => 0
        )
)
   
URL https://api.everypay.gr/customers
Μέθοδος POST
Περιγραφή Δημιουργεί ένα νέο αντικείμενο Πελάτη όπως παραπάνω, με τη διαφορά οτι τα στοιχεία της κάρτας δίνονται μέσω ενός προδημιουργημένου Token κάρτας (βλ. παραπάνω).

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
token Ναι string(28) To Token (αχρησιμοποίητο) που έχουμε δημιουργήσει για μία κάρτα.
description Όχι string(255) Μία σύντομη περιγραφή.
full_name Όχι string(255) Το όνομα του πελάτη.
email Όχι string(100) H διεύθυνση email του πελάτη.

Δημιουργία Πελάτη μέσω επιτυχής συναλλαγής.

Δημιουργία Πελάτη μέσω επιτυχής συναλλαγής.

curl https://api.everypay.gr/payments
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -d card_number=4111111111111111
  -d expiration_year=2016
  -d expiration_month=01
  -d cvv=334
  -d amount=100
  -d currency=eur
  -d description="Order #GGA-435167"
  -d holder_name="John Doe"
  -d create_customer="1"
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'card_number' => '4111111111111111',
    'expiration_year' => '2016',
    'expiration_month' => '01',
    'cvv' => '334',
    'amount' => 100,
    'currency' => 'eur',
    'description' => 'Order #GGA-435167',
    'holder_name' => 'John Doe',
    'create_customer' => '1'
);

$payment = Payment::create($params);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "pmt_RyIwmVA2r8T3UMcMIvKcbxGE"
    "date_created": "2015-08-21T17:57:02+0300",
    "description": "Order #GGA-435167",
    "currency": "EUR",
    "status": "Captured",
    "amount": 100,
    "refund_amount": 0,
    "fee_amount": 22,
    "payee_email": null,
    "payee_phone": null,
    "refunded": false,
    "refunds": [],
    "customer": {
        "card": {
            "expiration_month": "01",
            "expiration_year": "2016",
            "holder_name": "John Doe",
            "last_four": "1111",
            "type": "Visa",
            "supports_installments": false,
            "max_installments": 0
        },
        "date_created": "2015-08-21T17:57:02+0300",
        "date_modified": "2015-08-21T17:57:02+0300",
        "description": null,
        "email": null,
        "full_name": "John Doe",
        "is_active": true,
        "token": "cus_Hdv4aPIwIFfRh5Bo609HiaDo"
    }
}
<?php

stdClass Object
(
    [token] => pmt_RyIwmVA2r8T3UMcMIvKcbxGE
    [date_created] => 2015-08-21T17:57:02+0300
    [description] => Order #GGA-435167
    [currency] => EUR
    [status] => Captured
    [amount] => 100
    [refund_amount] => 0
    [fee_amount] => 22
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 
    [refunds] => Array
        (
        )

    [customer] => stdClass Object
        (
            [description] => 
            [email] => 
            [date_created] => 2015-08-21T17:57:02+0300
            [full_name] => John Doe
            [token] => cus_Hdv4aPIwIFfRh5Bo609HiaDo
            [is_active] => 1
            [date_modified] => 2015-08-21T17:57:02+0300
            [card] => stdClass Object
                (
                    [expiration_month] => 01
                    [expiration_year] => 2016
                    [last_four] => 1111
                    [type] => Visa
                    [holder_name] => John Doe
                    [supports_installments] => 
                    [max_installments] => 0
                )

        )

)

Η δημιουργία Πελάτη μπορεί να γίνει τόσο απο επιτυχή πληρωμή όσο και απο πρέγκριση μιας πληρωμής.

   
URL https://api.everypay.gr/payments
Μέθοδος POST
Περιγραφή Εκτελεί χρέωση χρησιμοποιώντας τα δηλωθέντα στοιχεία μιας κάρτας και ταυτόχρονη δημιουργία Πελάτη.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
card_number Ναι integer(16) O αριθμός της κάρτας.
holder_name Ναι string(255) To όνομα κατόχου της κάρτας.
expiration_year Ναι integer(4) Έτος λήξης της κάρτας (4 ψηφία).
expiration_month Ναι integer(2) Μήνας λήξης της κάρτας (2 ψηφία).
cvv Ναι integer(3) Ο τριψήφιος κωδικός ασφαλείας στο πίσω μέρος της κάρτας.
amount Ναι integer Το ποσό της συναλλαγής σε cents (χωρίς σημεία στίξης π.χ. 1099 αντί 10,99).
description Όχι string(255) Μία σύντομη περιγραφή.
currency Όχι string(3) Το νόμισμα της συναλλαγής (EUR)
create_customer Όχι integer(1) Αν θα πρέπει να δημιουργηθεί Πελάτης (1) ή όχι (0)

Τα πεδία του αντικειμένου Πελάτη

Πεδίο Τύπος Περιγραφή
description string(255) / null Η περιγραφή του πελάτη.
email string(100) / null To email του πελάτη.
date_created string(255) Η ημερομηνία δημιουργίας του πελάτη.
full_name string(255) Το όνομα του πελάτη.
token string(35) Το μοναδικό αναγνωριστικό (ID) του πελάτη.
is_active true / false Δείκτης εάν ο πελάτης είναι ενεργός.
date_modified string(255) Η ημερομηνία στην οποία άλλαξαν τελευταία φορά κάποια στοιχεία του πελάτη.
card json Ένα αντικείμενο κάρτας (βλ.παραπάνω) συσχετισμένο με τον πελάτη.

Ανάκτηση πελάτη

Ερώτημα (query) για έναν Πελάτη

curl https://api.everypay.gr/customers/cus_b7QO01Ie4csrDAkRjXijK7aM 
    -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Customer;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$token = 'cus_b7QO01Ie4csrDAkRjXijK7aM';

$customer = Customer::retrieve($token);

Απάντηση σε JSON για curl ή Object για php

{
    "description": null,
    "email": null,
    "date_created": "2015-07-28T11:19:55+0300",
    "full_name": "Smith Hill Co",
    "token": "cus_b7QO01Ie4csrDAkRjXijK7aM",
    "is_active": true,
    "date_modified": "2015-07-28T11:19:55+0300",
    "card": {
        "expiration_month": "05",
        "expiration_year": "2016",
        "last_four": "4242",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "max_installments": 0
    }
}
<?php
stdClass Object
(
    [description] => 
    [email] => 
    [date_created] => 2015-07-28T11:19:55+0300
    [full_name] => Smith Hill Co
    [token] => cus_b7QO01Ie4csrDAkRjXijK7aM
    [is_active] => 1
    [date_modified] => 2015-07-28T11:19:55+0300
    [card] => stdClass Object
        (
            [expiration_month] => 05
            [expiration_year] => 2016
            [last_four] => 4242
            [type] => Visa
            [holder_name] => John Doe
            [supports_installments] => 
            [max_installments] => 0
        )
)
   
URL https://api.everypay.gr/customers/{CUSTOMER_ID}
Μέθοδος GET
Περιγραφή Επιστρέφει τις πληροφορίες για το αντικείμενο του πελάτη.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
{CUSTOMER_ID} Ναι string(28) To id του πελάτη μεταδίδεται απευθείας από τη διεύθυνση URL.

Επεξεργασία Πελάτη

Επεξεργασία (ενημέρωση στοιχείων) πελάτη

curl https://api.everypay.gr/customers/cus_b7QO01Ie4csrDAkRjXijK7aM  
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -X PUT
  -d email="johnDoe@gmail.com"
  -d description="Fitch LiSP customer"
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Customer;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$token = 'cus_b7QO01Ie4csrDAkRjXijK7aM';

$params = array(
    'email' => 'johnDoe@gmail.com',
    'description' => 'Fitch LiSP customer'
);

$customer = Customer::update($token, $params);

Απάντηση σε JSON για curl ή Object για php

{
    "description": "Fitch LiSP customer",
    "email": "johnDoe@gmail.com",
    "date_created": "2015-07-28T11:19:55+0300",
    "full_name": "Smith Hill Co",
    "token": "cus_b7QO01Ie4csrDAkRjXijK7aM",
    "is_active": true,
    "date_modified": "2015-07-30T08:00:12+0300",
    "card": {
        "expiration_month": "05",
        "expiration_year": "2016",
        "last_four": "4242",
        "type": "Visa",
        "holder_name": John Doe,
        "supports_installments": false,
        "max_installments": 0
    }
}
<?php
stdClass Object
(
    [description] => Fitch LiSP customer
    [email] => johnDoe@gmail.com
    [date_created] => 2015-07-28T11:19:55+0300
    [full_name] => Smith Hill Co
    [token] => cus_b7QO01Ie4csrDAkRjXijK7aM
    [is_active] => 1
    [date_modified] => 2015-07-30T08:00:12+0300
    [card] => stdClass Object
        (
            [expiration_month] => 05
            [expiration_year] => 2016
            [last_four] => 4242
            [type] => Visa
            [holder_name] => John Doe
            [supports_installments] => 
            [max_installments] => 0
        )

)
   
URL https://api.everypay.gr/customers/{CUSTOMER_ID}
Μέθοδος PUT
Περιγραφή Επεξεργασία των στοιχείων ενός πελάτη.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
card_number Όχι integer(16) O αριθμός της κάρτας.
holder_name Όχι / Ναι string(255) To όνομα κατόχου της κάρτας. Υποχρεωτικό στην περίπτωση που αλλάζετε και το card_number
expiration_year Όχι / Ναι integer(4) Έτος λήξης της κάρτας (4 ψηφία). Υποχρεωτικό στην περίπτωση που αλλάζετε και το card_number.
expiration_month Όχι / Ναι integer(2) Μήνας λήξης της κάρτας (2 ψηφία). Υποχρεωτικό στην περίπτωση που αλλάζετε και το card_number.
cvv Όχι / Ναι integer(3) Ο τριψήφιος κωδικός ασφαλείας στο πίσω μέρος της κάρτας. Υποχρεωτικό στην περίπτωση που αλλάζετε και το card_number.
description Όχι string(255) Μία σύντομη περιγραφή.
full_name Όχι string(255) Το όνομα του πελάτη.
email Όχι string(100) H διεύθυνση email του πελάτη.
{CUSTOMER_ID} Ναι string(28) To id του πελάτη μεταδίδεται απευθείας από τη διεύθυνση URL.

Διαγραφή Πελάτη

Διαγραφή Πελάτη

curl https://api.everypay.gr/customers/cus_b7QO01Ie4csrDAkRjXijK7aM
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -X DELETE
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Customer;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$token = 'cus_b7QO01Ie4csrDAkRjXijK7aM';

$customer = Customer::delete($token);

Απάντηση σε JSON για curl ή Object για php

{
    "description": "Fitch LiSP customer",
    "email": "johnDoe@gmail.com",
    "date_created": "2015-07-28T11:19:55+0300",
    "full_name": "Smith Hill Co",
    "token": "cus_b7QO01Ie4csrDAkRjXijK7aM",
    "is_active": false,
    "date_modified": "2015-07-31T10:35:47+0300"
}
stdClass Object
(
    [description] => Fitch LiSP customer
    [email] => johnDoe@gmail.com
    [date_created] => 2015-07-28T11:19:55+0300
    [full_name] => Smith Hill Co
    [token] => cus_b7QO01Ie4csrDAkRjXijK7aM
    [is_active] => 
    [date_modified] => 2015-07-31T10:35:47+0300
)
   
URL https://api.everypay.gr/customers/{CUSTOMER_ID}
Μέθοδος DELETE
Περιγραφή Διαγραφή ενός αντικειμένου πελάτη. Λόγω θεμάτων ασφαλείας, το αντικείμενο ποτέ δεν διαγράφεται πραγματικά, αλλά γίνεται μόνιμα ανενεργό. Η διαδικασία αυτή είναι ΜΗ αναστρέψιμη.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
{CUSTOMER_ID} Ναι string(28) To id του πελάτη μεταδίδεται απευθείας από τη διεύθυνση URL.

Λίστα Πελατών

Λίστα Πελατών

curl https://api.everypay.gr/customers?count=2&offset=1
  -X GET
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Customer;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'count' => 2,
    'offset' => 1
);

$customer = Customer::listAll($params);

Απάντηση σε JSON για curl ή Object για php

Εδώ υπάρχουν 6 πελάτες στη βάση δεδομένων αλλά ζητάμε να δούμε μόνο τους 2.

{
    "total_count": 6,
    "items": [
        {
            "description": "Fitch LiSP customer",
            "email": "johnDoe@gmail.com",
            "date_created": "2015-07-28T11:19:55+0300",
            "full_name": "Smith Hill Co",
            "token": "cus_b7QO01Ie4csrDAkRjXijK7aM",
            "is_active": true,
            "date_modified": "2015-07-30T08:00:12+0300",
            "card": {
                "expiration_month": "05",
                "expiration_year": "2016",
                "last_four": "4242",
                "type": "Visa",
                "holder_name": "John Doe",
                "supports_installments": false,
                "max_installments": 0
            }
        },
        {
            "description": "Πελάτης 1",
            "email": null,
            "date_created": "2010-07-28T11:19:55+0300",
            "full_name": "Paul Graham",
            "token": "cus_17c4307c02a73f39df4f10c0",
            "is_active": true,
            "date_modified": "2010-07-28T11:19:55+0300",
            "card": {
                "expiration_month": "01",
                "expiration_year": "2016",
                "last_four": "1111",
                "type": "Visa",
                "holder_name": null,
                "supports_installments": false,
                "max_installments": 0
            }
        }
    ]
}
<?php
stdClass Object
(
    [total_count] => 6
    [items] => Array
        (
            [0] => stdClass Object
                (
                    [description] => Fitch LiSP customer
                    [email] => johnDoe@gmail.com
                    [date_created] => 2015-07-28T11:19:55+0300
                    [full_name] => Smith Hill Co
                    [token] => cus_b7QO01Ie4csrDAkRjXijK7aM
                    [is_active] => 1
                    [date_modified] => 2015-07-30T08:00:12+0300
                    [card] => stdClass Object
                        (
                            [expiration_month] => 05
                            [expiration_year] => 2016
                            [last_four] => 4242
                            [type] => Visa
                            [holder_name] => John Doe
                            [supports_installments] => 
                            [max_installments] => 0
                        )

                )

            [1] => stdClass Object
                    (
                        [description] => Πελάτης 1
                        [email] => 
                        [date_created] => 2010-07-28T11:19:55+0300
                        [full_name] => Paul Graham
                        [token] => cus_17c4307c02a73f39df4f10c0
                        [is_active] => 1
                        [date_modified] => 2010-07-28T11:19:55+0300
                        [card] => stdClass Object
                            (
                                [expiration_month] => 01
                                [expiration_year] => 2016
                                [last_four] => 1111
                                [type] => Visa
                                [holder_name] =>
                                [supports_installments] => 
                                [max_installments] => 0
                            )

                    )

        )

)
   
URL https://api.everypay.gr/customers/?count={int1}&offset={int2}&date_from={timestamp1}&date_to={timestamp2}
Μέθοδος GET
Περιγραφή Προβολή όλων των διαθέσιμων πελατών. Τα αντικείμενα προβάλλονται ταξινομημένα σύμφωνα με την ημερομηνία δημιουργίας, με πρώτο να εμφανίζεται το πιο πρόσφατα δημιουργημένο.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
count Όχι integer(4) O αριθμός των εμφανιζόμενων αποτελεσμάτων. Δίνεται σαν παράμετρος στη διέυθυνση URL. Εάν δεν ορισθεί τότε λαμβάνεται η προκαθορισμένη τιμή που είναι 10. Ανώτερη τιμή είναι το 20.
offset Όχι integer(4) Ο αριθμός των πελατών μετά τους οποίους θα εμφανιστούν τα αποτελέσματα π.χ. για τους πελάτες που βρίσκονται από τη θέση 10 και μετά δηλώνουμε offset=9. Δίνεται σαν παράμετρος στη διέυθυνση URL. Η προκαθορισμένη τιμή είναι 0.
date_from Όχι timestamp (integer) H ημερομηνία πέραν της οποίας ζητάμε τους πελάτες π.χ. για πελάτες που δημιουργήθηκαν μετά από τις 01/10/2013 00:00:00, δίνουμε date_from=1380585600. Δίνεται σαν παράμετρος στη διεύθυνση URL.
date_to Όχι timestamp (integer) H ημερομηνία μέχρι την οποία ζητάμε τους πελάτες π.χ. για πελάτες που δημιουργήθηκαν πριν από τις 01/10/2013 00:00:00, δίνουμε date_to=1380585600. Δίνεται σαν παράμετρος στη διεύθυνση URL.

Πληρωμές

Οι Πληρωμές είναι κινήσεις χρέωσης καρτών. Μπορούν να γίνουν χρησιμοποιώντας τα στοιχεία μιας κάρτας, κάποιο προδημιουργημένο Token ή κάποιο αντικείμενο <

Πληρωμή με χρέωση Κάρτας

Πληρωμή με χρέωση κάρτας, με το ιδιωτικό κλειδί.

curl https://api.everypay.gr/payments
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -d card_number=4111111111111111  
  -d expiration_year=2016
  -d expiration_month=01
  -d cvv=334
  -d amount=1099
  -d currency=eur
  -d description="Order #GGA-435167"
  -d holder_name="John Doe"
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'card_number' => '4111111111111111',
    'expiration_year' => '2016',
    'expiration_month' => '01',
    'cvv' => '334',
    'amount' => 1099,
    'currency' => 'eur',
    'description' => 'Order #GGA-435167',
    'holder_name'=>'John Doe'
);

$payment = Payment::create($params);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "pmt_A71tLD12bKumsd8v3rv9BNsY",
    "date_created": "2015-08-11T11:48:15+0300",
    "description": "Order #GGA-435167",
    "currency": "EUR",
    "status": "Captured",
    "amount": 1099,
    "refund_amount": 0,
    "fee_amount": 34,
    "payee_email": null,
    "payee_phone": null,
    "refunded": false,
    "refunds": [],
    "installments_count": 0,
    "installments": [],
    "card": {
        "expiration_month": "01",
        "expiration_year": "2016",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "max_installments": 0
    }
}
<?php
stdClass Object
(
    [token] => pmt_A71tLD12bKumsd8v3rv9BNsY
    [date_created] => 2015-08-11T11:48:15+0300
    [description] => Order #GGA-435167
    [currency] => EUR
    [status] => Captured
    [amount] => 1099
    [refund_amount] => 0
    [fee_amount] => 34
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 
    [refunds] => Array
        (
        )

    [installments_count] => 0
    [installments] => Array
        (
        )

    [card] => stdClass Object
        (
            [expiration_month] => 01
            [expiration_year] => 2016
            [last_four] => 1111
            [type] => Visa
            [holder_name] => John Doe
            [supports_installments] =>
            [max_installments] => 0
        )

)

Πληρωμή με χρέωση κάρτας και δόσεις, με το ιδιωτικό κλειδί.

Εδώ ο πελάτης αιτείται το μέγιστο των δόσεων που υποστηρίζει η κάρτα του, δηλαδή 3. Θα μπορούσε να αιτειθεί από 0 έως 3.

curl https://api.everypay.gr/payments
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -d card_number=4908440000000003  
  -d expiration_year=2016
  -d expiration_month=08
  -d cvv=123
  -d amount=10480
  -d currency=eur
  -d description="Order #A-770"
  -d holder_name="John Doe"
  -d installments=3
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'card_number' => '4908440000000003',
    'expiration_year' => '2016',
    'expiration_month' => '08',
    'cvv' => '123',
    'amount' => 10480,
    'currency' => 'eur',
    'description' => 'Order #A-770',
    'holder_name'=>'John Doe',
    'installments' => '3'
);

$payment = Payment::create($params);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "pmt_DdEFKTO2lhRZjIpgMcJqj899",
    "date_created": "2015-10-05T17:37:41+0300",
    "description": "Order #A-770",
    "currency": "EUR",
    "status": "Captured",
    "amount": 10480,
    "refund_amount": 0,
    "fee_amount": 312,
    "payee_email": null,
    "payee_phone": null,
    "refunded": false,
    "refunds": [],
    "installments_count": 3,
    "installments": [
        {
            "token": "pmt_VFDPv5oBSq3ulnlamgKFSSaM",
            "date_created": "2015-10-05T17:37:41+0300",
            "due_date": "2015-10-06T21:00:00+0300",
            "currency": "EUR",
            "status": "Pending installment",
            "amount": 3500,
            "fee_amount": 104
        },
        {
            "token": "pmt_GMFBFJ2z7EVhtN7HgmbVag6k",
            "date_created": "2015-10-05T17:37:41+0300",
            "due_date": "2015-11-05T21:00:00+0200",
            "currency": "EUR",
            "status": "Pending installment",
            "amount": 3500,
            "fee_amount": 104
        },
        {
            "token": "pmt_ynvYNpYn5mn9VARuwB4ZbVXY",
            "date_created": "2015-10-05T17:37:41+0300",
            "due_date": "2015-12-07T21:00:00+0200",
            "currency": "EUR",
            "status": "Pending installment",
            "amount": 3480,
            "fee_amount": 104
        }
    ],
    "card": {
        "expiration_month": "08",
        "expiration_year": "2016",
        "last_four": "0003",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": true,
        "max_installments": 3
    }
}
<?php
stdClass Object
(
    [token] => pmt_DdEFKTO2lhRZjIpgMcJqj899
    [date_created] => 2015-10-05T17:37:41+0300
    [description] => Order #A-770
    [currency] => EUR
    [status] => Captured
    [amount] => 10480
    [refund_amount] => 0
    [fee_amount] => 312
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 
    [refunds] => Array
        (
        )

    [installments_count] => 3
    [installments] => Array
        (
            [0] => stdClass Object
                (
                    [token] => pmt_VFDPv5oBSq3ulnlamgKFSSaM
                    [date_created] => 2015-10-05T17:37:41+0300
                    [due_date] => 2015-10-06T21:00:00+0300
                    [currency] => EUR
                    [status] => Pending installment
                    [amount] => 3500
                    [fee_amount] => 104
                )

            [1] => stdClass Object
                (
                    [token] => pmt_GMFBFJ2z7EVhtN7HgmbVag6k
                    [date_created] => 2015-10-05T17:37:41+0300
                    [due_date] => 2015-11-05T21:00:00+0200
                    [currency] => EUR
                    [status] => Pending installment
                    [amount] => 3500
                    [fee_amount] => 104
                )

            [2] => stdClass Object
                (
                    [token] => pmt_ynvYNpYn5mn9VARuwB4ZbVXY
                    [date_created] => 2015-10-05T17:37:41+0300
                    [due_date] => 2015-12-07T21:00:00+0200
                    [currency] => EUR
                    [status] => Pending installment
                    [amount] => 3480
                    [fee_amount] => 104
                )

        )

    [card] => stdClass Object
        (
            [expiration_month] => 08
            [expiration_year] => 2016
            [last_four] => 0003
            [type] => Visa
            [holder_name] => John Doe
            [supports_installments] => 1
            [max_installments] => 3
        )

)
   
URL https://api.everypay.gr/payments
Μέθοδος POST
Περιγραφή Εκτελεί χρέωση χρησιμοποιώντας τα δηλωθέντα στοιχεία μιας κάρτας.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
card_number Ναι integer(16) O αριθμός της κάρτας.
holder_name Ναι string(255) To όνομα κατόχου της κάρτας.
expiration_year Ναι integer(4) Έτος λήξης της κάρτας (4 ψηφία).
expiration_month Ναι integer(2) Μήνας λήξης της κάρτας (2 ψηφία).
cvv Ναι integer(3) Ο τριψήφιος κωδικός ασφαλείας στο πίσω μέρος της κάρτας.
amount Ναι integer Το ποσό της συναλλαγής σε cents (χωρίς σημεία στίξης π.χ. 1099 αντί 10,99).
currency Όχι string(3) Το νόμισμα της συναλλαγής (EUR)
description Όχι string(255) Μία σύντομη περιγραφή.
installments Όχι integer Ο αριθμός των δόσεων που αιτείται ο ιδιοκτήτης της κάρτας.

Πληρωμή με χρέωση Πελάτη

Πληρωμή με χρέωση Πελάτη, με το ιδιωτικό κλειδί.

curl https://api.everypay.gr/payments
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -d token=cus_uVMLP6Ud06CkK3ZglkhHw7IH
  -d description="Order #HLA-66632"
  -d amount=1099
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'token' => 'cus_uVMLP6Ud06CkK3ZglkhHw7IH',
    'description' => 'Order #HLA-66632',
    'amount' => 1099
);

$payment = Payment::create($params);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "pmt_jK0UUQz60ruAWApeHlInVo6E",
    "date_created": "2015-08-11T12:51:06+0300",
    "description": "Order #HLA-66632",
    "currency": "EUR",
    "status": "Captured",
    "amount": 1099,
    "refund_amount": 0,
    "fee_amount": 34,
    "payee_email": null,
    "payee_phone": null,
    "refunded": false,
    "refunds": [],
    "installments_count": 0,
    "installments": [],
    "customer": {
        "description": "Club Member",
        "email": "cofounder@themail.com",
        "date_created": "2015-07-28T10:51:12+0300",
        "full_name": null,
        "token": "cus_uVMLP6Ud06CkK3ZglkhHw7IH",
        "is_active": true,
        "date_modified": "2015-07-28T10:51:12+0300",
        "card": {
            "expiration_month": "05",
            "expiration_year": "2016",
            "last_four": "4242",
            "type": "Visa",
            "holder_name": "John Doe",
            "supports_installments": false,
            "max_installments": 0
        }
    }
}
<?php
stdClass Object
(
    [token] => pmt_jK0UUQz60ruAWApeHlInVo6E
    [date_created] => 2015-08-11T12:51:06+0300
    [description] => Order #HLA-66632
    [currency] => EUR
    [status] => Captured
    [amount] => 1099
    [refund_amount] => 0
    [fee_amount] => 34
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 
    [refunds] => Array
        (
        )

    [installments_count] => 0
    [installments] => Array
        (
        )

    [customer] => stdClass Object
        (
            [description] => Club Member
            [email] => cofounder@themail.com
            [date_created] => 2015-07-28T10:51:12+0300
            [full_name] => 
            [token] => cus_uVMLP6Ud06CkK3ZglkhHw7IH
            [is_active] => 1
            [date_modified] => 2015-07-28T10:51:12+0300
            [card] => stdClass Object
                (
                    [expiration_month] => 05
                    [expiration_year] => 2016
                    [last_four] => 4242
                    [type] => Visa
                    [holder_name] => John Doe
                    [supports_installments] =>
                    [max_installments] => 0
                )

        )
)

Πληρωμή με χρέωση Πελάτη με δόσεις, με το ιδιωτικό κλειδί.

Εδώ ο πελάτης αιτείται 2 δόσεις ενώ η κάρτα του υποστηρίζει περισσότερες.

To Token Πελάτη που χρησιμοποιείται εδώ είχε δημιουργηθεί με παλαιότερη αίτηση (με το ιδιωτικό κλειδί του έμπορου) χωρίς προσδιορισμό τιμής.

Στην παρούσα αίτηση προσδιορίζεται το ποσό των 98,00 €.

curl https://api.everypay.gr/payments
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -d token=cus_4nAug8BIZYs8fNceh4TfFDTl
  -d amount=9800
  -d installments=2
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'token' => 'cus_4nAug8BIZYs8fNceh4TfFDTl',
    'amount' => 9800,
    'installments' => 2
);

$payment = Payment::create($params);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "pmt_AyFdxVkVNldLZAgiR9lpyMV4",
    "date_created": "2015-10-08T18:21:39+0300",
    "description": null,
    "currency": "EUR",
    "status": "Captured",
    "amount": 9800,
    "refund_amount": 0,
    "fee_amount": 276,
    "payee_email": null,
    "payee_phone": null,
    "refunded": false,
    "refunds": [],
    "installments_count": 2,
    "installments": [
        {
            "token": "pmt_rEHLTxJ5ndux6SaLV7rdOuLO",
            "date_created": "2015-10-08T18:21:39+0300",
            "due_date": "2015-10-09T21:00:00+0300",
            "currency": "EUR",
            "status": "Pending installment",
            "amount": 4900,
            "fee_amount": 138
        },
        {
            "token": "pmt_3I6xf438wr9SPGYToEMDXqLB",
            "date_created": "2015-10-08T18:21:39+0300",
            "due_date": "2015-11-09T21:00:00+0200",
            "currency": "EUR",
            "status": "Pending installment",
            "amount": 4900,
            "fee_amount": 138
        }
    ],
    "customer": {
        "description": "Club Member",
        "email": "cofounder@themail.com",
        "date_created": "2015-10-08T18:18:16+0300",
        "full_name": null,
        "token": "cus_4nAug8BIZYs8fNceh4TfFDTl",
        "is_active": true,
        "date_modified": "2015-10-08T18:21:39+0300",
        "card": {
            "expiration_month": "08",
            "expiration_year": "2016",
            "last_four": "0003",
            "type": "Visa",
            "holder_name": "John Doe",
            "supports_installments": true,
            "max_installments": 3
        }
    }
}

<?php
stdClass Object
(
    [token] => pmt_AyFdxVkVNldLZAgiR9lpyMV4
    [date_created] => 2015-10-08T18:21:39+0300
    [description] => 
    [currency] => EUR
    [status] => Captured
    [amount] => 9800
    [refund_amount] => 0
    [fee_amount] => 276
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 
    [refunds] => Array
        (
        )

    [installments_count] => 2
    [installments] => Array
        (
            [0] => stdClass Object
                (
                    [token] => pmt_rEHLTxJ5ndux6SaLV7rdOuLO
                    [date_created] => 2015-10-08T18:21:39+0300
                    [due_date] => 2015-10-09T21:00:00+0300
                    [currency] => EUR
                    [status] => Pending installment
                    [amount] => 4900
                    [fee_amount] => 138
                )

            [1] => stdClass Object
                (
                    [token] => pmt_3I6xf438wr9SPGYToEMDXqLB
                    [date_created] => 2015-10-08T18:21:39+0300
                    [due_date] => 2015-11-09T21:00:00+0200
                    [currency] => EUR
                    [status] => Pending installment
                    [amount] => 4900
                    [fee_amount] => 138
                )

        )

    [customer] => stdClass Object
        (
            [description] => Club Member
            [email] => cofounder@themail.com
            [date_created] => 2015-10-08T18:18:16+0300
            [full_name] => 
            [token] => cus_4nAug8BIZYs8fNceh4TfFDTl
            [is_active] => 1
            [date_modified] => 2015-10-08T18:21:39+0300
            [card] => stdClass Object
                (
                    [expiration_month] => 08
                    [expiration_year] => 2016
                    [last_four] => 0003
                    [type] => Visa
                    [holder_name] => John Doe
                    [supports_installments] => 1
                    [max_installments] => 3
                )

        )
)
   
URL https://api.everypay.gr/payments
Μέθοδος POST
Περιγραφή Εκτελεί χρέωση χρησιμοποιώντας ένα αντικείμενο Πελάτη.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
token Ναι string(28) Το id του πελάτη προς χρέωση.
amount Ναι integer Το ποσό της συναλλαγής σε cents (χωρίς σημεία στίξης π.χ. 1099 αντί 10,99).
currency Όχι string(3) Το νόμισμα της συναλλαγής (EUR)
description Όχι string(255) Μία σύντομη περιγραφή.
installments Όχι integer Ο αριθμός των δόσεων που αιτείται ο ιδιοκτήτης της κάρτας.

Πληρωμή με χρήση Token Κάρτας

Πληρωμή με χρήση Token Κάρτας, με το ιδιωτικό κλειδί.

curl https://api.everypay.gr/payments
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -d token=ctn_7hPmP8611pqcTkVfDuCEuC2Y
  -d amount=1099
  -d description="payment for item #21"
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'token' => 'ctn_7hPmP8611pqcTkVfDuCEuC2Y',
    'amount' => 1099,
    'description' => 'payment for item #21'
);

$payment = Payment::create($params);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "pmt_E5XVLCsdOHp8kfsTky6kIwwr",
    "date_created": "2015-08-11T14:13:09+0300",
    "description": "payment for item #21",
    "currency": "EUR",
    "status": "Captured",
    "amount": 1099,
    "refund_amount": 0,
    "fee_amount": 34,
    "payee_email": null,
    "payee_phone": null,
    "refunded": false,
    "refunds": [],
    "installments_count": 0,
    "installments": [],
    "card": {
        "expiration_month": "01",
        "expiration_year": "2016",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "max_installments": 0
    }
}
<?php
stdClass Object
(
    [token] => pmt_E5XVLCsdOHp8kfsTky6kIwwr
    [date_created] => 2015-08-11T14:13:09+0300
    [description] => payment for item #21
    [currency] => EUR
    [status] => Captured
    [amount] => 1099
    [refund_amount] => 0
    [fee_amount] => 34
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 
    [refunds] => Array
        (
        )

    [installments_count] => 0
    [installments] => Array
        (
        )

    [card] => stdClass Object
        (
            [expiration_month] => 01
            [expiration_year] => 2016
            [last_four] => 1111
            [type] => Visa
            [holder_name] => John Doe
            [supports_installments] =>
            [max_installments] => 0
        )

)

Πληρωμή με χρήση Token Κάρτας με δόσεις, με το ιδιωτικό κλειδί.

Εδώ ο πελάτης αιτείται 2 δόσεις ενώ η κάρτα του υποστηρίζει περισσότερες.

To Token Κάρτας που χρησιμοποιείται εδώ είχε δημιουργηθεί με παλαιότερη αίτηση (με το δημόσιο κλειδί του έμπορου) για ποσό 110,00 € και φυσικά δεν έχει ξαναχρησιμοποιηθεί.

curl https://api.everypay.gr/payments
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -d token=ctn_8gkrUnDBxWccqiUs5MQFeMqs
  -d installments=2
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'token' => 'ctn_8gkrUnDBxWccqiUs5MQFeMqs',
    'amount' => 11000,
    'installments' => 2
);

$payment = Payment::create($params);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "pmt_hRwmZ8lrxub8dEVTsWfla9c5",
    "date_created": "2015-10-08T17:01:21+0300",
    "description": null,
    "currency": "EUR",
    "status": "Captured",
    "amount": 11000,
    "refund_amount": 0,
    "fee_amount": 304,
    "payee_email": null,
    "payee_phone": null,
    "refunded": false,
    "refunds": [],
    "installments_count": 2,
    "installments": [
        {
            "token": "pmt_a39thWxpgOQ6oT9qfsnHmgMn",
            "date_created": "2015-10-08T17:01:21+0300",
            "due_date": "2015-10-09T21:00:00+0300",
            "currency": "EUR",
            "status": "Pending installment",
            "amount": 5500,
            "fee_amount": 152
        },
        {
            "token": "pmt_EJ4DmmSHP2hiCCiRgDtqOi3i",
            "date_created": "2015-10-08T17:01:21+0300",
            "due_date": "2015-11-09T21:00:00+0200",
            "currency": "EUR",
            "status": "Pending installment",
            "amount": 5500,
            "fee_amount": 152
        }
    ],
    "card": {
        "expiration_month": "08",
        "expiration_year": "2016",
        "last_four": "0003",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": true,
        "max_installments": 3
    }
}
<?php
stdClass Object
(
    [token] => pmt_hRwmZ8lrxub8dEVTsWfla9c5
    [date_created] => 2015-10-08T17:01:21+0300
    [description] => 
    [currency] => EUR
    [status] => Captured
    [amount] => 11000
    [refund_amount] => 0
    [fee_amount] => 304
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 
    [refunds] => Array
        (
        )

    [installments_count] => 2
    [installments] => Array
        (
            [0] => stdClass Object
                (
                    [token] => pmt_a39thWxpgOQ6oT9qfsnHmgMn
                    [date_created] => 2015-10-08T17:01:21+0300
                    [due_date] => 2015-10-09T21:00:00+0300
                    [currency] => EUR
                    [status] => Pending installment
                    [amount] => 5500
                    [fee_amount] => 152
                )

            [1] => stdClass Object
                (
                    [token] => pmt_EJ4DmmSHP2hiCCiRgDtqOi3i
                    [date_created] => 2015-10-08T17:01:21+0300
                    [due_date] => 2015-11-09T21:00:00+0200
                    [currency] => EUR
                    [status] => Pending installment
                    [amount] => 5500
                    [fee_amount] => 152
                )

        )

    [card] => stdClass Object
        (
            [expiration_month] => 08
            [expiration_year] => 2016
            [last_four] => 0003
            [type] => Visa
            [holder_name] => John Doe
            [supports_installments] => 1
            [max_installments] => 3
        )

)
   
URL https://api.everypay.gr/payments
Μέθοδος POST
Περιγραφή Εκτελεί χρέωση χρησιμοποιώντας ένα προδημιουργημένο και αχρησιμοποίητο Token κάρτας.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
token Ναι string(28) To id του token κάρτας το οποίο μας ενδιαφέρει.
amount Ναι integer Το ποσό της συναλλαγής σε cents (χωρίς σημεία στίξης π.χ. 1099 αντί 10,99).
currency Όχι string(3) Το νόμισμα της συναλλαγής (EUR)
description Όχι string(255) Μία σύντομη περιγραφή.
installments Όχι integer Ο αριθμός των δόσεων που αιτείται ο ιδιοκτήτης της κάρτας.

Πληρωμή και δημιουργία Πελάτη με χρέωση Κάρτας

Πληρωμή και δημιουργία Πελάτη με χρέωση κάρτας, με το ιδιωτικό κλειδί.

curl https://api.everypay.gr/payments
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -d card_number=4111111111111111  
  -d expiration_year=2016
  -d expiration_month=01
  -d cvv=334
  -d amount=1099
  -d currency=eur
  -d description="Order #400"
  -d holder_name="John Doe"
  -d create_customer=1
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'card_number' => '4111111111111111',
    'expiration_year' => '2016',
    'expiration_month' => '01',
    'cvv' => '334',
    'amount' => 1099,
    'currency' => 'eur',
    'description' => 'Order #400',
    'holder_name'=>'John Doe'
    'create_customer' => '1'
);

$payment = Payment::create($params);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "pmt_vd8rO6uDpnJ1MWWKyMU0gXp4",
    "date_created": "2015-11-05T12:38:04+0200",
    "description": "Order #400",
    "currency": "EUR",
    "status": "Captured",
    "amount": 1099,
    "refund_amount": 0,
    "fee_amount": 34,
    "payee_email": null,
    "payee_phone": null,
    "refunded": false,
    "refunds": [],
    "installments_count": 0,
    "installments": [],
    "customer": {
        "description": null,
        "email": null,
        "date_created": "2015-11-05T12:38:04+0200",
        "full_name": "John Doe",
        "token": "cus_qxVtpVXe1VrHdcEzSqaz9KwW",
        "is_active": true,
        "date_modified": "2015-11-05T12:38:04+0200",
        "card": {
            "expiration_month": "01",
            "expiration_year": "2016",
            "last_four": "1111",
            "type": "Visa",
            "holder_name": "John Doe",
            "supports_installments": false,
            "max_installments": 0
        }
    }
}
<?php
stdClass Object
(
    [token] => pmt_vd8rO6uDpnJ1MWWKyMU0gXp4
    [date_created] => 2015-11-05T12:38:04+0200
    [description] => Order #400
    [currency] => EUR
    [status] => Captured
    [amount] => 1099
    [refund_amount] => 0
    [fee_amount] => 34
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 
    [refunds] => Array
        (
        )

    [installments_count] => 0
    [installments] => Array
        (
        )

    [customer] => stdClass Object
        (
            [description] => 
            [email] => 
            [date_created] => 2015-11-05T12:38:04+0200
            [full_name] => John Doe
            [token] => cus_qxVtpVXe1VrHdcEzSqaz9KwW
            [is_active] => 1
            [date_modified] => 2015-11-05T12:38:04+0200
            [card] => stdClass Object
                (
                    [expiration_month] => 01
                    [expiration_year] => 2016
                    [last_four] => 1111
                    [type] => Visa
                    [holder_name] => John Doe
                    [supports_installments] => 
                    [max_installments] => 0
                )

        )

)

   
URL https://api.everypay.gr/payments
Μέθοδος POST
Περιγραφή Εκτελεί χρέωση χρησιμοποιώντας τα δηλωθέντα στοιχεία μιας κάρτας και αυτόματα δημιουργείται και αποθηκεύεται ένας Πελάτης με αυτά τα στοιχεία κάρτας.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
card_number Ναι integer(16) O αριθμός της κάρτας.
holder_name Ναι string(255) To όνομα κατόχου της κάρτας.
expiration_year Ναι integer(4) Έτος λήξης της κάρτας (4 ψηφία).
expiration_month Ναι integer(2) Μήνας λήξης της κάρτας (2 ψηφία).
cvv Ναι integer(3) Ο τριψήφιος κωδικός ασφαλείας στο πίσω μέρος της κάρτας.
amount Ναι integer Το ποσό της συναλλαγής σε cents (χωρίς σημεία στίξης π.χ. 1099 αντί 10,99).
currency Όχι string(3) Το νόμισμα της συναλλαγής (EUR)
description Όχι string(255) Μία σύντομη περιγραφή.
installments Όχι integer Ο αριθμός των δόσεων που αιτείται ο ιδιοκτήτης της κάρτας.
create_customer Όχι boolean 1: ολοκληρώνεται κανονικά η πληρωμή και ταυτόχρονα δημιουργείται πελάτης με τα δηλωθέντα στοιχεία κάρτας.
0: (προεπιλογή) ολοκληρώνεται κανονικά η πληρωμή χωρίς δημιουργία πελάτη.

Πληρωμή και δημιουργία Πελάτη με χρήση Token Κάρτας

Πληρωμή και δημιουργία Πελάτη με χρήση Token Κάρτας, με το ιδιωτικό κλειδί.

curl https://api.everypay.gr/payments
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -d token=ctn_7hPmP8611pqcTkVfDuCEuC2Y
  -d amount=1099
  -d description="payment for item #22"
  -d create_customer=1
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'token' => 'ctn_7hPmP8611pqcTkVfDuCEuC2Y',
    'amount' => 1099,
    'description' => 'payment for item #22',
    'create_customer' => 1
);

$payment = Payment::create($params);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "pmt_vd8rO6uDpnJ1MWWKyMU0gXp4",
    "date_created": "2015-11-05T12:38:04+0200",
    "description": "payment for item #22",
    "currency": "EUR",
    "status": "Captured",
    "amount": 1099,
    "refund_amount": 0,
    "fee_amount": 34,
    "payee_email": null,
    "payee_phone": null,
    "refunded": false,
    "refunds": [],
    "installments_count": 0,
    "installments": [],
    "customer": {
        "description": null,
        "email": null,
        "date_created": "2015-11-05T12:38:04+0200",
        "full_name": "John Doe",
        "token": "cus_qxVtpVXe1VrHdcEzSqaz9KwW",
        "is_active": true,
        "date_modified": "2015-11-05T12:38:04+0200",
        "card": {
            "expiration_month": "01",
            "expiration_year": "2016",
            "last_four": "1111",
            "type": "Visa",
            "holder_name": "John Doe",
            "supports_installments": false,
            "max_installments": 0
        }
    }
}
<?php
stdClass Object
(
    [token] => pmt_vd8rO6uDpnJ1MWWKyMU0gXp4
    [date_created] => 2015-11-05T12:38:04+0200
    [description] => payment for item #22
    [currency] => EUR
    [status] => Captured
    [amount] => 1099
    [refund_amount] => 0
    [fee_amount] => 34
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 
    [refunds] => Array
        (
        )

    [installments_count] => 0
    [installments] => Array
        (
        )

    [customer] => stdClass Object
        (
            [description] => 
            [email] => 
            [date_created] => 2015-11-05T12:38:04+0200
            [full_name] => John Doe
            [token] => cus_qxVtpVXe1VrHdcEzSqaz9KwW
            [is_active] => 1
            [date_modified] => 2015-11-05T12:38:04+0200
            [card] => stdClass Object
                (
                    [expiration_month] => 01
                    [expiration_year] => 2016
                    [last_four] => 1111
                    [type] => Visa
                    [holder_name] => John Doe
                    [supports_installments] => 
                    [max_installments] => 0
                )

        )

)

   
URL https://api.everypay.gr/payments
Μέθοδος POST
Περιγραφή Εκτελεί χρέωση χρησιμοποιώντας ένα προδημιουργημένο και αχρησιμοποίητο Token κάρτας και αυτόματα δημιουργείται και αποθηκεύεται ένας Πελάτης με τα στοιχεία της κάρτας στα οποία αντιστοιχεί το δηλωθέν Token κάρτας.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
token Ναι string(28) To id του token κάρτας το οποίο μας ενδιαφέρει.
amount Ναι integer Το ποσό της συναλλαγής σε cents (χωρίς σημεία στίξης π.χ. 1099 αντί 10,99).
currency Όχι string(3) Το νόμισμα της συναλλαγής (EUR)
description Όχι string(255) Μία σύντομη περιγραφή.
installments Όχι integer Ο αριθμός των δόσεων που αιτείται ο ιδιοκτήτης της κάρτας.
create_customer Όχι boolean 1: ολοκληρώνεται κανονικά η πληρωμή και ταυτόχρονα δημιουργείται πελάτης με το δηλωθέν Token κάρτας.
0: (προεπιλογή) ολοκληρώνεται κανονικά η πληρωμή χωρίς δημιουργία πελάτη.

Δέσμευση πληρωμής με χρέωση Κάρτας

1ο Βήμα: Δέσμευση πληρωμής με χρέωση κάρτας, με το ιδιωτικό κλειδί. (βλ. 2o Βήμα)

curl https://api.everypay.gr/payments
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -d card_number=4111111111111111  
  -d expiration_year=2016
  -d expiration_month=01
  -d cvv=334
  -d amount=1099
  -d currency=eur
  -d description="Order #GGA-435168"
  -d holder_name="John Doe"
  -d capture=0
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'card_number' => '4111111111111111',
    'expiration_year' => '2016',
    'expiration_month' => '01',
    'cvv' => '334',
    'amount' => 1099,
    'currency' => 'eur',
    'description' => 'Order #GGA-435168',
    'holder_name'=>'John Doe',
    'capture' => 0
);

$payment = Payment::create($params);

Απάντηση σε JSON για curl ή Object για php. Η πληρωμή δημιουργείται με την κατάσταση προέγκρισης, και το ποσό της συναλλαγής είναι δεσμευμένο. Σε επόμενο βήμα πρέπει η πληρωμή να εγκριθεί από τον έμπορο.

{
    "token": "pmt_5i8KHSpex63i1cjLVfOMMhIa",
    "date_created": "2015-09-08T16:28:46+0300",
    "description": "Order #GGA-435168",
    "currency": "EUR",
    "status": "Pre authorized",
    "amount": 1099,
    "refund_amount": 0,
    "fee_amount": 46,
    "payee_email": null,
    "payee_phone": null,
    "refunded": false,
    "refunds": [],
    "installments_count": 0,
    "installments": [],
    "card": {
        "expiration_month": "01",
        "expiration_year": "2016",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "max_installments": 0
    }
}
<?php
stdClass Object
(
    [token] => pmt_5i8KHSpex63i1cjLVfOMMhIa
    [date_created] => 2015-09-08T16:28:46+0300
    [description] => Order #GGA-435168
    [currency] => EUR
    [status] => Pre authorized
    [amount] => 1099
    [refund_amount] => 0
    [fee_amount] => 46
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 
    [refunds] => Array
        (
        )

    [installments_count] => 0
    [installments] => Array
        (
        )

    [card] => stdClass Object
        (
            [expiration_month] => 01
            [expiration_year] => 2016
            [last_four] => 1111
            [type] => Visa
            [holder_name] => John Doe
            [supports_installments] =>
            [max_installments] => 0
        )

)
   
URL https://api.everypay.gr/payments
Μέθοδος POST
Περιγραφή Εκτελεί χρέωση ως προέγκριση, με δέσμευση του ποσού, χρησιμοποιώντας τα δηλωθέντα στοιχεία μιας κάρτας. Απαιτείται η τελική έγκριση της πληρωμής (βλ. 2ο Βήμα).

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
card_number Ναι integer(16) O αριθμός της κάρτας.
holder_name Ναι string(255) To όνομα κατόχου της κάρτας.
expiration_year Ναι integer(4) Έτος λήξης της κάρτας (4 ψηφία).
expiration_month Ναι integer(2) Μήνας λήξης της κάρτας (2 ψηφία).
cvv Ναι integer(3) Ο τριψήφιος κωδικός ασφαλείας στο πίσω μέρος της κάρτας.
amount Ναι integer Το ποσό της συναλλαγής σε cents (χωρίς σημεία στίξης π.χ. 1099 αντί 10,99).
currency Όχι string(3) Το νόμισμα της συναλλαγής (EUR).
description Όχι string(255) Μία σύντομη περιγραφή.
capture Όχι boolean 1: (προεπιλογή) ολοκληρώνεται κανονικά η πληρωμή.
0: γίνεται προέγκριση πληρωμής και δέσμευση του ποσού. Σε τέτοια περίπτωση πρέπει να γίνει η τελική έγκριση της πληρωμής σε δεύτερο βήμα (βλ. Έγκριση δεσμευμένης πληρωμής).

Δέσμευση πληρωμής με χρέωση Πελάτη

1ο Βήμα: Δέσμευση πληρωμής με χρέωση Πελάτη, με το ιδιωτικό κλειδί. (βλ. 2o Βήμα)

curl https://api.everypay.gr/payments
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -d token=cus_WLACZa1ubdp86eT1uYn6GFRf
  -d description="Rent September 2015"
  -d amount=35000
  -d capture=0
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'token' => 'cus_WLACZa1ubdp86eT1uYn6GFRf',
    'description' => 'Rent September 2015',
    'amount' => 35000,
    'capture' => 0
);

$payment = Payment::create($params);

Απάντηση σε JSON για curl ή Object για php. Η πληρωμή δημιουργείται με την κατάσταση προέγκρισης, και το ποσό της συναλλαγής είναι δεσμευμένο. Σε επόμενο βήμα πρέπει η πληρωμή να εγκριθεί από τον έμπορο.

{
    "token": "pmt_yOW5N9ICrB8BT8yqu6VeeiVV",
    "date_created": "2015-09-15T17:38:20+0300",
    "description": "Rent September 2015",
    "currency": "EUR",
    "status": "Pre authorized",
    "amount": 35000,
    "refund_amount": 0,
    "fee_amount": 860,
    "payee_email": null,
    "payee_phone": null,
    "refunded": false,
    "refunds": [],
    "installments_count": 0,
    "installments": [],
    "customer": {
        "description": null,
        "email": null,
        "date_created": "2015-07-30T15:12:30+0300",
        "full_name": null,
        "token": "cus_WLACZa1ubdp86eT1uYn6GFRf",
        "is_active": true,
        "date_modified": "2015-09-15T17:38:20+0300",
        "card": {
            "expiration_month": "01",
            "expiration_year": "2016",
            "last_four": "1111",
            "type": "Visa",
            "holder_name": "Minas Kitsos",
            "supports_installments": false,
            "max_installments": 0
        }
    }
}

<?php
stdClass Object
(
    [token] => pmt_yOW5N9ICrB8BT8yqu6VeeiVV
    [date_created] => 2015-09-15T17:38:20+0300
    [description] => Rent September 2015
    [currency] => EUR
    [status] => Pre authorized
    [amount] => 35000
    [refund_amount] => 0
    [fee_amount] => 860
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 
    [refunds] => Array
        (
        )

    [installments_count] => 0
    [installments] => Array
        (
        )

    [customer] => stdClass Object
        (
            [description] => 
            [email] => 
            [date_created] => 2015-07-30T15:12:30+0300
            [full_name] => 
            [token] => cus_WLACZa1ubdp86eT1uYn6GFRf
            [is_active] => 1
            [date_modified] => 2015-09-15T17:38:20+0300
            [card] => stdClass Object
                (
                    [expiration_month] => 01
                    [expiration_year] => 2016
                    [last_four] => 1111
                    [type] => Visa
                    [holder_name] => Minas Kitsos
                    [supports_installments] =>
                    [max_installments] => 0
                )

        )
)
   
URL https://api.everypay.gr/payments
Μέθοδος POST
Περιγραφή Εκτελεί χρέωση ως προέγκριση, με δέσμευση του ποσού, χρησιμοποιώντας ένα προδημιουργημένο αντικείμενο Πελάτη. Απαιτείται η τελική έγκριση της πληρωμής (βλ. <

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
token Ναι string(28) Το id του πελάτη προς χρέωση.
amount Ναι integer Το ποσό της συναλλαγής σε cents (χωρίς σημεία στίξης π.χ. 1099 αντί 10,99).
currency Όχι string(3) Το νόμισμα της συναλλαγής (EUR).
description Όχι string(255) Μία σύντομη περιγραφή.
capture Όχι boolean 1: (προεπιλογή) ολοκληρώνεται κανονικά η πληρωμή.
0: γίνεται προέγκριση πληρωμής και δέσμευση του ποσού. Σε τέτοια περίπτωση πρέπει να γίνει η τελική έγκριση της πληρωμής σε δεύτερο βήμα (βλ. Έγκριση δεσμευμένης πληρωμής).

Δέσμευση πληρωμής με χρέωση Token Κάρτας

1ο Βήμα: Δέσμευση πληρωμής με χρήση Token Κάρτας, με το ιδιωτικό κλειδί. (βλ. 2o Βήμα)

curl https://api.everypay.gr/payments
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -d token=ctn_7hPmP8611pqcTkVfDuCEuC2Y
  -d amount=1099
  -d description="payment for item #57"
  -d capture=0
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'token' => 'ctn_7hPmP8611pqcTkVfDuCEuC2Y',
    'amount' => 1099,
    'description' => 'payment for item #57',
    'capture' => 0
);

$payment = Payment::create($params);

Απάντηση σε JSON για curl ή Object για php. Η πληρωμή δημιουργείται με την κατάσταση προέγκρισης, και το ποσό της συναλλαγής είναι δεσμευμένο. Σε επόμενο βήμα πρέπει η πληρωμή να εγκριθεί από τον έμπορο.

{
    "token": "pmt_E5XVLCsdOHp8kfsTky6kIwwr",
    "date_created": "2015-08-11T14:13:09+0300",
    "description": "payment for item #57",
    "currency": "EUR",
    "status": "Pre authorized",
    "amount": 1099,
    "refund_amount": 0,
    "fee_amount": 34,
    "payee_email": null,
    "payee_phone": null,
    "refunded": false,
    "refunds": [],
    "installments_count": 0,
    "installments": [],
    "card": {
        "expiration_month": "01",
        "expiration_year": "2016",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "max_installments": 0
    }
}
<?php
stdClass Object
(
    [token] => pmt_E5XVLCsdOHp8kfsTky6kIwwr
    [date_created] => 2015-08-11T14:13:09+0300
    [description] => payment for item #57
    [currency] => EUR
    [status] => Pre authorized
    [amount] => 1099
    [refund_amount] => 0
    [fee_amount] => 34
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 
    [refunds] => Array
        (
        )

    [installments_count] => 0
    [installments] => Array
        (
        )

    [card] => stdClass Object
        (
            [expiration_month] => 01
            [expiration_year] => 2016
            [last_four] => 1111
            [type] => Visa
            [holder_name] => John Doe
            [supports_installments] =>
            [max_installments] => 0
        )

)
   
URL https://api.everypay.gr/payments
Μέθοδος POST
Περιγραφή Εκτελεί χρέωση ως προέγκριση, με δέσμευση του ποσού, χρησιμοποιώντας ένα προδημιουργημένο και αχρησιμοποίητο Token Κάρτας. Απαιτείται η τελική έγκριση της πληρωμής (βλ. <

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
token Ναι string(28) To id του token κάρτας το οποίο μας ενδιαφέρει.
amount Ναι integer Το ποσό της συναλλαγής σε cents (χωρίς σημεία στίξης π.χ. 1099 αντί 10,99).
currency Όχι string(3) Το νόμισμα της συναλλαγής (EUR).
description Όχι string(255) Μία σύντομη περιγραφή.
capture Όχι boolean 1: (προεπιλογή) ολοκληρώνεται κανονικά η πληρωμή.
0: γίνεται προέγκριση πληρωμής και δέσμευση του ποσού. Σε τέτοια περίπτωση πρέπει να γίνει η τελική έγκριση της πληρωμής σε δεύτερο βήμα (βλ. Έγκριση δεσμευμένης πληρωμής).

Έγκριση δεσμευμένης πληρωμής

2ο Βήμα: Έγκριση δεσμευμένης πληρωμής, με το ιδιωτικό κλειδί. Είναι η ολοκλήρωση της συναλλαγής που είχε αρχίσει ως προέγκριση (βλ. 1ο Βήμα Κάρτα ή Token Κάρτας ή Token Πελάτη)

curl https://api.everypay.gr/payments/capture/pmt_5i8KHSpex63i1cjLVfOMMhIa
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -X PUT
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$token = 'pmt_5i8KHSpex63i1cjLVfOMMhIa';

$payment = Payment::capture($token);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "pmt_5i8KHSpex63i1cjLVfOMMhIa",
    "date_created": "2015-09-08T16:28:46+0300",
    "description": "Order #GGA-435168",
    "currency": "EUR",
    "status": "Captured",
    "amount": 1099,
    "refund_amount": 0,
    "fee_amount": 46,
    "payee_email": null,
    "payee_phone": null,
    "refunded": false,
    "refunds": [],
    "installments_count": 0,
    "installments": [],
    "card": {
        "expiration_month": "01",
        "expiration_year": "2016",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "max_installments": 0
    }
}
<?php
stdClass Object
(
    [token] => pmt_5i8KHSpex63i1cjLVfOMMhIa
    [date_created] => 2015-09-08T16:28:46+0300
    [description] => Order #GGA-435168
    [currency] => EUR
    [status] => Captured
    [amount] => 1099
    [refund_amount] => 0
    [fee_amount] => 46
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 
    [refunds] => Array
        (
        )

    [installments_count] => 0
    [installments] => Array
        (
        )

    [card] => stdClass Object
        (
            [expiration_month] => 01
            [expiration_year] => 2016
            [last_four] => 1111
            [type] => Visa
            [holder_name] => John Doe
            [supports_installments] =>
            [max_installments] => 0
        )

)
   
URL https://api.everypay.gr/payments/capture/{PAYMENT}
Μέθοδος PUT
Περιγραφή Εκτελεί έγκριση δεσμευμένης πληρωμής (με όποιο τρόπο και αν προήλθε αυτή),

ολοκληρώνοντας τη συναλλαγή που ξεκίνησε σε προηγούμενο βήμα ως προέγκριση (βλ. 1ο Βήμα Κάρτα ή Token Κάρτας)).

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
{PAYMENT} Ναι string(28) To Token (id) της πληρωμής προς επιστροφή.

Επιστροφή πληρωμής

Πλήρης επιστροφή πληρωμής, με το ιδιωτικό κλειδί.

curl https://api.everypay.gr/payments/refund/pmt_A71tLD12bKumsd8v3rv9BNsY 
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -X PUT
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$token = 'pmt_A71tLD12bKumsd8v3rv9BNsY';

$payment = Payment::refund($token);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "pmt_A71tLD12bKumsd8v3rv9BNsY",
    "date_created": "2015-08-11T11:54:46+0300",
    "description": "Order #GGA-435167",
    "currency": "EUR",
    "status": "Refunded",
    "amount": 1099,
    "refund_amount": 1099,
    "fee_amount": 0,
    "payee_email": null,
    "payee_phone": null,
    "refunded": true,
    "refunds": [
        {
            "token": "ref_S9alsjUsbGK3WJ2EUWhrLfhg",
            "status": "Captured",
            "date_created": "2015-08-13T12:58:07+0300",
            "amount": 1099,
            "fee_amount": 34,
            "description": null
        }
    ],
    "installments_count": 0,
    "installments": [],
    "card": {
        "expiration_month": "01",
        "expiration_year": "2016",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "John Doe",
        "supports_installments": false,
        "max_installments": 0
    }
}
<?php
stdClass Object
(
    [token] => pmt_A71tLD12bKumsd8v3rv9BNsY
    [date_created] => 2015-08-11T11:54:46+0300
    [description] => Order #GGA-435167
    [currency] => EUR
    [status] => Refunded
    [amount] => 1099
    [refund_amount] => 1099
    [fee_amount] => 0
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 1
    [refunds] => Array
        (
            [0] => stdClass Object
                (
                    [token] => ref_S9alsjUsbGK3WJ2EUWhrLfhg
                    [status] => Captured
                    [date_created] => 2015-08-13T12:58:07+0300
                    [amount] => 1099
                    [fee_amount] => 34
                    [description] => null
                )

        )

    [installments_count] => 0
    [installments] => Array
        (
        )

    [card] => stdClass Object
        (
            [expiration_month] => 01
            [expiration_year] => 2016
            [last_four] => 1111
            [type] => Visa
            [holder_name] => John Doe
            [supports_installments] =>
            [max_installments] => 0
        )

)

Μερική επιστροφή πληρωμής, με το ιδιωτικό κλειδί.

curl https://api.everypay.gr/payments/refund/pmt_hpb9nbsTa30uJ0eKjMcoyj9C
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -d amount=4122
  -d description="price correction"
  -X PUT
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$token = 'pmt_hpb9nbsTa30uJ0eKjMcoyj9C';

$params=array(
    'amount' => 4122,
    'description' => "price correction"
);

$payment = Payment::refund($token, params);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "pmt_hpb9nbsTa30uJ0eKjMcoyj9C",
    "date_created": "2015-07-30T15:26:16+0300",
    "description": null,
    "currency": "EUR",
    "status": "Partially Refunded",
    "amount": 7863,
    "refund_amount": 4122,
    "fee_amount": 92,
    "payee_email": null,
    "payee_phone": null,
    "refunded": false,
    "refunds": [
        {
            "token": "ref_HW0nq1rhoTEY7NmokHU7DgmT",
            "status": "Captured",
            "date_created": "2015-08-13T13:08:33+0300",
            "amount": 4122,
            "fee_amount": 91,
            "description": "price correction"
        }
    ],
    "installments_count": 0,
    "installments": [],
    "card": {
        "expiration_month": "01",
        "expiration_year": "2016",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "Test 1",
        "supports_installments": false,
        "max_installments": 0
    }
}
<?phpstdClass Object
(
    [token] => pmt_hpb9nbsTa30uJ0eKjMcoyj9C
    [date_created] => 2015-07-30T15:26:16+0300
    [description] => 
    [currency] => EUR
    [status] => Partially Refunded
    [amount] => 7863
    [refund_amount] => 4122
    [fee_amount] => 92
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 
    [refunds] => Array
        (
            [0] => stdClass Object
                (
                    [token] => ref_HW0nq1rhoTEY7NmokHU7DgmT
                    [status] => Captured
                    [date_created] => 2015-08-13T13:08:33+0300
                    [amount] => 4122
                    [fee_amount] => 91
                    [description] => price correction
                )

        )

    [installments_count] => 0
    [installments] => Array
        (
        )

    [card] => stdClass Object
        (
            [expiration_month] => 01
            [expiration_year] => 2016
            [last_four] => 1111
            [type] => Visa
            [holder_name] => Test 1
            [supports_installments] =>
            [max_installments] => 0
        )

)
   
URL https://api.everypay.gr/payments/refund/{PAYMENT}
Μέθοδος PUT
Περιγραφή Εκτελεί επιστροφή ενός ποσού για μία συγκεκριμένη πληρωμή. Η επιστροφή μπορεί να είναι ολική ή μερική.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
{PAYMENT} Ναι string(28) To Token (id) της πληρωμής προς επιστροφή.
amount Όχι integer Το ποσό της συναλλαγής σε cents (χωρίς σημεία στίξης π.χ. 1099 αντί 10,99). Εάν το ποσό δεν οριστεί τότε πραγματοποιείται επιστροφή όλου του ποσού.
description Όχι string(255) Μία σύντομη περιγραφή.

Ανάκτηση πληρωμής

Ανάκτηση πληρωμής, με το ιδιωτικό κλειδί.

curl  https://api.everypay.gr/payments/pmt_CSntXIVynqIgkYicZlBVz52O
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$token = 'pmt_CSntXIVynqIgkYicZlBVz52O';

$payment = Payment::retrieve($token);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "pmt_CSntXIVynqIgkYicZlBVz52O",
    "date_created": "2015-07-30T15:27:16+0300",
    "description": null,
    "currency": "EUR",
    "status": "Captured",
    "amount": 8912,
    "refund_amount": 0,
    "fee_amount": 206,
    "payee_email": null,
    "payee_phone": null,
    "refunded": false,
    "refunds": [],
    "installments_count": 0,
    "installments": [],
    "card": {
        "expiration_month": "01",
        "expiration_year": "2016",
        "last_four": "1111",
        "type": "Visa",
        "holder_name": "Test 1",
        "supports_installments": false,
        "max_installments": 0
    }
}
<?php
stdClass Object
(
    [token] => pmt_CSntXIVynqIgkYicZlBVz52O
    [date_created] => 2015-07-30T15:27:16+0300
    [description] => 
    [currency] => EUR
    [status] => Captured
    [amount] => 8912
    [refund_amount] => 0
    [fee_amount] => 206
    [payee_email] => 
    [payee_phone] => 
    [refunded] => 
    [refunds] => Array
        (
        )

    [installments_count] => 0
    [installments] => Array
        (
        )

    [card] => stdClass Object
        (
            [expiration_month] => 01
            [expiration_year] => 2016
            [last_four] => 1111
            [type] => Visa
            [holder_name] => Test 1
            [supports_installments] =>
            [max_installments] => 0
        )

)
   
URL https://api.everypay.gr/payments/{PAYMENT}
Μέθοδος GET
Περιγραφή Επιστρέφει πληροφορίες για μία συγκεκριμένη πληρωμή.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
{PAYMENT} Ναι string(28) To Token (id) της πληρωμής προς αναζήτηση.

Ειδοποιήσεις Πληρωμών

Οι Ειδοποιήσεις Πληρωμών είναι ειδοποιήσεις που παρακινούν έναν πελάτη να πραγματοποιήσει πληρωμή προς τον έμπορο που έστειλε την ειδοποίηση.

Δημιουργία ειδοποίησης πληρωμής με τα στοιχεία του πελάτη

Δημιουργία ειδοποίησης πληρωμής με τα στοιχεία του πελάτη, με το ιδιωτικό κλειδί του έμπορου.

curl https://api.everypay.gr/notifications
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
  -d payee_name="John Doe" 
  -d payee_email="john.doe@themail.com"
  -d payee_phone=2106969169
  -d amount=4500
  -d description="Payment for item #450"
  -d expiration_date="2015-10-19 15:52:00"
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\PaymentNotification;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'payee_name' => 'John Doe',
    'payee_email' => 'john.doe@themail.com',
    'payee_phone' => '2106969169',
    'amount' => 4500,
    'description' => 'Payment for item #450',
    'expiration_date'=>'2015-10-19 15:52:00'
);

$notification = PaymentNotification::create($params);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "pnt_lmPLs5zHKCK2sa8B20wZ9xNq",
    "status": "Awaiting",
    "date_created": "2015-10-11T23:14:25+0300",
    "description": "Payment for item #450",
    "amount": 4500,
    "payee_name": "John Doe",
    "payee_email": "john.doe@themail.com",
    "payee_phone": "2106969169",
    "expiration_date": "2015-10-19T15:52:00+0300",
    "locale": "el"
}
<?php
stdClass Object
(
    [token] => pnt_lmPLs5zHKCK2sa8B20wZ9xNq
    [status] => Awaiting
    [date_created] => 2015-10-11T23:14:25+0300
    [description] => Payment for item #450
    [amount] => 4500
    [payee_name] => John Doe
    [payee_email] => john.doe@themail.com
    [payee_phone] => 2106969169
    [expiration_date] => 2015-10-19T15:52:00+0300
    [locale] => el

)
   
URL https://api.everypay.gr/notifications
Μέθοδος POST
Περιγραφή Δημιουργεί ειδοποίηση πληρωμής από τον έμπορο προς συγκεκριμένο πελάτη. Η ειδοποίηση δημιουργείται στη βάση δεδομένων ενώ ταυτόχρονα αποστέλεται και στη διεύθυνση ηλ. αλληλογραφίας του πελάτη.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
payee_name Ναι string(255) To όνομα του πελάτη που καλείται να πραγματοποιήσει την πληρωμή.
payee_email Ναι string(100) H διεύθυνση email του πελάτη που καλείται να πραγματοποιήσει την πληρωμή.
payee_phone Ναι integer(10) Ο αριθμός τηλεφώνου του πελάτη που καλείται να πραγματοποιήσει την πληρωμή .
amount Ναι integer Το ποσό της συναλλαγής σε cents (χωρίς σημεία στίξης π.χ. 1099 αντί 10,99).
description Ναι string(255) Μία σύντομη περιγραφή της επεκείμενης πληρωμής στην οποία αναφέρεται αυτή η ειδοποίηση.
expiration_date Όχι DateTime::ISO8601 Η ημερομηνία μέχρι και την οποία είναι έγκυρη αυτή η ειδοποίηση πληρωμής (όχι λιγότερο από 24 ώρες από την δημιουργία της ειδοποίησης). Παράδειγμα: “2015-10-18T15:52:00+0300”
locale Όχι string(2) Η γλώσσα στην οποία θα σταλεί το email ειδοποίησης στον πελάτη.

Ανάκτηση ειδοποίησης πληρωμής

Προβολή μιας συγκεκριμένης ειδοποίησης πληρωμής.

curl https://api.everypay.gr/notifications/pnt_ZO0maRe68evdrVnLDmdsR3xE
    -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\PaymentNotification;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$token = 'pnt_ZO0maRe68evdrVnLDmdsR3xE';

$notification = PaymentNotification::retrieve($token);

Απάντηση σε JSON για curl ή Object για php

{
    "token": "pnt_ZO0maRe68evdrVnLDmdsR3xE",
    "status": "Awaiting",
    "date_created": "2016-01-14T13:21:29+0200",
    "description": "Δόση 1η 2016",
    "amount": 4500,
    "payee_name": "John Doe",
    "payee_email": "john.doe@gmail.com",
    "payee_phone": "2106561444",
    "expiration_date": "2016-02-25T23:59:00+0200",
    "locale": "el"
}
<?php
(
    [token] => pnt_ZO0maRe68evdrVnLDmdsR3xE
    [status] => Awaiting
    [date_created] => 2016-01-14T13:21:29+0200
    [description] => Δόση 1η 2016
    [amount] => 4500
    [payee_email] => john.doe@gmail.com
    [payee_phone] => 2106561444
    [expiration_date] => 2016-02-25T23:59:00+0200
    [locale] => el
)
   
URL https://api.everypay.gr/notifications/{NOTIFICATION_ID}
Μέθοδος GET
Περιγραφή Επιστρέφει τις πληροφορίες για μια συγκεκριμένη ειδοποίηση πληρωμής.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
{NOTIFICATION_ID} Ναι string(28) To id της ειδοποίησης πληρωμής μεταδίδεται απευθείας από τη διεύθυνση URL.

Λίστα ειδοποιήσεων πληρωμών

Λίστα ειδοποιήσεων πληρωμών.

curl https://api.everypay.gr/notifications?count=3&offset=1
  -X GET
  -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R:
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\PaymentNotification;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'count' => 3,
    'offset' => 1
);

$notifications = PaymentNotification::listAll($params);

Απάντηση σε JSON για curl ή Object για php

Εδώ υπάρχουν 10 ειδοποιήσεις πληρωμών στη βάση δεδομένων αλλά ζητάμε να δούμε μόνο τις 3 τελευταία δημιουργημένες, παρακάπτωντας την πιο πρόσφατη από όλες.

{
    "total_count": 10,
    "items": [
        {
            "token": "pnt_ZO0maRe68evdrVnLDmdsR3xE",
            "status": "Awaiting",
            "date_created": "2016-01-14T13:21:29+0200",
            "description": "Δόση 1η 2016",
            "amount": 4500,
            "payee_name": "John Doe",
            "payee_email": "john.doe@gmail.com",
            "payee_phone": "2106561444",
            "expiration_date": "2016-02-25T23:59:00+0200",
            "locale": "el"
        },
        {
            "token": "pnt_RobdUp58eeNzUQtOhaFHwxhi",
            "status": "Expired",
            "date_created": "2015-10-12T16:31:03+0300",
            "description": "Καλάθι #2199",
            "amount": 1100,
            "payee_name": "John Doe",
            "payee_email": "john.doe@gmail.com",
            "payee_phone": "2106561444",
            "expiration_date": "2015-10-22T23:59:00+0300",
            "locale": "el"
        },
        {
            "token": "pnt_UuvUZgi12l76CuqBdRv1XLbK",
            "status": "Expired",
            "date_created": "2015-10-12T16:25:10+0300",
            "description": "Δόση 12",
            "amount": 2500,
            "payee_name": "Mike Doe",
            "payee_email": "mike.doe@gmail.com",
            "payee_phone": "2106561333",
            "expiration_date": "2015-10-15T23:59:00+0300",
            "locale": "el"
        }
    ]
}

<?php
(
    [total_count] => 10
    [items] => Array
        (
            [0] => stdClass Object
                (
                    [token] => pnt_ZO0maRe68evdrVnLDmdsR3xE
                    [status] => Awaiting
                    [date_created] => 2016-01-14T13:21:29+0200
                    [description] => Δόση 1η (2016)
                    [amount] => 4500
                    [payee_name] => John Doe
                    [payee_email] => john.doe@gmail.com
                    [payee_phone] => 2106561444
                    [expiration_date] => 2016-02-25T23:59:00+0200
                    [locale] => el
                )

            [1] => stdClass Object
                (
                    [token] => pnt_RobdUp58eeNzUQtOhaFHwxhi
                    [status] => Expired
                    [date_created] => 2015-10-12T16:31:03+0300
                    [description] => Καλάθι #2199
                    [amount] => 1100
                    [payee_name] => John Doe
                    [payee_email] => john.doe@gmail.com
                    [payee_phone] => 2106561444
                    [expiration_date] => 2015-10-22T23:59:00+0300
                    [locale] => el
                )

            [2] => stdClass Object
                (
                    [token] => pnt_UuvUZgi12l76CuqBdRv1XLbK
                    [status] => Expired
                    [date_created] => 2015-10-12T16:25:10+0300
                    [description] => Δόση 12
                    [amount] => 2500
                    [payee_name] => Mike Doe
                    [payee_email] => mike.doe@gmail.com
                    [payee_phone] => 2106561333
                    [expiration_date] => 2015-10-15T23:59:00+0300
                    [locale] => el
                )

        )

)

   
URL https://api.everypay.gr/notifications?count={int1}&offset={int2}
Μέθοδος GET
Περιγραφή Προβολή όλων των ειδοποιήσεων πληρωμών. Τα αντικείμενα προβάλλονται ταξινομημένα σύμφωνα με την ημερομηνία δημιουργίας, με πρώτο να εμφανίζεται το πιο πρόσφατα δημιουργημένο.

Ορίσματα

Πεδίο Υποχρεωτικό Τύπος Περιγραφή
SECRET KEY Ναι string(35) Το ιδιωτικό κλειδί δίνεται σαν username για HTTP πρόσβαση.
count Όχι integer(4) O αριθμός των εμφανιζόμενων αποτελεσμάτων. Δίνεται σαν παράμετρος στη διέυθυνση URL. Εάν δεν ορισθεί τότε λαμβάνεται η προκαθορισμένη τιμή που είναι 10. Ανώτερη τιμή είναι το 20.
offset Όχι integer(4) Ο αριθμός των ειδοποιήσεων μετά τις οποίες θα εμφανιστούν τα αποτελέσματα π.χ. για τις ειδοποιήσεις που βρίσκονται από τη θέση 10 και μετά δηλώνουμε offset=9. Δίνεται σαν παράμετρος στη διέυθυνση URL. Η προκαθορισμένη τιμή είναι 0.

Exceptions

Παρακάτω δίνοναι οι πιο συνηθισμένοι κωδικοί λάθους που επιτρέφει το api μαζί με την εξήγηση του καθενός.

Παράδειγμα δημιουργίας Token για κάρτα χωρίς το όνομα του κατόχου της.

curl https://api.everypay.gr/payments
    -u sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R: 
    -d card_number=4242424242424242 
    -d expiration_year=2017
    -d expiration_month=06
    -d cvv=160
    -d amount=3000
<?php
require_once '../autoload.php';

use Everypay\Everypay;
use Everypay\Payment;

Everypay::setApiKey('sk_PqSohnrYrRI1GUKOZvDkK5VVWAhnlU3R');

$params = array(
    'card_number' => '4242424242424242',
    'expiration_year' => '2017',
    'expiration_month' => '06',
    'cvv' => '160',
    'amount' => '3000'
);

$payment = Payment::create($params);

Απάντηση σε JSON για curl ή Object για php

{
    "error": {
        "status": 400,
        "code": 20008,
        "message": "Card holder name is empty or too long (max. 255 chars)."
    }
}
<?php
stdClass Object
(
    [error] => stdClass Object
        (
            [status] => 400
            [code] => 20008
            [message] => Card holder name is empty or too long (max. 255 chars).
        )

)
Κωδικός Λάθους Εξήγηση
10000 Please provide a valid API key.
10001 The provided API key is not valid: <api-key>
10002 The requested resource was not found.
10003 You can only create and retrieve tokens with the public key.
10004 Request method not supported by this resource.
20000 Invalid card number. Please try again or use another card.
20001 Expiration year in the past or invalid.
20002 Expiration month in the past or invalid.
20003 Provide a valid (3 digit) CVV code.
20004 Card is expired or expiration date does not match.
20005 Could not find requested card token.
20006 Provided card token <token> has expired.
20007 Provided card token <token> has already been used.
40001 Invalid payment token. Must provide a card or a customer token.
40002 The amount parameter is invalid. Min. 30 cents
40003 Provide a valid currency for the payment.
40004 Payment was declined by issuer bank.
40005 Could not find payment: <token>
40006 Payment <token> has already been fully refunded.
40007 Refund amount of <amount> exceeds the remaining amount of payment <token>.
40013 Gateway responded with an error.
40015 Payment <token> is marked as [FAILED/CANCELED/REFUNDED] and cannot be refunded.
40017 Your balance of <amount> is not sufficient to refund payment <token>.
40018 Payment <token> is marked as [CAPTURED/REFUNDED/PARTIALLY REFUNDED] and cannot be canceled.