| account_id |
String |
The ID of the account associated with this refund. Specify a value for this field only if you're creating an electronic non-referenced refund. Don't specify a value for any other type of refund; Zuora associates the refund automatically with the account from the associated payment. Character limit: 32 Values: a valid account ID |
[optional] |
| accounting_code |
String |
The accounting code for the payment or invoice line item that the refund applies to. If there is no accounting code, then this value is null. Accounting codes group transactions that contain similar accounting attributes. Character limit: 50 Values: automatically generated |
[optional] |
| amount |
Float |
The amount of the refund. The amount can't exceed the amount of the associated payment. If the original payment was applied to a single invoice, then you can create a partial refund. However, if the payment was applies to multiple invoices, then you can only make a partial refund through the web-based UI, not through the API. Character limit: 16 Values: a valid currency amount |
[optional] |
| cancelled_on |
DateTime |
The date the refund was cancelled. Values: automatically generated |
[optional] |
| comment |
String |
Use this field to record comments about the refund. Character limit: 255 Values: a string of 255 characters or fewer |
[optional] |
| created_by_id |
String |
The ID of the Zuora user who created the `Refund` object. Character limit: 32 Values: automatically generated |
[optional] |
| created_date |
DateTime |
The date when the `Refund` object was created. Character limit: 29 Values: automatically generated |
[optional] |
| gateway |
String |
The gateway that processed the original payment. Zuora uses this same gateway for the corresponding refund. If this payment gateway is no longer active, then the electronic refund fails. A gateway is an online service provider that connects an online shopping cart to a payment processor. Values: automatically inherited from the `Payment` object |
[optional] |
| gateway_response |
String |
The message returned from the payment gateway for the refund. This message is gateway-dependent. Character limit: 500 Values: automatically generated |
[optional] |
| gateway_response_code |
String |
The code returned from the payment gateway for the payment. This code is gateway-dependent. Character limit: 20 System****Values: automatically generated |
[optional] |
| gateway_state |
String |
The status of the payment in the gateway. Character limit: 19 Values: automatically generated |
[optional] |
| id |
String |
Object identifier. |
[optional] |
| marked_for_submission_on |
DateTime |
The date when a payment was marked and waiting for batch submission to the payment process. Character limit: 29 Values: automatically generated |
[optional] |
| method_type |
String |
Indicates how an external refund was issued to a customer. This field is required for an external refund. You can issue an external refund on an electronic payment. Character limit: 30 Values: - `ACH` - `Cash` - `Check` - `CreditCard` - `Other` - `PayPal` - `WireTransfer` - `DebitCard` - `CreditCardReferenceTransaction` |
[optional] |
| payment_method_id |
String |
The unique ID of the payment method that the customer used to make the payment. Specify a value for this field only if you're creating an electronic non-referenced refund. Character limit: 32 V****alues: a valid payment method ID |
[optional] |
| payment_method_snapshot_id |
String |
The unique ID of the payment method snapshot which is a copy of the particular Payment Method used in a transaction. Character limit: 32 V****alues: a valid payment method snapshot ID |
[optional] |
| reason_code |
String |
A code identifying the reason for the transaction. Must be an existing reason code or empty. If you do not specify a value, Zuora uses the default reason code. Character limit: 32 V****alues: a valid reason code |
[optional] |
| reference_id |
String |
The transaction ID returned by the payment gateway for an electronic refund. Use this field to reconcile refunds between your gateway and Zuora Payments. Character limit: 60 Values: a string of 60 characters or fewer |
[optional] |
| refund_date |
Date |
The date of the refund, in `yyyy-mm-dd` format. The date of the refund cannot be before the payment date. Specify this field only for external refunds. Zuora automatically generates this field for electronic refunds. Character limit: 29 |
[optional] |
| refund_number |
String |
The unique identifier of the refund. Character limit: 50 Values: automatically generated |
[optional] |
| refund_transaction_time |
DateTime |
The date and time when the refund was issued. Character limit: 29 Values: automatically generated |
[optional] |
| second_refund_reference_id |
String |
The transaction ID returned by the payment gateway if there is an additional transaction for the payment. Use this field to reconcile payments between your gateway and Zuora Payments. Character limit: 60 Values: a string of 60 characters or fewer |
[optional] |
| settled_on |
DateTime |
The date when the payment was settled in the payment processor. This field is used by the Spectrum gateway only and not applicable to other gateways. Character limit: 29 Values: automatically generated |
[optional] |
| soft_descriptor |
String |
A payment gateway-specific field that maps Zuora to other gateways . Character limit: 35 Values: - 3-byte company identifier "" 18-byte descriptor - 7-byte company identifier "" 14-byte descriptor - 12-byte company identifier "*" 9-byte descriptor |
[optional] |
| soft_descriptor_phone |
String |
A payment gateway-specific field that maps Zuora to other gateways . Character limit: 20 Values: - Customer service phone number formatted as: `NNN-NNN-NNNN` or `NNN-AAAAAAA` - URL (non-e-Commerce): Transactions sent with a URL do not qualify for the best interchange rate - Email address |
[optional] |
| source_type |
String |
Specifies whether the refund is a refund payment or a credit balance. This field is required when creating an non-referenced refund. If you creating an non-referenced refund, then set this value to `CreditBalance`. Character limit: 13 Values: - `Payment` - `CreditBalance` |
[optional] |
| status |
String |
The status of the refund. Character limit: 10 Values: automatically generated: - `Canceled` - `Error` - `Processed` - `Processing` |
[optional] |
| submitted_on |
DateTime |
The date when the payment was submitted. Character limit: 29 Values: automatically generated |
[optional] |
| transferred_to_accounting |
String |
Specifies whether or not the object has been transferred to an external accounting system. Use this field for integrations with accounting systems such as NetSuite. Character limit: 10 Values: automatically generated: - `Processing` - `Yes` - `Error` - `Ignore` |
[optional] |
| type |
String |
Specifies if the refund is electronic or external. Character limit: 10 Values: - `Electronic` - External |
[optional] |
| updated_by_id |
String |
The ID of the last user to update the object. Character limit: 32 Values: automatically generated |
[optional] |
| updated_date |
DateTime |
The date when the object was last updated. Character limit: 29 Values: automatically generated |
[optional] |