Skip to content

Guava

Supports in this guide: Payouts

Note

No independently verifiable public website could be confirmed for this provider - none is listed in OFT. Contact your account manager for onboarding details.

What you need to do for start processing transactions (brief summary)

  1. Get your credentials (from Guava)
  2. Connect in Dashboard
  3. Send an API request

Prerequisites: get from Guava

Contact your Guava account manager to get your account verified and receive the following credentials.

  • Merchant ID -> Corefy field merchant_id.
  • App secret key -> Corefy field app_secret_key.
Payouts processing (connect Provider account, create payout-invoice)

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

Open Guava in the provider directory and press Connect at Guava Provider Overview page in the New connection section.

Step 2 - Fill in fields and select settings

  • Merchant ID
  • App secret key
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Guava Provider account!

First request to Corefy API (MIN)

What it does: creates a payout-invoice and sends funds directly to a card.

Payout - MIN

POST /api/payout-invoices 

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "dbaaeba6-02ce-4fd2-b4d7-940c38a65adb",
      "service": "payment_card_eur",
      "currency": "EUR",
      "amount": 10,
      "context": {
        "card": {
          "card_holder": "Joel Miller"
        }
      },
      "fields": {
        "card_number": "4111111111111111"
      }
    }
  }
}

Important

  • fields.card_number is required.
  • context.card.card_holder is required - it's split into first/last name and sent to Guava as the recipient's name. customer is not used at all for this connector.
  • No Options or Constants are configured for this connector.

Payout - MAX

There is no MAX variant - the request above already includes every field Guava's API accepts for a payout.

Refunds

Guava does not support refunds.

Additional info

  1. Active reconciliation is available - an active status request can be used to retrieve the current payout status.
  2. No recurring - this connector does not support saving/charging a token through Corefy.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify the Merchant ID and App secret key for the selected environment (test_mode)
  • Currency or service is not supported -> confirm allowed currencies/features in your Guava account and in Corefy
  • Refund fails -> Guava does not support refunds through Corefy

Question

Still looking for help connecting your Guava account? Please contact our support team!