Skip to content
This repository was archived by the owner on Oct 17, 2023. It is now read-only.

Latest commit

 

History

History
35 lines (32 loc) · 6.34 KB

Refund.md

File metadata and controls

35 lines (32 loc) · 6.34 KB

Bfwd::Refund

Properties

Name Type Description Notes
created DateTime { "description" : "The UTC DateTime when the object was created.", "verbs":[] } [optional]
changed_by String { "description" : "ID of the user who last updated the entity.", "verbs":[] } [optional]
updated DateTime { "description" : "The UTC DateTime when the object was last updated.", "verbs":[] } [optional]
id String { "description" : "", "verbs":["GET", "PUT"] } [optional]
organization_id String { "description" : "", "verbs":[] } [optional]
account_id String { "description" : "Identifier of account to refund.", "verbs":["GET"] } [optional]
reason String { "description" : "The reason for the refund.", "verbs":["GET"] } [optional]
nominal_value Float { "description" : "", "verbs":[] }
value Float { "description" : "Positive decimal representing the total value to refund. This is at most the amount un-refunded on the payment. If amount is the total payment amount is refunded.", "verbs":["POST","GET"] } [optional]
refunded Float { "description" : "Value refunded", "verbs":["GET"] } [optional]
actual_value Float { "description" : "", "verbs":[] }
nominal_refunded_value Float { "description" : "Nominal value refunded.", "verbs":[] }
actual_refunded_value Float { "description" : "Refunded amount", "verbs":[] }
refund_state String { &quot;default&quot; : &quot;AwaitingRefund&quot;, &quot;PUT_description&quot; : &quot;<span class=\&quot;label label-default\&quot;>Pending</span> refunds can be set to <span class=\&quot;label label-default\&quot;>AwaitingRefund</span> to initiate the refund or <span class=\&quot;label label-default\&quot;>Cancelled</span> to stop the refund.&quot;, &quot;description&quot; : &quot;Initially a refund is in the <span class=\&quot;label label-default\&quot;>AwaitingRefund</span> state. Once the funds are successfully returned the state is <span class=\&quot;label label-default\&quot;>Refunded</span>. If the refund fails or is rejected is it set as <span class=\&quot;label label-default\&quot;>Failed</span>. Refunds can be set to a <span class=\&quot;label label-default\&quot;>Pending</span> state to support authorization flows, and will leave the refund pending until updated to <span class=\&quot;label label-default\&quot;>AwaitingRefund</span>. <span class=\&quot;label label-default\&quot;>Cancelled</span> is when a refund will not be executed.&quot;, &quot;verbs&quot;:[&quot;GET&quot;, &quot;POST&quot;, &quot;PUT&quot;] }
refund_type String { &quot;description&quot; : &quot;This is the type of refund. Refunds are associated with either an invoice and payment, a payment or unreferenced.&quot;, &quot;verbs&quot;:[] }
refund_nature String {&quot;default&quot;:&quot;<span class=\&quot;label label-default\&quot;>SingleAttempt</span>&quot;,&quot;description&quot;:The mechanism by which credit is returned to the customer:<br><span class=\&quot;label label-default\&quot;>Void</span> &mdash; The original authorized payment is voided before capture.<br><span class=\&quot;label label-default\&quot;>Refund</span> &mdash; A refund is issued against an already-captured payment.&quot;,&quot;verbs&quot;:[&quot;GET&quot;]}
refund_completed DateTime { &quot;description&quot; : &quot;When the refund was completed&quot;, &quot;verbs&quot;:[&quot;GET&quot;] } [optional]
currency String { &quot;description&quot; : &quot;Currency of the refund specified by a three character ISO 4217 currency code.&quot;, &quot;verbs&quot;:[&quot;GET&quot;] }
payment_method_id String { &quot;description&quot; : &quot;Payment method to refund from&quot;, &quot;verbs&quot;:[&quot;GET&quot;] } [optional]
invoice_payment_id String { &quot;description&quot; : &quot;Invoice payment to refund&quot;, &quot;verbs&quot;:[&quot;POST&quot;, &quot;GET&quot;] } [optional]
refund_invoice_payment_id String { &quot;description&quot; : &quot;&quot;, &quot;verbs&quot;:[] } [optional]
original_payment_id String { &quot;description&quot; : &quot;Original payment being refunded.&quot;, &quot;verbs&quot;:[&quot;GET&quot;] } [optional]
original_gateway_payment_reference String { &quot;description&quot; : &quot;Reference in the gateway to the payment being refunded.&quot;, &quot;verbs&quot;:[&quot;GET&quot;] } [optional]
refund_payment_id String { &quot;description&quot; : &quot;Identifier for the payment used to refund&quot;, &quot;verbs&quot;:[&quot;GET&quot;] } [optional]
invoice_id String { &quot;description&quot; : &quot;Invoice to refund.&quot;, &quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;] } [optional]
receipt_id String { &quot;description&quot; : &quot;ID of the receipt for this refund.&quot;, &quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;] } [optional]
original_receipt_id String { &quot;description&quot; : &quot;ID of the receipt for the successful payment that this entity refunds.&quot;, &quot;verbs&quot;:[&quot;POST&quot;,&quot;GET&quot;] } [optional]
created_by String { &quot;description&quot; : &quot;Refund requested by this account&quot;, &quot;verbs&quot;:[&quot;GET&quot;] } [optional]