For the complete documentation index, see llms.txt. This page is also available as Markdown.

Payment Modifications

Void authorization

post
/api/v2/transactions/{id}/void

Void/Cancel an authorization hold on a payment. Check the documentation in order to verify what payment method allows for this payment modification.

Authorizations
AuthorizationstringRequired
Path parameters
idstringRequired

Original transaction id to cancel / void.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
Responses
201

Ecommerce Payment Result

application/json
idstring · uuid-flexibleOptional

The ID of the transaction.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
payment_provider_contractstring · uuid-flexibleOptional

The identifier of payment provider contract you want to process the transaction request with.

Example: 30b8bec8-5042-4e67-939c-5453fbe41711
amountintegerOptional

Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details. For Account Verification transactions, provide 0 as value for this field.

Example: 0
blockedbooleanOptional

True if the transaction has been blocked by a ruleset, false otherwise

created_atstring · date-timeOptional

The time at which the transaction was created.

customerstringOptional

The ID of a customer

invoice_numberstring · max: 127Optional

Optional. The invoice number to track this payment.

merchant_referencestringOptional

A reference specified by the merchant to identify the transaction

payment_productstringOptional

The payment product corresponding to this transaction

payment_product_typestringOptional

The name of the processor used for this transaction

processor_referencestringOptional

Reference identifying the transaction, as provided by the processor.

processor_detailsobjectOptional

Stores all details specific for the processor of the transaction.

statusstring · enumOptional

The outcome of the payment request.

Example: AUTHORIZEDPossible values:
status_reasonstringOptional

Message provided by the 3rd party service as additional information, when the transaction does not succeed.

arnstringOptional

Acquirer reference number. Generated by the Acquirer at the time of clearing for card transactions.

authorization_codestring · max: 6Optional
  • When the payment is authorized successfully, this field holds the authorization code for the payment.

  • When the payment is not authorized, this field is not returned.

Example: 5B1D4C
avs_resultstring · enumOptional

Address verification services result, which provides information about the outcome of the AVS check. The full list of codes and descriptions can be found here

Example: APossible values:
cardstringOptional

The token representing the payment card

created_bystringOptional

The ID of the user who initiated the transaction. Only set when shopper_interaction = moto, mail_order or telephone_order

cvv_presentbooleanOptional

True if the card was used with a cvv

cvv_resultstring · enumOptional

The CVC verification result, which provides information about the outcome of the CVC check.

CVC-CVV result codes:

  • 0 Unknown
  • 1 Matches.
  • 2 Doesn't match.
  • 3 Not checked.
  • 4 No CVC/CVV provided, but was required.
  • 5 Issuer not certified for CVC/CVV.
  • 6 No CVC/CVV provided.

The following are included only for backwards compatibility. They are deprecated and will be removed in the next major release. The client must take action now to ensure ongoing support.

  • M Match
  • Y Match
  • N No Match
  • P Not Processed
  • S CVV Should be present, but Merchant indicates not present.
  • U Issuer not certified or registered to process card verification.
Example: 1Possible values:
cavv_resultstring · enumOptional

This field will be populated for any Verified by Visa transaction and AVV Authorisation message sent by MasterCard SecureCode: This includes CAVV and AEVV from American Express SafeKey.

CAVV Transaction Response Code Values:

  • 0 CAVV or AEVV Not Validated due to erroneous data submitted.

  • 1 CAVV or AEVV Failed Validation - Authentication Transaction. This is an indication of potential bad or fraudulent data submitted.

  • 2 CAVV or AEVV Passed Validation – Authentication Transaction.

  • 3 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (Determined that the Issuer ACS generated this value from the use of the Issuer’s CAVV/AEVV key[s]).

  • 4 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (Determined that Visa generated this value from the use of CAVV/AEVV key[s]).

  • 5 Reserved.

  • 6 CAVV or AEVV Not Validated – Issuer not participated. This value is generated when an Issuer requests the do not verify flag to be established for its BINs. This parameter enables an Issuer to temporarily stop CAVV/AEVV verification while resolving CAVV/AEVV key issues. VisaNet processes this value as a valid CAVV/AEVV.

  • 7 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • 8 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key).

  • 9 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • 99 An unknown value was returned from the processor.

  • A CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • B CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • C CAVV or AEVV Not Validated – Attempted Authentication Transaction. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • D CAVV or AEVV Not Validated – Authentication. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • I Invalid Security Data.

  • U Issuer does not participate or 3-D Secure data not utilised.

  • NA Blank CAVV or AEVV Not Present.

Example: 99Possible values:
reason_codestring · max: 4Optional

A reason code assigned by the acquiring platform; '0000' in case of success

rrnstring · max: 12Optional

A client (user friendly) identifier for the transaction generated at the outset of a business event. The format will be dependent on the calling system.

A reference supplied by the system retaining the original source information and used to assist in locating that transaction or a copy of the transaction. This value is critical in matching values that are sent to other Payment processors or Acquirers. This value would correspond to the ISO8583 specification as RRN in attribute DE 37, which limits the value to being an alphanumeric value 12 characters.

For the GSC client android application the format will correspond to YYMMdd<stan 6 digits>.

Example: 200211654321
shopper_interactionstring · enumOptional

Determines the point of sale of a customer. Possible values: pos, moto, mail_order, telephone_order, ecommerce and cont_auth

Possible values:
stanstringOptional

System Trace Audit Number.

reversal_statusstring · enumOptional

Indicates to the API client if a technical reversal has been completed by Verifone.

Default: NONEPossible values:
geo_locationnumber[]Optional

The latitude / longitude resolved from the customer's ip address.

Example: ["52.370216","4.895168"]
citystringOptional

The city resolved from the customer's ip address.

Example: West Roxbury
country_codestringOptional

The country code resolved from the customer's ip address.

Example: US
promo_codestringOptional

A code defined by the merchant that affects the calculation of the total amount.

purchase_order_numberstring · max: 17Optional

The purchase order number. It can be provided in transactions with purchase or procurement cards for the cardholder to get better interchange rates (note that this functionality needs alignment with the acquirer and the scheme). This field is part of so-called Level 2 data.

balance_amountintegerOptional

Balance amount is the amount remaining on a card or account of cardholder without a decimal place e.g. $1.5 = 150.

The required number of decimal places for a currency code is according to ISO 4217. However the following table takes precedence over ISO 4217:

post
/api/v2/transactions/{id}/void

Complete a Klarna payment

post
/api/v2/transactions/{id}/klarna_complete

A customer has completed a purchase and want to create the associated order in the system.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idstring · uuid-flexibleRequired

The ID of the transaction.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
Header parameters
x-vfi-api-idempotencyKeystringOptional
Body
authorization_tokenstringOptional

Token used for authorizing a payment transaction.

refusal_reasonstring · enumOptional

The reason a transaction has been refused within the payment ecosystem by the client/Verifone/acquirer. This needs to be set by the component that is refusing this transaction request.

Possible values:
merchant_referencestring · max: 50Optional

A reference specified by the merchant to identify the transaction.

Example: 7a1db7a8-6f24-4bc5-a51b-cef33fc05140
Responses
post
/api/v2/transactions/{id}/klarna_complete

Adjust the preauth transaction amount

post
/api/v2/transactions/{id}/adjust

Allows for the modification of the amount of a previously initiated preauthorization before it is captured.

Authorizations
AuthorizationstringRequired
Path parameters
idstringRequired

Original transaction id to adjust.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
Body
amountintegerRequired

Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, refer to the Currencies documentation for more details. The amount provided determines the type of adjustment. If it is greater than the original pre-authorization amount, it is treated as an increment. If it is less than the original pre-authorization amount, it is treated as a decrement. To fully void a transaction after an increment, set the amount to 0.

Example: 150
reasonstringOptional

The reason of the adjust.

Responses
201

Ecommerce Payment Result

application/json
idstring · uuid-flexibleOptional

The ID of the transaction.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
payment_provider_contractstring · uuid-flexibleOptional

The identifier of payment provider contract you want to process the transaction request with.

