Sign-up

Latitude credentials can be required from Latitude merchant support.

Deferred Settlement vs Instant Settlement

Merchants with Instant Settlement need to be set up in Gr4vy with the Latitude/Gem Instant Settlement connection, so funds are captured right away during a transaction.

For Deferred Settlement, merchants must use the Latitude/Gem Deferred Settlement connection, meaning they’ll need to capture the funds manually after authorization.

Credentials

When setting up Latitude/Gem in the dashboard you will need to configure the following credentials, which are obtained from Latitude Financial:

Merchant ID

The Latitude/Gem Merchant ID can be obtained from the Latitude Merchant Integration Support team.

Merchant Secret

The Latitude/Gem Merchant Secret can be obtained from the Latitude Merchant Integration Support team.

Usage

Setting a promotion reference

Latitude allows for a promotion reference to be passed in a purchase request, this can be set with a connection option.

{
    "amount": 299,
    "currency": "AUD",
    "country": "AU",
    "intent": "capture",
    "connection_options": {
        "latitude-latitude": {
            "promotion_reference": "2012"
        }
    },
    ...
}

Refreshing a transaction

Latitude/Gem supports refreshing a transaction via the Gr4vy dashboard with limitations.

Only transactions in Gr4vy with a Buyer Approval Pending state can be updated to either Captured (Instant Settlement) or Authorized (Deferred Settlement).