public class Payment
extends java.lang.Object
Modifier and Type | Class and Description |
---|---|
static class |
Payment.Currency |
static class |
Payment.Links |
static class |
Payment.Status |
Modifier and Type | Method and Description |
---|---|
java.lang.Integer |
getAmount()
Amount in pence (GBP), cents (AUD/EUR), öre (SEK), or øre (DKK).
|
java.lang.Integer |
getAmountRefunded()
Amount refunded in pence/cents/öre/øre.
|
java.lang.String |
getChargeDate()
A future date on which the payment should be collected.
|
java.lang.String |
getCreatedAt()
Fixed timestamp, recording when this resource was created.
|
Payment.Currency |
getCurrency()
ISO 4217 currency code.
|
java.lang.String |
getDescription()
A human-readable description of the payment.
|
java.lang.String |
getId()
Unique identifier, beginning with “PM”.
|
Payment.Links |
getLinks() |
java.util.Map<java.lang.String,java.lang.String> |
getMetadata()
Key-value store of custom data.
|
java.lang.String |
getReference()
An optional payment reference that will appear on your customer’s bank statement.
|
Payment.Status |
getStatus()
One of:
pending_customer_approval : we’re waiting for the customer to approve this payment pending_submission : the payment has been created, but not yet submitted to the banks submitted : the payment has been submitted to the banks confirmed : the payment has been confirmed as collected paid_out : the payment has been included in a payout cancelled : the payment has been cancelled customer_approval_denied : the customer has denied approval for the payment. |
public java.lang.Integer getAmount()
Amount in pence (GBP), cents (AUD/EUR), öre (SEK), or øre (DKK).
public java.lang.Integer getAmountRefunded()
Amount refunded in pence/cents/öre/øre.
public java.lang.String getChargeDate()
A future date on which the payment should be collected. If not specified, the payment will be collected as soon as possible. This must be on or after the mandate’s next_possible_charge_date
, and will be rolled-forwards by GoCardless if it is not a working day.
public java.lang.String getCreatedAt()
Fixed timestamp, recording when this resource was created.
public Payment.Currency getCurrency()
ISO 4217 currency code. Currently “AUD”, “DKK”, “EUR”, “GBP”, “NZD” and “SEK” are supported.
public java.lang.String getDescription()
A human-readable description of the payment. This will be included in the notification email GoCardless sends to your customer if your organisation does not send its own notifications (see compliance requirements).
public java.lang.String getId()
Unique identifier, beginning with “PM”.
public Payment.Links getLinks()
public java.util.Map<java.lang.String,java.lang.String> getMetadata()
Key-value store of custom data. Up to 3 keys are permitted, with key names up to 50 characters and values up to 500 characters.
public java.lang.String getReference()
An optional payment reference that will appear on your customer’s bank statement. For Bacs payments this can be up to 10 characters, for SEPA payments the limit is 140 characters, for Betalingsservice or BECS payments the limit is 30 characters and for Autogiro payments the limit is 11 characters.
Restricted: You can only specify a payment reference for Bacs payments (that is, when collecting from the UK) if you’re on the GoCardless Plus or Pro packages.
public Payment.Status getStatus()
One of:
pending_customer_approval
: we’re waiting for the customer to approve this paymentpending_submission
: the payment has been created, but not yet submitted to the bankssubmitted
: the payment has been submitted to the banksconfirmed
: the payment has been confirmed as collectedpaid_out
: the payment has been included in a payoutcancelled
: the payment has been cancelledcustomer_approval_denied
: the customer has denied approval for the payment. You should contact the customer directlyfailed
: the payment failed to be processed. Note that payments can fail after being confirmed if the failure message is sent late by the banks.charged_back
: the payment has been charged back