Example: 30b8bec8-5042-4e67-939c-5453fbe41711
amountintegerOptional

Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details. For Account Verification transactions, provide 0 as value for this field.

Example: 0
blockedbooleanOptional

True if the transaction has been blocked by a ruleset, false otherwise

created_atstring · date-timeOptional

The time at which the transaction was created.

customerstringOptional

The ID of a customer

invoice_numberstring · max: 127Optional

Optional. The invoice number to track this payment.

merchant_referencestringOptional

A reference specified by the merchant to identify the transaction

payment_productstringOptional

The payment product corresponding to this transaction

payment_product_typestringOptional

The name of the processor used for this transaction

processor_referencestringOptional

Reference identifying the transaction, as provided by the processor.

processor_detailsobjectOptional

Stores all details specific for the processor of the transaction.

statusstring · enumOptional

The outcome of the payment request.

Example: AUTHORIZEDPossible values:
status_reasonstringOptional

Message provided by the 3rd party service as additional information, when the transaction does not succeed.

arnstringOptional

Acquirer reference number. Generated by the Acquirer at the time of clearing for card transactions.

authorization_codestring · max: 6Optional
  • When the payment is authorized successfully, this field holds the authorization code for the payment.

  • When the payment is not authorized, this field is not returned.

Example: 5B1D4C
avs_resultstring · enumOptional

Address verification services result, which provides information about the outcome of the AVS check. The full list of codes and descriptions can be found here

Example: APossible values:
cardstringOptional

The token representing the payment card

created_bystringOptional

The ID of the user who initiated the transaction. Only set when shopper_interaction = moto, mail_order or telephone_order

cvv_presentbooleanOptional

True if the card was used with a cvv

cvv_resultstring · enumOptional

The CVC verification result, which provides information about the outcome of the CVC check.

CVC-CVV result codes:

  • 0 Unknown
  • 1 Matches.
  • 2 Doesn't match.
  • 3 Not checked.
  • 4 No CVC/CVV provided, but was required.
  • 5 Issuer not certified for CVC/CVV.
  • 6 No CVC/CVV provided.

The following are included only for backwards compatibility. They are deprecated and will be removed in the next major release. The client must take action now to ensure ongoing support.

  • M Match
  • Y Match
  • N No Match
  • P Not Processed
  • S CVV Should be present, but Merchant indicates not present.
  • U Issuer not certified or registered to process card verification.
Example: 1Possible values:
cavv_resultstring · enumOptional

This field will be populated for any Verified by Visa transaction and AVV Authorisation message sent by MasterCard SecureCode: This includes CAVV and AEVV from American Express SafeKey.

CAVV Transaction Response Code Values:

  • 0 CAVV or AEVV Not Validated due to erroneous data submitted.

  • 1 CAVV or AEVV Failed Validation - Authentication Transaction. This is an indication of potential bad or fraudulent data submitted.

  • 2 CAVV or AEVV Passed Validation – Authentication Transaction.

  • 3 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (Determined that the Issuer ACS generated this value from the use of the Issuer’s CAVV/AEVV key[s]).

  • 4 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (Determined that Visa generated this value from the use of CAVV/AEVV key[s]).

  • 5 Reserved.

  • 6 CAVV or AEVV Not Validated – Issuer not participated. This value is generated when an Issuer requests the do not verify flag to be established for its BINs. This parameter enables an Issuer to temporarily stop CAVV/AEVV verification while resolving CAVV/AEVV key issues. VisaNet processes this value as a valid CAVV/AEVV.

  • 7 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • 8 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key).

  • 9 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • 99 An unknown value was returned from the processor.

  • A CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • B CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • C CAVV or AEVV Not Validated – Attempted Authentication Transaction. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • D CAVV or AEVV Not Validated – Authentication. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • I Invalid Security Data.

  • U Issuer does not participate or 3-D Secure data not utilised.

  • NA Blank CAVV or AEVV Not Present.

Example: 99Possible values:
reason_codestring · max: 4Optional

A reason code assigned by the acquiring platform; '0000' in case of success

rrnstring · max: 12Optional

A client (user friendly) identifier for the transaction generated at the outset of a business event. The format will be dependent on the calling system.

A reference supplied by the system retaining the original source information and used to assist in locating that transaction or a copy of the transaction. This value is critical in matching values that are sent to other Payment processors or Acquirers. This value would correspond to the ISO8583 specification as RRN in attribute DE 37, which limits the value to being an alphanumeric value 12 characters.

For the GSC client android application the format will correspond to YYMMdd<stan 6 digits>.

Example: 200211654321
shopper_interactionstring · enumOptional

Determines the point of sale of a customer. Possible values: pos, moto, mail_order, telephone_order, ecommerce and cont_auth

Possible values:
stanstringOptional

System Trace Audit Number.

reversal_statusstring · enumOptional

Indicates to the API client if a technical reversal has been completed by Verifone.

Default: NONEPossible values:
geo_locationnumber[]Optional

The latitude / longitude resolved from the customer's ip address.

Example: ["52.370216","4.895168"]
citystringOptional

The city resolved from the customer's ip address.

Example: West Roxbury
country_codestringOptional

The country code resolved from the customer's ip address.

Example: US
promo_codestringOptional

A code defined by the merchant that affects the calculation of the total amount.

purchase_order_numberstring · max: 17Optional

The purchase order number. It can be provided in transactions with purchase or procurement cards for the cardholder to get better interchange rates (note that this functionality needs alignment with the acquirer and the scheme). This field is part of so-called Level 2 data.

balance_amountintegerOptional

Balance amount is the amount remaining on a card or account of cardholder without a decimal place e.g. $1.5 = 150.

The required number of decimal places for a currency code is according to ISO 4217. However the following table takes precedence over ISO 4217:

post
/api/v2/transactions/{id}/adjust

Capture authorization

post
/api/v2/transactions/{id}/capture

Capture an authorization hold on a payment. Check the documentation in order to verify what payment method allows for this payment modification.

Authorizations
AuthorizationstringRequired
Path parameters
idstringRequired

Original transaction id to capture.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
Body
amountintegerRequired

Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details. For Account Verification transactions, provide 0 as value for this field.

Example: 150
purchase_order_numberstring · max: 17Optional

The purchase order number. It can be provided in transactions with purchase or procurement cards for the cardholder to get better interchange rates (note that this functionality needs alignment with the acquirer and the scheme). This field is part of so-called Level 2 data.

tax_indicatorstring · enumOptional

This field indicates the taxable status of the transaction (if any of the purchased items are taxable). This field is part of so-called Level 2 data. If the value TAX_PROVIDED is sent, tax_amount should also be provided

Default: TAX_NOT_PROVIDEDPossible values:
receipt_typestring · enumOptional

Defines the type of receipt to be generated

Possible values:
Responses
201

Ecommerce Payment Result

application/json
idstring · uuid-flexibleOptional

The ID of the transaction.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
payment_provider_contractstring · uuid-flexibleOptional

The identifier of payment provider contract you want to process the transaction request with.

Example: 30b8bec8-5042-4e67-939c-5453fbe41711
amountintegerOptional

Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details. For Account Verification transactions, provide 0 as value for this field.

Example: 0
blockedbooleanOptional

True if the transaction has been blocked by a ruleset, false otherwise

created_atstring · date-timeOptional

The time at which the transaction was created.

customerstringOptional

The ID of a customer

invoice_numberstring · max: 127Optional

Optional. The invoice number to track this payment.

merchant_referencestringOptional

A reference specified by the merchant to identify the transaction

payment_productstringOptional

The payment product corresponding to this transaction

payment_product_typestringOptional

The name of the processor used for this transaction

processor_referencestringOptional

Reference identifying the transaction, as provided by the processor.

processor_detailsobjectOptional

Stores all details specific for the processor of the transaction.

statusstring · enumOptional

The outcome of the payment request.

Example: AUTHORIZEDPossible values:
status_reasonstringOptional

Message provided by the 3rd party service as additional information, when the transaction does not succeed.

