Sync transaction
Sync the transaction with the payment service to get the latest status, amounts, and some of the identifiers. This is only available for some payment service providers.
This endpoint requires the transactions.read
scope. Please note that we
will only update the transaction if it represents a valid transition from
the current status to the new status.
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
The ID for the transaction to get the information for.
Response
The type of this resource. Is always transaction
.
transaction
The unique identifier for this transaction.
The total amount for this transaction across all funding sources including gift cards.
This is the response description received from the processor.
The amount for this transaction that has been authorized for the payment_method
.
This can be less than the amount
if gift cards were used.
The date and time when this transaction was authorized in the payment service.
Don't use this field to determine whether the transaction was authorized.
A null
value doesn't necessarily imply that the transaction wasn't
authorized, it can mean that the payment service doesn't provide this
value, that it didn't provide it at the time the transaction was
authorized or that the transaction was authorized before the introduction
of this field.
The date and time when this transaction will be marked as failed if it does not successfully gets captured, authorized or otherwise approved before.
The response code received from the payment service for the Address Verification Check (AVS). This code is mapped to a standardized Gr4vy AVS response code.
no_match
- neither address or postal code matchmatch
- both address and postal code matchpartial_match_address
- address matches but postal code does notpartial_match_postcode
- postal code matches but address does notunavailable
- AVS is unavailable for card/country
The value of this field can be null
if the payment service did not
provide a response.
no_match
, match
, partial_match_address
, partial_match_postcode
, unavailable
The buyer used for this transaction.
The captured amount for this transaction. This can be the full value
of the authorized_amount
or less.
The date and time when this transaction was captured in the payment service.
Don't use this field to determine whether the transaction was captured.
A null
value doesn't necessarily imply that the transaction wasn't
captured, it can mean that the payment service doesn't provide this value,
that it didn't provide it at the time the transaction was captured or that
the transaction was captured before the introduction of this field.
An array of cart items that represents the line items of a transaction.
The identifier for the checkout session this transaction is associated with.
The 2-letter ISO code of the country of the transaction. This is used to filter the payment services that is used to process the transaction.
The date and time when this transaction was created in our system.
The currency code for this transaction.
The response code received from the payment service for the Card Verification Value (CVV). This code is mapped to a standardized Gr4vy CVV response code.
no_match
- the CVV does not match the expected valuematch
- the CVV matches the expected valueunavailable
- CVV check unavailable for card our countrynot_provided
- CVV not provided
The value of this field can be null
if the payment service did not
provide a response.
no_match
, match
, unavailable
, not_provided
This is an error code set by Gr4vy.
An external identifier that can be used to match the transaction against your own records.
The gift card service used for this transaction.
The gift cards redeemed for this transaction.
The name of the instrument used to process the transaction.
applepay
, card_token
, googlepay
, network_token
, pan
, redirect
, redirect_token
The original intent
used when the transaction was
created.
authorize
, capture
The outcome of the original intent of a transaction.
This allows you to understand if the intent of the transaction
(e.g. capture
or authorize
) has been achieved when dealing with multiple
payment instruments.
If all payment instruments (payment_method
and/or gift_cards
)
have succeeded to get an authorization or direct sale at any point
in time then this will return a succeeded
value.
If any of the payment instruments fails or declines then this will
return a failed
value.
If any payment instruments is still in a pending
or processing
state
then the result will be pending
.
Please note that if any of the payment instruments are voided or refunded
after the result reaches a succeeded
state then the result will remain
unchanged.
pending
, succeeded
, failed
Indicates whether the transaction represents a subsequent payment coming from a setup recurring payment. Please note there are some restrictions on how this flag may be used.
The flag can only be false
(or not set) when the transaction meets
one of the following criteria:
- It is not
merchant_initiated
. payment_source
is set tocard_on_file
.
The flag can only be set to true
when the transaction meets one of the
following criteria:
- It is not
merchant_initiated
. payment_source
is set torecurring
orinstallment
andmerchant_initiated
is set totrue
.payment_source
is set tocard_on_file
.
The ID of the merchant account to which this transaction belongs to.
Indicates whether the transaction was initiated by the merchant (true) or customer (false).
Additional information about the transaction stored as key-value pairs.
afterpay
, alipay
, alipayhk
, applepay
, bacs
, bancontact
, banked
, becs
, bitpay
, boleto
, boost
, card
, cashapp
, chaseorbital
, checkout-session
, clearpay
, click-to-pay
, dana
, dcb
, dlocal
, ebanx
, eps
, everydaypay
, gcash
, giropay
, givingblock
, gocardless
, googlepay
, googlepay_pan_only
, gopay
, grabpay
, id
, ideal
, kakaopay
, kcp
, klarna
, laybuy
, linepay
, linkaja
, maybankqrpay
, multibanco
, multipago
, network-token
, oney_3x
, oney_4x
, oney_6x
, oney_10x
, oney_12x
, ovo
, oxxo
, payid
, paymaya
, paypal
, paypalpaylater
, payto
, venmo
, pix
, rabbitlinepay
, razorpay
, scalapay
, sepa
, shopeepay
, singteldash
, smartpay
, sofort
, spei
, stripedd
, thaiqr
, touchngo
, truemoney
, trustly
, trustlyeurope
, vipps
, waave
, wechat
, zippay
Defines if this transaction has been split across multiple payment instruments
such as a payment_method
and one or more gift_cards
, or multiple gift_cards
without a payment_method
.
The payment method used for this transaction.
The payment service used for this transaction.
The payment service's unique ID for the transaction.
The source of the transaction. Defaults to ecommerce
.
ecommerce
, moto
, recurring
, installment
, card_on_file
Whether a manual review is pending.
This is the response code received from the payment service. This can be set to any value and is not standardized across different payment services.
This is the response description received from the payment service. This can be set to any value and is not standardized across different payment services.
The base62 encoded transaction ID. This represents a shorter version
of this transaction's id
which is sent to payment services, anti-fraud services,
and other connectors. You can use this ID to reconcile a payment service's
transaction against our system.
This ID is sent instead of the transaction ID because not all services support 36 digit identifiers.
The refunded amount for this transaction. This can be the full value
of the captured_amount
or less.
An identifier for the transaction used by the scheme itself, when available.
e.g. the Visa Transaction Identifier, or Mastercard Trace ID.
The shipping details associated with the transaction.
The statement descriptor is the text to be shown on the buyer's statements.
The specific usage of these fields will depend on the capabilities of the underlying PSP and bank. As a typical example, 'name' and 'description' could be concatenated using '* ' as a separator, and then the resulting descriptor would be truncated to 22 characters by the issuing bank.
The status of the transaction for the payment_method
. The status
may change over time as asynchronous processing events occur.
Please note that the possible statuses returned will depend on the
operation performed. For example, a captured transaction will never
move to a authorization_voided
status.
processing
, buyer_approval_pending
, authorization_succeeded
, authorization_failed
, authorization_declined
, capture_pending
, capture_succeeded
, authorization_void_pending
, authorization_voided
The 3-D Secure data that was sent to the payment service for the transaction.
Defines when the transaction was last updated.
The date and time when this transaction was voided in the payment service.
Don't use this field to determine whether the transaction was voided.
A null
value doesn't necessarily imply that the transaction wasn't
voided, it can mean that the payment service doesn't provide this value,
that it didn't provide it at the time the transaction was voided or that
the transaction was voided before the introduction of this field.
Was this page helpful?