New Checkout - Inline Integration - User Error 404

Marlin Integrations
Marlin Integrations
Fifth Anniversary Kudos 1 Name Dropper Facilitator 1
edited May 21 in SKY Developer General Discussions

Hello, we've followed the integration guide for the new checkout

https://developer.blackbaud.com/skyapi/products/bbms/payments/integrations/new-checkout/inline

When initialising, the script is making API request to https://sky-pusa01.app.blackbaud.net/uicfg/settings/user which is failing with 404

{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.5",
"title": "Not Found",
"status": 404,
"traceId": "00-b3fe6a66e15d05ad32f921088ad73144-7a37641c907189d9-01"
}

We are using using payment configuration ID that has been previously used for the older Blackbaud Checkout integration.

We are using user that has Payment API role to connect the app.

Any idea what are we missing?

Answers

  • Crystal Bruce
    Crystal Bruce admin
    Tenth Anniversary Kudos 5 AI Practitioner 2026 Spring PUB Altru

    Hi @Marlin Integrations tagging in @Alex Wong @Erik Leaver and @Dan Snyder to see if they can offer any insight!

  • Erik Leaver
    Erik Leaver Blackbaud Employee
    Tenth Anniversary Kudos 5 First Reply Name Dropper

    @Marlin Integrations Have you checked the credentials for the Payments API user account? (See step 6 in Complete initial setup). You might also want to check the payment config ID as per in Step 3.

  • Marlin Integrations
    Marlin Integrations
    Fifth Anniversary Kudos 1 Name Dropper Facilitator 1

    Hi @Erik Leaver

    Thanks for you feedback!

    Yes, we checked that guide and I can confirm we have:

    • Payment role called "Payments API" (Access all endpoints)
    • User with "Payments API" role
    • The user has Payment API keys

    (See the screenshots below)

    I guess my question is:

    How does the new Checkout detect/verify the user?

    We need to include the payment configuration ID only, subscription keys are not required (unlike the old Checkout)

    I don't understand how can BBMS link payment configuration to specific SKY API user.

    Any advise will be highly appreciated.

    Cheers

    let checkoutConfiguration = {
    paymentConfigurationId: 'PAYMENT_CONFIGURATION_ID',
    workflowMode: 'inline',
    primaryColor: '#30ABBB',
    fontFamily: 'Arial, sans-serif'
    };
    let checkoutService = window.BlackbaudCheckout(checkoutConfiguration);

    image.png image.png image.png
  • Erik Leaver
    Erik Leaver Blackbaud Employee
    Tenth Anniversary Kudos 5 First Reply Name Dropper

    @Mina Mistry / @Heather Templeton can you assist?

  • Marlin Integrations
    Marlin Integrations
    Fifth Anniversary Kudos 1 Name Dropper Facilitator 1

    Hi @Mina Mistry @Heather Templeton @Erik Leaver

    We're still experiencing this issue, any help will be highly appreciated.

    Kind regards

  • Mitchell Thomas
    Mitchell Thomas Blackbaud Employee
    Tenth Anniversary Facilitator 1 Participant Blackbaud Staff

    That particular error is a red herring and should not affect your integration. It's a part of our overall UI development platform that helps to power all Blackbaud products but not relevant for this particular case. We're working on getting it removed. In the meantime, it will cause some noise in the developer tools.

    Aside from that, are you seeing issues getting the inline checkout integration working?

Categories