arnstringOptional

Acquirer reference number. Generated by the Acquirer at the time of clearing for card transactions.

authorization_codestring · max: 6Optional
  • When the payment is authorized successfully, this field holds the authorization code for the payment.

  • When the payment is not authorized, this field is not returned.

Example: 5B1D4C
avs_resultstring · enumOptional

Address verification services result, which provides information about the outcome of the AVS check. The full list of codes and descriptions can be found here

Example: APossible values:
cardstringOptional

The token representing the payment card

created_bystringOptional

The ID of the user who initiated the transaction. Only set when shopper_interaction = moto, mail_order or telephone_order

cvv_presentbooleanOptional

True if the card was used with a cvv

cvv_resultstring · enumOptional

The CVC verification result, which provides information about the outcome of the CVC check.

CVC-CVV result codes:

  • 0 Unknown
  • 1 Matches.
  • 2 Doesn't match.
  • 3 Not checked.
  • 4 No CVC/CVV provided, but was required.
  • 5 Issuer not certified for CVC/CVV.
  • 6 No CVC/CVV provided.

The following are included only for backwards compatibility. They are deprecated and will be removed in the next major release. The client must take action now to ensure ongoing support.

  • M Match
  • Y Match
  • N No Match
  • P Not Processed
  • S CVV Should be present, but Merchant indicates not present.
  • U Issuer not certified or registered to process card verification.
Example: 1Possible values:
cavv_resultstring · enumOptional

This field will be populated for any Verified by Visa transaction and AVV Authorisation message sent by MasterCard SecureCode: This includes CAVV and AEVV from American Express SafeKey.

CAVV Transaction Response Code Values:

  • 0 CAVV or AEVV Not Validated due to erroneous data submitted.

  • 1 CAVV or AEVV Failed Validation - Authentication Transaction. This is an indication of potential bad or fraudulent data submitted.

  • 2 CAVV or AEVV Passed Validation – Authentication Transaction.

  • 3 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (Determined that the Issuer ACS generated this value from the use of the Issuer’s CAVV/AEVV key[s]).

  • 4 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (Determined that Visa generated this value from the use of CAVV/AEVV key[s]).

  • 5 Reserved.

  • 6 CAVV or AEVV Not Validated – Issuer not participated. This value is generated when an Issuer requests the do not verify flag to be established for its BINs. This parameter enables an Issuer to temporarily stop CAVV/AEVV verification while resolving CAVV/AEVV key issues. VisaNet processes this value as a valid CAVV/AEVV.

  • 7 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • 8 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key).

  • 9 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • 99 An unknown value was returned from the processor.

  • A CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • B CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • C CAVV or AEVV Not Validated – Attempted Authentication Transaction. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • D CAVV or AEVV Not Validated – Authentication. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • I Invalid Security Data.

  • U Issuer does not participate or 3-D Secure data not utilised.

  • NA Blank CAVV or AEVV Not Present.

Example: 99Possible values:
reason_codestring · max: 4Optional

A reason code assigned by the acquiring platform; '0000' in case of success

rrnstring · max: 12Optional

A client (user friendly) identifier for the transaction generated at the outset of a business event. The format will be dependent on the calling system.

A reference supplied by the system retaining the original source information and used to assist in locating that transaction or a copy of the transaction. This value is critical in matching values that are sent to other Payment processors or Acquirers. This value would correspond to the ISO8583 specification as RRN in attribute DE 37, which limits the value to being an alphanumeric value 12 characters.

For the GSC client android application the format will correspond to YYMMdd<stan 6 digits>.

Example: 200211654321
shopper_interactionstring · enumOptional

Determines the point of sale of a customer. Possible values: pos, moto, mail_order, telephone_order, ecommerce and cont_auth

Possible values:
stanstringOptional

System Trace Audit Number.

reversal_statusstring · enumOptional

Indicates to the API client if a technical reversal has been completed by Verifone.

Default: NONEPossible values:
geo_locationnumber[]Optional

The latitude / longitude resolved from the customer's ip address.

Example: ["52.370216","4.895168"]
citystringOptional

The city resolved from the customer's ip address.

Example: West Roxbury
country_codestringOptional

The country code resolved from the customer's ip address.

Example: US
promo_codestringOptional

A code defined by the merchant that affects the calculation of the total amount.

purchase_order_numberstring · max: 17Optional

The purchase order number. It can be provided in transactions with purchase or procurement cards for the cardholder to get better interchange rates (note that this functionality needs alignment with the acquirer and the scheme). This field is part of so-called Level 2 data.

balance_amountintegerOptional

Balance amount is the amount remaining on a card or account of cardholder without a decimal place e.g. $1.5 = 150.

The required number of decimal places for a currency code is according to ISO 4217. However the following table takes precedence over ISO 4217:

post
/api/v2/transactions/{id}/capture

Refund payment

post
/api/v2/transactions/{id}/refund

Refund a payment that has previously been captured.

Authorizations
AuthorizationstringRequired
Path parameters
idstringRequired

Original transaction id to refund.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
Header parameters
x-vfi-api-idempotencykeystring · uuidOptional

Note: This value is required to process a refund for an Affirm payment.

Example: 63bbc548-d2de-4546-b106-880a5018461c
Body
amountintegerRequired

Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details. For Account Verification transactions, provide 0 as value for this field.

Example: 150
reasonstringOptional

The reason of the refund.

tax_indicatorstring · enumOptional

This field indicates the taxable status of the transaction (if any of the purchased items are taxable). This field is part of so-called Level 2 data. If the value TAX_PROVIDED is sent, tax_amount should also be provided

Default: TAX_NOT_PROVIDEDPossible values:
promo_codestringOptional

A code defined by the merchant that affects the calculation of the total amount.

purchase_order_numberstring · max: 17Optional

The purchase order number. It can be provided in transactions with purchase or procurement cards for the cardholder to get better interchange rates (note that this functionality needs alignment with the acquirer and the scheme). This field is part of so-called Level 2 data.

receipt_typestring · enumOptional

Defines the type of receipt to be generated

Possible values:
Responses
201

Ecommerce Payment Result

application/json
idstring · uuid-flexibleOptional

The ID of the transaction.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
payment_provider_contractstring · uuid-flexibleOptional

The identifier of payment provider contract you want to process the transaction request with.

Example: 30b8bec8-5042-4e67-939c-5453fbe41711
amountintegerOptional

Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details. For Account Verification transactions, provide 0 as value for this field.

Example: 0
blockedbooleanOptional

True if the transaction has been blocked by a ruleset, false otherwise

created_atstring · date-timeOptional

The time at which the transaction was created.

customerstringOptional

The ID of a customer

invoice_numberstring · max: 127Optional

Optional. The invoice number to track this payment.

merchant_referencestringOptional

A reference specified by the merchant to identify the transaction

payment_productstringOptional

The payment product corresponding to this transaction

payment_product_typestringOptional

The name of the processor used for this transaction

processor_referencestringOptional

Reference identifying the transaction, as provided by the processor.

processor_detailsobjectOptional

Stores all details specific for the processor of the transaction.

statusstring · enumOptional

The outcome of the payment request.

Example: AUTHORIZEDPossible values:
status_reasonstringOptional

Message provided by the 3rd party service as additional information, when the transaction does not succeed.

arnstringOptional

Acquirer reference number. Generated by the Acquirer at the time of clearing for card transactions.

authorization_codestring · max: 6Optional
  • When the payment is authorized successfully, this field holds the authorization code for the payment.

  • When the payment is not authorized, this field is not returned.

Example: 5B1D4C
avs_resultstring · enumOptional

Address verification services result, which provides information about the outcome of the AVS check. The full list of codes and descriptions can be found here

Example: APossible values:
cardstringOptional

The token representing the payment card

created_bystringOptional

The ID of the user who initiated the transaction. Only set when shopper_interaction = moto, mail_order or telephone_order

cvv_presentbooleanOptional

True if the card was used with a cvv

cvv_resultstring · enumOptional

The CVC verification result, which provides information about the outcome of the CVC check.

