Skip to main content
Test your integration before going live.

​
Testing Checklist

Run through this checklist before going live:

​
1. Create Session

  • API call returns success: true
  • You get a checkoutUrl

​
2. Checkout Page

  • Your store name appears
  • Correct amount displays
  • Card form loads properly

​
3. Success Flow

  • Enter card details, click “Pay Now”
  • Customer redirected to your successUrl
  • You receive sessionId and transaction parameters in URL

​
4. Cancel Flow

  • Click “Cancel” on checkout
  • Customer redirected to your cancelUrl

​
5. Verification

  • Your server calls GET /api/sessions/{sessionId}
  • Status returns completed

​
Elavon Sandbox Testing

Ozura Checkout uses Elavon as the payment processor. In sandbox mode, Elavon determines the transaction response based on the amount, not the card number.

​
How It Works

Amount Ends InResult
.00Approval
.88Declined
.13Amount Error
For example:
  • $25.00 → Approval
  • $25.88 → Declined
  • $25.13 → Amount Error

​
Test Card Numbers

Any of these card numbers will work in sandbox mode. The amount determines success or failure:
Card TypeNumber
Visa4000000000000002
Mastercard5121212121212124
Amex370000000000002
Discover6011000000000004
Diners Club36111111111111
JCB3566664444444445
CVV: Any 3 digits (4 digits for Amex) Expiry: Any future date

​
Important: Tax Affects the Final Amount

When testing, remember that tax calculations can change the final amount sent to Elavon. Tax is calculated by the payment processor based on the customer’s billing address. For example:
  • Base amount: $26.52
  • Customer enters zip code: 10001 (New York)
  • Final amount might be ~$28.88 → triggers a decline!

​
Tips for Predictable Testing

  1. Use round amounts like $25.00 or $30.00 to ensure approvals
  2. Use taxExempt: true when creating test sessions to skip tax calculation
  3. Use a tax-free zip code in testing (some states have no sales tax)
Example: Guaranteed Approval (Tax-Exempt) 
{
  "amount": "25.00",
  "taxExempt": true
}
Final amount to Elavon: $25.00 → Approval Example: Testing Decline (Tax-Exempt) 
{
  "amount": "25.88",
  "taxExempt": true
}
Final amount to Elavon: $25.88 → Declined

​
Common Test Issues

​
”Session not found”

Sessions expire after 30 minutes. Create a new one.

​
”Invalid API key”

Double-check your API keys match what’s in your Ozura Dashboard.

​
CORS errors

For popup/iframe modes, make sure parentOrigin exactly matches your website URL (including https://).

​
Unexpected decline

Check if tax was applied. The total sent to Elavon might end in .88 even if your base amount didn’t.

​
Ready for Production?

Once testing is complete:
  1. Verify your production API keys are configured
  2. Ensure your payment processor is set to production mode (contact Ozura support)
  3. Make a small real payment to verify end-to-end flow
  4. You’re live!