...
Info |
---|
Please note specific field value:
|
...
Creating Invoice
Payrix Payment Request
A staging object used to request payments.
API Name: Payrix_PaymentRequest__c
Contains all invoices/billing documents that may be paid through Payrix
Can be populated by Triggers/Process on any Salesforce object
Info |
---|
Please note this object is only populated and updated by Salesforce. |
API Name | Type | Description |
---|---|---|
SourceType__c | text (255) | The type of source object for the invoice; eg. “BillingDocument” or “Invoice”. |
SourceId__c | text (18) | The object ID of the source object. |
InvoiceNumber__c | text (20) | The source document reference that is shown to the payer as the invoice number; e.g. “INV-001”. |
InvoiceType__c | picklist | “Single” for a one-off payment. “Recurring” if the payment will occur automatically on the due date when credit card or bank account details have been provided by the payer previously. |
IssueDate__c | date | The date the invoice was issued on. |
DueDate__c | date | The date payment for the invoice is due. |
Description__c | textarea (255) | The text shown to the payer to describe the purpose/content of the invoice. |
CurrencyCode__c | text (3) | The currency code for the amount due to be paid, as per standard Salesforce currency codes. |
AmountDue__c | number (16,2) | The amount due to be paid. |
PayerType__c | text (255) | The type of payer object for the invoice; eg. “Account” or “Contact”. |
PayerId__c | text (18) | The object ID of the payer object. |
PayerFamilyOrBusinessName__c | text (50) | The payer’s surname or business name; e.g. for “Jane A. Citizen” use “Citizen”. |
PayerGivenName__c | text (50) | The payer’s given name; e.g. for “Jane A. Citizen” use “Jane”. |
PayerEmail__c | text (255) | The payer’s email address. |
PayerPhone__c | text (50) | The payer’s preferred phone number for voice communications. |
PayerMobilePhone__c | text (50) | The payer’s mobile phone number for SMS communications. |
PayerBillingSteet__c | textarea (255) | The street details of the payer’s billing address. |
PayerBillingCity__c | text (50) | The city, suburb or town component of the payer’s billing address. |
PayerBillingState__c | text (50) | The state or territory component of the payer’s billing address. |
PayerBillingPostalCode__c | text (50) | The postal or ZIP code component of the payer’s billing address. |
PayerBillingCountry__c | text (50) | The country component of the payer’s billing address. |
PaymentUrl__c | formula | The URL of the Payrix Hosted Payment Service that accepts payment for the invoice. The value of this field is generated automatically. |
Info |
---|
All fields other than PaymentUrl are required. PaymentUrl__c is generated automatically. This field is read-only. |
...
Transaction Sync
Payrix Payment Event
A staging object used to signal payment events.
API Name: Payrix_PaymentEvent__c
All payments made through Payrix for the Biller will be inserted into the is table.
Multiple payments for an Invoice will be inserted separately.
API Name | Type | Description |
---|---|---|
EventDateTime__c | datetime | The date and time of the payment event. |
EventType__c | picklist | “Pending” when automatic processing of a recurring invoice has started. “Rejected” when the payment was rejected (declined). “Success' when the payment was successful (approved). “Settled” when settlement for the payment has occured. |
SourceType__c | text (255) | The type of source object for the invoice; e.g. “BillingDocument” or “Invoice”. Blank for payments not arising from Payrix Payment Request objects. |
SourceId__c | text (100) | The object ID of the source object, for payments arising from Payrix Payment Request objects; otherwise the transaction reference. |
InvoiceNumber__c | text (20) | The source document reference that is shown to the payer as the invoice number; e.g. “INV-001”. Blank for payments not arising from Payrix Payment Request objects. |
RejectionCode__c | text (50) | The rejection code; not provided unless the value of “EventType__c” is “Rejected”. |
RejectionDescription__c | text(255) | The rejection description; not provided unless the value of “EventType__c” is “Rejected”. |
CurrencyCode__c | text (3) | The currency code for the amount paid, fees and charges, as per standard Salesforce currency codes. |
AmountPaid__c | number (16,2) | The total amount paid for the invoice. This may differ from the amount due because of surcharges or, for some |
SurchargeAmount__c | number (16,2) | The total amount of any surcharges paid by the payer for the invoice. |
FeeAmount__c | number (16,2) | The total amount of any fees that will be charged to the business the receives the payment for the invoice. |
PaymentMethodCode__c | text (20) | The payment method code. |
PaymentMethodName__c | text (80) | The name of the payment method used to pay the invoice; e.g. “Bank Account Debit”. |
MaskedAccountNumber__c | text (40) | The masked credit card, bank account or other account number used to pay the invoice; e.g. “444433xxxxxx1111”. |
SettlementId__c | lookup | The object ID for the settlement event that contains the payment for the invoice. |
TransactionReference__c | text (100) | The internal Payrix transaction reference, to allow reconciliation with non-Payrix services. |
TransactionTypeCode__c | text (20) | The transaction type code. |
TransactionTypeName__c | text (80) | The name of the transaction type; e.g. “Realtime Payment - Website”. |
...
Settlement Transactions
Payrix Settlement Event
A staging object used to signal settlement events.
API Name: Payrix_SettlementEvent__c
All money settled to client's account from Payrix.
This is the amount that will appear on a Bank Statement or Feed that can be automatically reconciled against Invoices.
API Name | Type | Description |
---|---|---|
EventDateTime__c | datetime | The date and time of the settlement event. |
EventType__c | Picklist | “Settled” when settlement has occurred. |
CurrencyCode__c | text (3) | The currency code for the amount settled, as per standard Salesforce currency codes. |
AmountSettled__c | number (16,2) | The total amount settled to the business that receives the payments for invoices. |
SettlementReference__c | text (100) | The internal Payrix settlement reference, to allow reconciliation with non-Payrix services. |