CVC-CVV result codes:

  • 0 Unknown
  • 1 Matches.
  • 2 Doesn't match.
  • 3 Not checked.
  • 4 No CVC/CVV provided, but was required.
  • 5 Issuer not certified for CVC/CVV.
  • 6 No CVC/CVV provided.

The following are included only for backwards compatibility. They are deprecated and will be removed in the next major release. The client must take action now to ensure ongoing support.

  • M Match
  • Y Match
  • N No Match
  • P Not Processed
  • S CVV Should be present, but Merchant indicates not present.
  • U Issuer not certified or registered to process card verification.
Example: 1Possible values:
cavv_resultstring · enumOptional

This field will be populated for any Verified by Visa transaction and AVV Authorisation message sent by MasterCard SecureCode: This includes CAVV and AEVV from American Express SafeKey.

CAVV Transaction Response Code Values:

  • 0 CAVV or AEVV Not Validated due to erroneous data submitted.

  • 1 CAVV or AEVV Failed Validation - Authentication Transaction. This is an indication of potential bad or fraudulent data submitted.

  • 2 CAVV or AEVV Passed Validation – Authentication Transaction.

  • 3 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (Determined that the Issuer ACS generated this value from the use of the Issuer’s CAVV/AEVV key[s]).

  • 4 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (Determined that Visa generated this value from the use of CAVV/AEVV key[s]).

  • 5 Reserved.

  • 6 CAVV or AEVV Not Validated – Issuer not participated. This value is generated when an Issuer requests the do not verify flag to be established for its BINs. This parameter enables an Issuer to temporarily stop CAVV/AEVV verification while resolving CAVV/AEVV key issues. VisaNet processes this value as a valid CAVV/AEVV.

  • 7 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • 8 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key).

  • 9 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • 99 An unknown value was returned from the processor.

  • A CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • B CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • C CAVV or AEVV Not Validated – Attempted Authentication Transaction. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • D CAVV or AEVV Not Validated – Authentication. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • I Invalid Security Data.

  • U Issuer does not participate or 3-D Secure data not utilised.

  • NA Blank CAVV or AEVV Not Present.

Example: 99Possible values:
reason_codestring · max: 4Optional

A reason code assigned by the acquiring platform; '0000' in case of success

rrnstring · max: 12Optional

A client (user friendly) identifier for the transaction generated at the outset of a business event. The format will be dependent on the calling system.

A reference supplied by the system retaining the original source information and used to assist in locating that transaction or a copy of the transaction. This value is critical in matching values that are sent to other Payment processors or Acquirers. This value would correspond to the ISO8583 specification as RRN in attribute DE 37, which limits the value to being an alphanumeric value 12 characters.

For the GSC client android application the format will correspond to YYMMdd<stan 6 digits>.

Example: 200211654321
shopper_interactionstring · enumOptional

Determines the point of sale of a customer. Possible values: pos, moto, mail_order, telephone_order, ecommerce and cont_auth

Possible values:
stanstringOptional

System Trace Audit Number.

reversal_statusstring · enumOptional

Indicates to the API client if a technical reversal has been completed by Verifone.

Default: NONEPossible values:
geo_locationnumber[]Optional

The latitude / longitude resolved from the customer's ip address.

Example: ["52.370216","4.895168"]
citystringOptional

The city resolved from the customer's ip address.

Example: West Roxbury
country_codestringOptional

The country code resolved from the customer's ip address.

Example: US
promo_codestringOptional

A code defined by the merchant that affects the calculation of the total amount.

purchase_order_numberstring · max: 17Optional

The purchase order number. It can be provided in transactions with purchase or procurement cards for the cardholder to get better interchange rates (note that this functionality needs alignment with the acquirer and the scheme). This field is part of so-called Level 2 data.

balance_amountintegerOptional

Balance amount is the amount remaining on a card or account of cardholder without a decimal place e.g. $1.5 = 150.

The required number of decimal places for a currency code is according to ISO 4217. However the following table takes precedence over ISO 4217:

post
/api/v2/transactions/{id}/refund

Unmatched refund

post
/api/v2/transactions/refund

Refund a cardholder with an amount not related to a previous transaction.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
or
Responses
201

Ecommerce Payment Result

application/json
idstring · uuid-flexibleOptional

The ID of the transaction.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
payment_provider_contractstring · uuid-flexibleOptional

The identifier of payment provider contract you want to process the transaction request with.

Example: 30b8bec8-5042-4e67-939c-5453fbe41711
amountintegerOptional

Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details. For Account Verification transactions, provide 0 as value for this field.

Example: 0
blockedbooleanOptional

True if the transaction has been blocked by a ruleset, false otherwise

created_atstring · date-timeOptional

The time at which the transaction was created.

customerstringOptional

The ID of a customer

invoice_numberstring · max: 127Optional

Optional. The invoice number to track this payment.

merchant_referencestringOptional

A reference specified by the merchant to identify the transaction

payment_productstringOptional

The payment product corresponding to this transaction

payment_product_typestringOptional

The name of the processor used for this transaction

processor_referencestringOptional

Reference identifying the transaction, as provided by the processor.

processor_detailsobjectOptional

Stores all details specific for the processor of the transaction.

statusstring · enumOptional

The outcome of the payment request.

Example: AUTHORIZEDPossible values:
status_reasonstringOptional

Message provided by the 3rd party service as additional information, when the transaction does not succeed.

arnstringOptional

Acquirer reference number. Generated by the Acquirer at the time of clearing for card transactions.

authorization_codestring · max: 6Optional
  • When the payment is authorized successfully, this field holds the authorization code for the payment.

  • When the payment is not authorized, this field is not returned.

Example: 5B1D4C
avs_resultstring · enumOptional

Address verification services result, which provides information about the outcome of the AVS check. The full list of codes and descriptions can be found here

Example: APossible values:
cardstringOptional

The token representing the payment card

created_bystringOptional

The ID of the user who initiated the transaction. Only set when shopper_interaction = moto, mail_order or telephone_order

cvv_presentbooleanOptional

True if the card was used with a cvv

cvv_resultstring · enumOptional

The CVC verification result, which provides information about the outcome of the CVC check.

CVC-CVV result codes:

  • 0 Unknown
  • 1 Matches.
  • 2 Doesn't match.
  • 3 Not checked.
  • 4 No CVC/CVV provided, but was required.
  • 5 Issuer not certified for CVC/CVV.
  • 6 No CVC/CVV provided.

The following are included only for backwards compatibility. They are deprecated and will be removed in the next major release. The client must take action now to ensure ongoing support.

  • M Match
  • Y Match
  • N No Match
  • P Not Processed
  • S CVV Should be present, but Merchant indicates not present.
  • U Issuer not certified or registered to process card verification.
Example: 1Possible values:
cavv_resultstring · enumOptional

This field will be populated for any Verified by Visa transaction and AVV Authorisation message sent by MasterCard SecureCode: This includes CAVV and AEVV from American Express SafeKey.

CAVV Transaction Response Code Values:

  • 0 CAVV or AEVV Not Validated due to erroneous data submitted.

  • 1 CAVV or AEVV Failed Validation - Authentication Transaction. This is an indication of potential bad or fraudulent data submitted.

  • 2 CAVV or AEVV Passed Validation – Authentication Transaction.

  • 3 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (Determined that the Issuer ACS generated this value from the use of the Issuer’s CAVV/AEVV key[s]).

  • 4 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (Determined that Visa generated this value from the use of CAVV/AEVV key[s]).

  • 5 Reserved.

  • 6 CAVV or AEVV Not Validated – Issuer not participated. This value is generated when an Issuer requests the do not verify flag to be established for its BINs. This parameter enables an Issuer to temporarily stop CAVV/AEVV verification while resolving CAVV/AEVV key issues. VisaNet processes this value as a valid CAVV/AEVV.

  • 7 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • 8 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key).

  • 9 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • 99 An unknown value was returned from the processor.

  • A CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • B CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • C CAVV or AEVV Not Validated – Attempted Authentication Transaction. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • D CAVV or AEVV Not Validated – Authentication. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • I Invalid Security Data.

  • U Issuer does not participate or 3-D Secure data not utilised.

  • NA Blank CAVV or AEVV Not Present.

Example: 99Possible values:
reason_codestring · max: 4Optional

A reason code assigned by the acquiring platform; '0000' in case of success

rrnstring · max: 12Optional

A client (user friendly) identifier for the transaction generated at the outset of a business event. The format will be dependent on the calling system.

A reference supplied by the system retaining the original source information and used to assist in locating that transaction or a copy of the transaction. This value is critical in matching values that are sent to other Payment processors or Acquirers. This value would correspond to the ISO8583 specification as RRN in attribute DE 37, which limits the value to being an alphanumeric value 12 characters.

For the GSC client android application the format will correspond to YYMMdd<stan 6 digits>.

Example: 200211654321
shopper_interactionstring · enumOptional

Determines the point of sale of a customer. Possible values: pos, moto, mail_order, telephone_order, ecommerce and cont_auth

Possible values:
stanstringOptional

System Trace Audit Number.

reversal_statusstring · enumOptional

Indicates to the API client if a technical reversal has been completed by Verifone.

Default: NONEPossible values:
geo_locationnumber[]Optional

The latitude / longitude resolved from the customer's ip address.

Example: ["52.370216","4.895168"]
citystringOptional

The city resolved from the customer's ip address.

Example: West Roxbury
country_codestringOptional

The country code resolved from the customer's ip address.

Example: US
promo_codestringOptional

A code defined by the merchant that affects the calculation of the total amount.

purchase_order_numberstring · max: 17Optional

The purchase order number. It can be provided in transactions with purchase or procurement cards for the cardholder to get better interchange rates (note that this functionality needs alignment with the acquirer and the scheme). This field is part of so-called Level 2 data.

balance_amountintegerOptional

Balance amount is the amount remaining on a card or account of cardholder without a decimal place e.g. $1.5 = 150.

The required number of decimal places for a currency code is according to ISO 4217. However the following table takes precedence over ISO 4217:

post
/api/v2/transactions/refund

Void capture

post
/api/v2/transactions/{id}/void_capture

Cancel a payment that has previously been captured. Void capture can only be done on the full amount of the transaction. Check the documentation to verify what payment method allows for this payment modification.

Authorizations
AuthorizationstringRequired
Path parameters
idstringRequired

Original transaction id to cancel / void the capture.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
Responses
201

Ecommerce Payment Result

application/json
idstring · uuid-flexibleOptional

The ID of the transaction.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
payment_provider_contractstring · uuid-flexibleOptional

The identifier of payment provider contract you want to process the transaction request with.

Example: 30b8bec8-5042-4e67-939c-5453fbe41711
amountintegerOptional

Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details. For Account Verification transactions, provide 0 as value for this field.

Example: 0
blockedbooleanOptional

True if the transaction has been blocked by a ruleset, false otherwise

created_atstring · date-timeOptional

The time at which the transaction was created.

customerstringOptional

The ID of a customer

invoice_numberstring · max: 127Optional

Optional. The invoice number to track this payment.

merchant_referencestringOptional

A reference specified by the merchant to identify the transaction

payment_productstringOptional

The payment product corresponding to this transaction

payment_product_typestringOptional

The name of the processor used for this transaction

processor_referencestringOptional

Reference identifying the transaction, as provided by the processor.

processor_detailsobjectOptional

Stores all details specific for the processor of the transaction.

statusstring · enumOptional

The outcome of the payment request.

Example: AUTHORIZEDPossible values:
status_reasonstringOptional

Message provided by the 3rd party service as additional information, when the transaction does not succeed.

arnstringOptional

Acquirer reference number. Generated by the Acquirer at the time of clearing for card transactions.

authorization_codestring · max: 6Optional
  • When the payment is authorized successfully, this field holds the authorization code for the payment.

  • When the payment is not authorized, this field is not returned.

Example: 5B1D4C
avs_resultstring · enumOptional

Address verification services result, which provides information about the outcome of the AVS check. The full list of codes and descriptions can be found here

Example: APossible values:
cardstringOptional

The token representing the payment card

created_bystringOptional

The ID of the user who initiated the transaction. Only set when shopper_interaction = moto, mail_order or telephone_order

cvv_presentbooleanOptional

True if the card was used with a cvv

cvv_resultstring · enumOptional

The CVC verification result, which provides information about the outcome of the CVC check.

CVC-CVV result codes:

  • 0 Unknown
  • 1 Matches.
  • 2 Doesn't match.
  • 3 Not checked.
  • 4 No CVC/CVV provided, but was required.
  • 5 Issuer not certified for CVC/CVV.
  • 6 No CVC/CVV provided.

The following are included only for backwards compatibility. They are deprecated and will be removed in the next major release. The client must take action now to ensure ongoing support.

  • M Match
  • Y Match
  • N No Match
  • P Not Processed
  • S CVV Should be present, but Merchant indicates not present.
  • U Issuer not certified or registered to process card verification.
Example: 1Possible values:
cavv_resultstring · enumOptional

This field will be populated for any Verified by Visa transaction and AVV Authorisation message sent by MasterCard SecureCode: This includes CAVV and AEVV from American Express SafeKey.

CAVV Transaction Response Code Values:

  • 0 CAVV or AEVV Not Validated due to erroneous data submitted.

  • 1 CAVV or AEVV Failed Validation - Authentication Transaction. This is an indication of potential bad or fraudulent data submitted.

  • 2 CAVV or AEVV Passed Validation – Authentication Transaction.

  • 3 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (Determined that the Issuer ACS generated this value from the use of the Issuer’s CAVV/AEVV key[s]).

  • 4 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (Determined that Visa generated this value from the use of CAVV/AEVV key[s]).

  • 5 Reserved.

  • 6 CAVV or AEVV Not Validated – Issuer not participated. This value is generated when an Issuer requests the do not verify flag to be established for its BINs. This parameter enables an Issuer to temporarily stop CAVV/AEVV verification while resolving CAVV/AEVV key issues. VisaNet processes this value as a valid CAVV/AEVV.

  • 7 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • 8 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key).

  • 9 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • 99 An unknown value was returned from the processor.

  • A CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • B CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • C CAVV or AEVV Not Validated – Attempted Authentication Transaction. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • D CAVV or AEVV Not Validated – Authentication. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • I Invalid Security Data.

  • U Issuer does not participate or 3-D Secure data not utilised.

  • NA Blank CAVV or AEVV Not Present.

Example: 99Possible values:
reason_codestring · max: 4Optional

A reason code assigned by the acquiring platform; '0000' in case of success

rrnstring · max: 12Optional

A client (user friendly) identifier for the transaction generated at the outset of a business event. The format will be dependent on the calling system.

A reference supplied by the system retaining the original source information and used to assist in locating that transaction or a copy of the transaction. This value is critical in matching values that are sent to other Payment processors or Acquirers. This value would correspond to the ISO8583 specification as RRN in attribute DE 37, which limits the value to being an alphanumeric value 12 characters.

For the GSC client android application the format will correspond to YYMMdd<stan 6 digits>.

Example: 200211654321
shopper_interactionstring · enumOptional

Determines the point of sale of a customer. Possible values: pos, moto, mail_order, telephone_order, ecommerce and cont_auth

Possible values:
stanstringOptional

System Trace Audit Number.

reversal_statusstring · enumOptional

Indicates to the API client if a technical reversal has been completed by Verifone.

Default: NONEPossible values:
geo_locationnumber[]Optional

The latitude / longitude resolved from the customer's ip address.

Example: ["52.370216","4.895168"]
citystringOptional

The city resolved from the customer's ip address.

Example: West Roxbury
country_codestringOptional

The country code resolved from the customer's ip address.

Example: US
promo_codestringOptional

A code defined by the merchant that affects the calculation of the total amount.

purchase_order_numberstring · max: 17Optional

The purchase order number. It can be provided in transactions with purchase or procurement cards for the cardholder to get better interchange rates (note that this functionality needs alignment with the acquirer and the scheme). This field is part of so-called Level 2 data.

balance_amountintegerOptional

Balance amount is the amount remaining on a card or account of cardholder without a decimal place e.g. $1.5 = 150.

The required number of decimal places for a currency code is according to ISO 4217. However the following table takes precedence over ISO 4217:

post
/api/v2/transactions/{id}/void_capture

Reverse Transaction

post
/api/v2/transactions/reverse

Allows for technical reversal

Authorizations
AuthorizationstringRequired
Header parameters
x-vfi-api-idempotencykeystringRequired

string(uuid)

Responses
201

Technical Reversal Result

application/json
or
post
/api/v2/transactions/reverse

Release PreAuthorization

post
/api/v2/transactions/{id}/release

Release the rest of preauthorisation which was not captured. This is a one time operation where all remaining funds are released. No further captures are allowed after that. Rest of amount to be released is automatically calculated internally.

Authorizations
AuthorizationstringRequired
Path parameters
idstringRequired

Original preauthorized transaction id to release

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
Header parameters
x-vfi-api-idempotencykeystringOptional

string(uuid)

Example: 63bbc548-d2de-4546-b106-880a5018461c A value you specify that uniquely identifies this transaction. If you're unsure whether a particular transaction succeeded, you can reattempt it with the same idempotency key without worrying about duplicating the transaction.

Body
amountintegerOptional

Amount is charged without a decimal place e.g. $1.5 = 150. The required number of decimal places for a currency code is according to ISO For Account Verification transaction, provide 0 as value for this field.

Responses
201

Ecommerce Payment Result

application/json
idstring · uuid-flexibleOptional

The ID of the transaction.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
payment_provider_contractstring · uuid-flexibleOptional

The identifier of payment provider contract you want to process the transaction request with.

Example: 30b8bec8-5042-4e67-939c-5453fbe41711
amountintegerOptional

Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details. For Account Verification transactions, provide 0 as value for this field.

Example: 0
blockedbooleanOptional

True if the transaction has been blocked by a ruleset, false otherwise

created_atstring · date-timeOptional

The time at which the transaction was created.

customerstringOptional

The ID of a customer

invoice_numberstring · max: 127Optional

Optional. The invoice number to track this payment.

merchant_referencestringOptional

A reference specified by the merchant to identify the transaction

payment_productstringOptional

The payment product corresponding to this transaction

payment_product_typestringOptional

The name of the processor used for this transaction

processor_referencestringOptional

Reference identifying the transaction, as provided by the processor.

processor_detailsobjectOptional

Stores all details specific for the processor of the transaction.

statusstring · enumOptional

The outcome of the payment request.

Example: AUTHORIZEDPossible values:
status_reasonstringOptional

Message provided by the 3rd party service as additional information, when the transaction does not succeed.

arnstringOptional

Acquirer reference number. Generated by the Acquirer at the time of clearing for card transactions.

authorization_codestring · max: 6Optional
  • When the payment is authorized successfully, this field holds the authorization code for the payment.

  • When the payment is not authorized, this field is not returned.

Example: 5B1D4C
avs_resultstring · enumOptional

Address verification services result, which provides information about the outcome of the AVS check. The full list of codes and descriptions can be found here

Example: APossible values:
cardstringOptional

The token representing the payment card

created_bystringOptional

The ID of the user who initiated the transaction. Only set when shopper_interaction = moto, mail_order or telephone_order

cvv_presentbooleanOptional

True if the card was used with a cvv

cvv_resultstring · enumOptional

The CVC verification result, which provides information about the outcome of the CVC check.

CVC-CVV result codes:

  • 0 Unknown
  • 1 Matches.
  • 2 Doesn't match.
  • 3 Not checked.
  • 4 No CVC/CVV provided, but was required.
  • 5 Issuer not certified for CVC/CVV.
  • 6 No CVC/CVV provided.

The following are included only for backwards compatibility. They are deprecated and will be removed in the next major release. The client must take action now to ensure ongoing support.

  • M Match
  • Y Match
  • N No Match
  • P Not Processed
  • S CVV Should be present, but Merchant indicates not present.
  • U Issuer not certified or registered to process card verification.
Example: 1Possible values:
cavv_resultstring · enumOptional

This field will be populated for any Verified by Visa transaction and AVV Authorisation message sent by MasterCard SecureCode: This includes CAVV and AEVV from American Express SafeKey.

CAVV Transaction Response Code Values:

  • 0 CAVV or AEVV Not Validated due to erroneous data submitted.

  • 1 CAVV or AEVV Failed Validation - Authentication Transaction. This is an indication of potential bad or fraudulent data submitted.

  • 2 CAVV or AEVV Passed Validation – Authentication Transaction.

  • 3 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (Determined that the Issuer ACS generated this value from the use of the Issuer’s CAVV/AEVV key[s]).

  • 4 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (Determined that Visa generated this value from the use of CAVV/AEVV key[s]).

  • 5 Reserved.

  • 6 CAVV or AEVV Not Validated – Issuer not participated. This value is generated when an Issuer requests the do not verify flag to be established for its BINs. This parameter enables an Issuer to temporarily stop CAVV/AEVV verification while resolving CAVV/AEVV key issues. VisaNet processes this value as a valid CAVV/AEVV.

  • 7 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • 8 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key).

  • 9 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • 99 An unknown value was returned from the processor.

  • A CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • B CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • C CAVV or AEVV Not Validated – Attempted Authentication Transaction. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • D CAVV or AEVV Not Validated – Authentication. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • I Invalid Security Data.

  • U Issuer does not participate or 3-D Secure data not utilised.

  • NA Blank CAVV or AEVV Not Present.

Example: 99Possible values:
reason_codestring · max: 4Optional

A reason code assigned by the acquiring platform; '0000' in case of success

rrnstring · max: 12Optional

A client (user friendly) identifier for the transaction generated at the outset of a business event. The format will be dependent on the calling system.

A reference supplied by the system retaining the original source information and used to assist in locating that transaction or a copy of the transaction. This value is critical in matching values that are sent to other Payment processors or Acquirers. This value would correspond to the ISO8583 specification as RRN in attribute DE 37, which limits the value to being an alphanumeric value 12 characters.

For the GSC client android application the format will correspond to YYMMdd<stan 6 digits>.

Example: 200211654321
shopper_interactionstring · enumOptional

Determines the point of sale of a customer. Possible values: pos, moto, mail_order, telephone_order, ecommerce and cont_auth

Possible values:
stanstringOptional

System Trace Audit Number.

reversal_statusstring · enumOptional

Indicates to the API client if a technical reversal has been completed by Verifone.

Default: NONEPossible values:
geo_locationnumber[]Optional

The latitude / longitude resolved from the customer's ip address.

Example: ["52.370216","4.895168"]
citystringOptional

The city resolved from the customer's ip address.

Example: West Roxbury
country_codestringOptional

The country code resolved from the customer's ip address.

Example: US
promo_codestringOptional

A code defined by the merchant that affects the calculation of the total amount.

purchase_order_numberstring · max: 17Optional

The purchase order number. It can be provided in transactions with purchase or procurement cards for the cardholder to get better interchange rates (note that this functionality needs alignment with the acquirer and the scheme). This field is part of so-called Level 2 data.

balance_amountintegerOptional

Balance amount is the amount remaining on a card or account of cardholder without a decimal place e.g. $1.5 = 150.

The required number of decimal places for a currency code is according to ISO 4217. However the following table takes precedence over ISO 4217:

post
/api/v2/transactions/{id}/release

Extend preauthorization

post
/api/v2/transactions/{id}/extend

Extend the authorization period and confirm the availability of the funds of a previously initiated preauthorization. If supported by the card brand (like Visa) this operation will be handled as a Reauthorization request.

Authorizations
AuthorizationstringRequired
Path parameters
idstringRequired

Original preauthorized transaction id to release

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
Header parameters
x-vfi-api-idempotencykeystringOptional

string(uuid)

Example: 63bbc548-d2de-4546-b106-880a5018461c A value you specify that uniquely identifies this transaction. If you're unsure whether a particular transaction succeeded, you can reattempt it with the same idempotency key without worrying about duplicating the transaction.

Responses
201

Ecommerce Payment Result

application/json
idstring · uuid-flexibleOptional

The ID of the transaction.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
payment_provider_contractstring · uuid-flexibleOptional

The identifier of payment provider contract you want to process the transaction request with.

Example: 30b8bec8-5042-4e67-939c-5453fbe41711
amountintegerOptional

Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details. For Account Verification transactions, provide 0 as value for this field.

Example: 0
blockedbooleanOptional

True if the transaction has been blocked by a ruleset, false otherwise

created_atstring · date-timeOptional

The time at which the transaction was created.

customerstringOptional

The ID of a customer

invoice_numberstring · max: 127Optional

Optional. The invoice number to track this payment.

merchant_referencestringOptional

A reference specified by the merchant to identify the transaction

payment_productstringOptional

The payment product corresponding to this transaction

payment_product_typestringOptional

The name of the processor used for this transaction

processor_referencestringOptional

Reference identifying the transaction, as provided by the processor.

processor_detailsobjectOptional

Stores all details specific for the processor of the transaction.

statusstring · enumOptional

The outcome of the payment request.

Example: AUTHORIZEDPossible values:
status_reasonstringOptional

Message provided by the 3rd party service as additional information, when the transaction does not succeed.

arnstringOptional

Acquirer reference number. Generated by the Acquirer at the time of clearing for card transactions.

authorization_codestring · max: 6Optional
  • When the payment is authorized successfully, this field holds the authorization code for the payment.

  • When the payment is not authorized, this field is not returned.

Example: 5B1D4C
avs_resultstring · enumOptional

Address verification services result, which provides information about the outcome of the AVS check. The full list of codes and descriptions can be found here

Example: APossible values:
cardstringOptional

The token representing the payment card

created_bystringOptional

The ID of the user who initiated the transaction. Only set when shopper_interaction = moto, mail_order or telephone_order

cvv_presentbooleanOptional

True if the card was used with a cvv

cvv_resultstring · enumOptional

The CVC verification result, which provides information about the outcome of the CVC check.

CVC-CVV result codes:

  • 0 Unknown
  • 1 Matches.
  • 2 Doesn't match.
  • 3 Not checked.
  • 4 No CVC/CVV provided, but was required.
  • 5 Issuer not certified for CVC/CVV.
  • 6 No CVC/CVV provided.

The following are included only for backwards compatibility. They are deprecated and will be removed in the next major release. The client must take action now to ensure ongoing support.

  • M Match
  • Y Match
  • N No Match
  • P Not Processed
  • S CVV Should be present, but Merchant indicates not present.
  • U Issuer not certified or registered to process card verification.
Example: 1Possible values:
cavv_resultstring · enumOptional

This field will be populated for any Verified by Visa transaction and AVV Authorisation message sent by MasterCard SecureCode: This includes CAVV and AEVV from American Express SafeKey.

CAVV Transaction Response Code Values:

  • 0 CAVV or AEVV Not Validated due to erroneous data submitted.

  • 1 CAVV or AEVV Failed Validation - Authentication Transaction. This is an indication of potential bad or fraudulent data submitted.

  • 2 CAVV or AEVV Passed Validation – Authentication Transaction.

  • 3 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (Determined that the Issuer ACS generated this value from the use of the Issuer’s CAVV/AEVV key[s]).

  • 4 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (Determined that Visa generated this value from the use of CAVV/AEVV key[s]).

  • 5 Reserved.

  • 6 CAVV or AEVV Not Validated – Issuer not participated. This value is generated when an Issuer requests the do not verify flag to be established for its BINs. This parameter enables an Issuer to temporarily stop CAVV/AEVV verification while resolving CAVV/AEVV key issues. VisaNet processes this value as a valid CAVV/AEVV.

  • 7 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • 8 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key).

  • 9 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • 99 An unknown value was returned from the processor.

  • A CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • B CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • C CAVV or AEVV Not Validated – Attempted Authentication Transaction. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • D CAVV or AEVV Not Validated – Authentication. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • I Invalid Security Data.

  • U Issuer does not participate or 3-D Secure data not utilised.

  • NA Blank CAVV or AEVV Not Present.

Example: 99Possible values:
reason_codestring · max: 4Optional

A reason code assigned by the acquiring platform; '0000' in case of success

rrnstring · max: 12Optional

A client (user friendly) identifier for the transaction generated at the outset of a business event. The format will be dependent on the calling system.

A reference supplied by the system retaining the original source information and used to assist in locating that transaction or a copy of the transaction. This value is critical in matching values that are sent to other Payment processors or Acquirers. This value would correspond to the ISO8583 specification as RRN in attribute DE 37, which limits the value to being an alphanumeric value 12 characters.

For the GSC client android application the format will correspond to YYMMdd<stan 6 digits>.

Example: 200211654321
shopper_interactionstring · enumOptional

Determines the point of sale of a customer. Possible values: pos, moto, mail_order, telephone_order, ecommerce and cont_auth

Possible values:
stanstringOptional

System Trace Audit Number.

reversal_statusstring · enumOptional

Indicates to the API client if a technical reversal has been completed by Verifone.

Default: NONEPossible values:
geo_locationnumber[]Optional

The latitude / longitude resolved from the customer's ip address.

Example: ["52.370216","4.895168"]
citystringOptional

The city resolved from the customer's ip address.

Example: West Roxbury
country_codestringOptional

The country code resolved from the customer's ip address.

Example: US
promo_codestringOptional

A code defined by the merchant that affects the calculation of the total amount.

purchase_order_numberstring · max: 17Optional

The purchase order number. It can be provided in transactions with purchase or procurement cards for the cardholder to get better interchange rates (note that this functionality needs alignment with the acquirer and the scheme). This field is part of so-called Level 2 data.

balance_amountintegerOptional

Balance amount is the amount remaining on a card or account of cardholder without a decimal place e.g. $1.5 = 150.

The required number of decimal places for a currency code is according to ISO 4217. However the following table takes precedence over ISO 4217:

post
/api/v2/transactions/{id}/extend

Issuer Instalment Selection

post
/api/v2/transactions/{id}/issuer_instalment_selection

Confirm selection of instalment option where multiple issuer instalment options proposed.

Authorizations
AuthorizationstringRequired
Path parameters
idstringRequired

Original transaction id to apply instalment selection to.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
Body
Responses
201

Ecommerce Payment Result

application/json
idstring · uuid-flexibleOptional

The ID of the transaction.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
payment_provider_contractstring · uuid-flexibleOptional

The identifier of payment provider contract you want to process the transaction request with.

Example: 30b8bec8-5042-4e67-939c-5453fbe41711
amountintegerOptional

Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details. For Account Verification transactions, provide 0 as value for this field.

Example: 0
blockedbooleanOptional

True if the transaction has been blocked by a ruleset, false otherwise

created_atstring · date-timeOptional

The time at which the transaction was created.

customerstringOptional

The ID of a customer

invoice_numberstring · max: 127Optional

Optional. The invoice number to track this payment.

merchant_referencestringOptional

A reference specified by the merchant to identify the transaction

payment_productstringOptional

The payment product corresponding to this transaction

payment_product_typestringOptional

The name of the processor used for this transaction

processor_referencestringOptional

Reference identifying the transaction, as provided by the processor.

processor_detailsobjectOptional

Stores all details specific for the processor of the transaction.

statusstring · enumOptional

The outcome of the payment request.

Example: AUTHORIZEDPossible values:
status_reasonstringOptional

Message provided by the 3rd party service as additional information, when the transaction does not succeed.

arnstringOptional

Acquirer reference number. Generated by the Acquirer at the time of clearing for card transactions.

authorization_codestring · max: 6Optional
  • When the payment is authorized successfully, this field holds the authorization code for the payment.

  • When the payment is not authorized, this field is not returned.

Example: 5B1D4C
avs_resultstring · enumOptional

Address verification services result, which provides information about the outcome of the AVS check. The full list of codes and descriptions can be found here

Example: APossible values:
cardstringOptional

The token representing the payment card

created_bystringOptional

The ID of the user who initiated the transaction. Only set when shopper_interaction = moto, mail_order or telephone_order

cvv_presentbooleanOptional

True if the card was used with a cvv

cvv_resultstring · enumOptional

The CVC verification result, which provides information about the outcome of the CVC check.

CVC-CVV result codes:

  • 0 Unknown
  • 1 Matches.
  • 2 Doesn't match.
  • 3 Not checked.
  • 4 No CVC/CVV provided, but was required.
  • 5 Issuer not certified for CVC/CVV.
  • 6 No CVC/CVV provided.

The following are included only for backwards compatibility. They are deprecated and will be removed in the next major release. The client must take action now to ensure ongoing support.

  • M Match
  • Y Match
  • N No Match
  • P Not Processed
  • S CVV Should be present, but Merchant indicates not present.
  • U Issuer not certified or registered to process card verification.
Example: 1Possible values:
cavv_resultstring · enumOptional

This field will be populated for any Verified by Visa transaction and AVV Authorisation message sent by MasterCard SecureCode: This includes CAVV and AEVV from American Express SafeKey.

CAVV Transaction Response Code Values:

  • 0 CAVV or AEVV Not Validated due to erroneous data submitted.

  • 1 CAVV or AEVV Failed Validation - Authentication Transaction. This is an indication of potential bad or fraudulent data submitted.

  • 2 CAVV or AEVV Passed Validation – Authentication Transaction.

  • 3 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (Determined that the Issuer ACS generated this value from the use of the Issuer’s CAVV/AEVV key[s]).

  • 4 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (Determined that Visa generated this value from the use of CAVV/AEVV key[s]).

  • 5 Reserved.

  • 6 CAVV or AEVV Not Validated – Issuer not participated. This value is generated when an Issuer requests the do not verify flag to be established for its BINs. This parameter enables an Issuer to temporarily stop CAVV/AEVV verification while resolving CAVV/AEVV key issues. VisaNet processes this value as a valid CAVV/AEVV.

  • 7 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • 8 CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key).

  • 9 CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • 99 An unknown value was returned from the processor.

  • A CAVV or AEVV Passed Validation – Attempted Authentication Transaction. (CAVV/AEVV generated with Visa Key – Issuer ACS unavailable).

  • B CAVV or AEVV Failed Validation – Attempted Authentication Transaction. This is an indication of potential bad or fraudulent data submitted as the CAVV/AEVV. (CAVV/AEVV generated with Visa Key).

  • C CAVV or AEVV Not Validated – Attempted Authentication Transaction. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • D CAVV or AEVV Not Validated – Authentication. Issuer did not return a CAVV/AEVV results code in the authorisation response. VisaNet will treat this as valid CAVV/AEVV if the Issuer approves the authorisation.

  • I Invalid Security Data.

  • U Issuer does not participate or 3-D Secure data not utilised.

  • NA Blank CAVV or AEVV Not Present.

Example: 99Possible values:
reason_codestring · max: 4Optional

A reason code assigned by the acquiring platform; '0000' in case of success

rrnstring · max: 12Optional

A client (user friendly) identifier for the transaction generated at the outset of a business event. The format will be dependent on the calling system.

A reference supplied by the system retaining the original source information and used to assist in locating that transaction or a copy of the transaction. This value is critical in matching values that are sent to other Payment processors or Acquirers. This value would correspond to the ISO8583 specification as RRN in attribute DE 37, which limits the value to being an alphanumeric value 12 characters.

For the GSC client android application the format will correspond to YYMMdd<stan 6 digits>.

Example: 200211654321
shopper_interactionstring · enumOptional

Determines the point of sale of a customer. Possible values: pos, moto, mail_order, telephone_order, ecommerce and cont_auth

Possible values:
stanstringOptional

System Trace Audit Number.

reversal_statusstring · enumOptional

Indicates to the API client if a technical reversal has been completed by Verifone.

Default: NONEPossible values:
geo_locationnumber[]Optional

The latitude / longitude resolved from the customer's ip address.

Example: ["52.370216","4.895168"]
citystringOptional

The city resolved from the customer's ip address.

Example: West Roxbury
country_codestringOptional

The country code resolved from the customer's ip address.

Example: US
promo_codestringOptional

A code defined by the merchant that affects the calculation of the total amount.

purchase_order_numberstring · max: 17Optional

The purchase order number. It can be provided in transactions with purchase or procurement cards for the cardholder to get better interchange rates (note that this functionality needs alignment with the acquirer and the scheme). This field is part of so-called Level 2 data.

balance_amountintegerOptional

Balance amount is the amount remaining on a card or account of cardholder without a decimal place e.g. $1.5 = 150.

The required number of decimal places for a currency code is according to ISO 4217. However the following table takes precedence over ISO 4217:

post
/api/v2/transactions/{id}/issuer_instalment_selection

Complete a Affirm payment

post
/api/v2/transactions/affirm_complete

A customer has completed a purchase and want to create the associated order in the system.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Header parameters
x-vfi-api-idempotencykeystring · uuidRequired

A value you specify that uniquely identifies this transaction. This must be used to trigger a reversal if there is a timeout.

Example: 63bbc548-d2de-4546-b106-880a5018461c
Body
merchant_referencestring · max: 50Optional

A reference specified by the merchant to identify the transaction

refusal_reasonstring · enumOptional

The reason a transaction has been refused within the payment ecosystem by the client/Verifone/acquirer. This needs to be set by the component that is refusing this transaction request.

Possible values:
Responses
201

The Affirm Initiation Response.

application/json
idstring · uuid-flexibleOptional

The ID of the transaction.

Example: 76944d4b-89e6-48d2-ac04-675383c3eedf
authorization_expirationstringOptional

The time when the auth transaction will expire (i.e. before which capture must be made). The value is formatted in RFC 3339.

amountintegerOptional

Amount is charged without a decimal place e.g. $1.5 = 150. Currencies can have different decimals/exponentials, see Currencies Section for more details. For Account Verification transactions, provide 0 as value for this field.

Example: 150
currency_codestring · enumOptional

Three-letter ISO 4217 alphabetical currency code. e.g. USD. Values correspond to ISO 4217.

Deprecated: BYR (replaced by BYN), FRF (replaced by EUR), LTL (replaced by EUR), LVL (replaced by EUR), MRO (replaced by MRU), STD (replaced by STN), USS (no replacement), VEF (replaced by VES), ZMK (replaced by ZMV) and BTC (Bitcoin only supported as Crypto Amount).

Possible values:
created_atstring · date-timeOptional

The time at which the transaction was created.

created_bystringOptional

The ID of the user who initiated the transaction. Only set when shopper_interaction = moto, mail_order or telephone_order

customerstringOptional

The ID of a customer

merchant_referencestring · max: 50Optional

A reference specified by the merchant to identify the transaction

processorstringOptional

The name of the processor used for this transaction

Default: KLARNA
payment_productstringOptional

The payment product corresponding to this transaction

Default: KLARNA
payment_product_typestring · enumOptional

The payment product type corresponding to this transaction. Fees applied to the transaction, is based on the payment product

Default: UnknownPossible values:
statusstring · enumOptional

The outcome of the payment request.

Example: AUTHORIZEDPossible values:
status_reasonstringOptional

Message provided by the 3rd party service as additional information, when the transaction does not succeed.

geo_locationnumber[]Optional

The latitude / longitude resolved from the customer's ip address.

Example: [52.370216,4.895168]
country_codestringOptional

The ISO 3166-1 alpha-2 country code.

Note: The country code for Great Britain is GB and not UK as is used in that country's top-level domain names.
.

Example: EU
post
/api/v2/transactions/affirm_complete

Last updated

Was this helpful?