Payment Gateway API Specification.
- API version: 21.5.0
gem install first_data_gateway
(for development, run gem install --dev first_data_gateway
to install the development dependencies)
Then add the gem to your Gemfile:
gem 'first_data_gateway', '~> 1.14.0'
Add the following in the Gemfile:
gem 'first_data_gateway', :git => 'https://github.com/GBSEcom/Ruby.git'
require 'openapi_client'
require 'simple_client'
api_key = "Your API Key here"
api_secret = "Your API Secret here"
credentials = SimpleClient::MerchantCredentials.new(api_key, api_secret)
# For use in production, supply "PROD" as the optional production argument:
# gateway = SimpleClient::Gateway.create(credentials, "PROD");
gateway = SimpleClient::Gateway.create(credentials)
payload = "{
\"amount\":{
\"currency\":\"USD\",
\"total\":\"12.10\"
},
\"paymentMethod\":{
\"paymentCard\":{
\"expiryDate\":{
\"month\":\"12\",
\"year\":\"21\"
},
\"number\":\"5500000000000004\"
},
\"type\":\"PAYMENT_CARD\"
},
\"transactionType\":\"SALE\"
}"
result = gateway.primary_payment_transaction(payload: payload)
p JSON.generate(result.to_hash)
All URIs are relative to https://cert.api.firstdata.com/gateway/v2
Class | Method | HTTP request | Description |
---|---|---|---|
OpenapiClient::AuthenticationApi | authentication_access_tokens_post | POST /authentication/access-tokens | Generate an access token for user authentication. |
OpenapiClient::CurrencyConversionApi | get_exchange_rate | POST /exchange-rates | Generate dynamic currency conversion transactions. |
OpenapiClient::FraudDetectApi | fraud_client_registration_post | POST /fraud/client-registration | Client registration for fraud detect transaction. |
OpenapiClient::FraudDetectApi | fraud_payment_registration_post | POST /fraud/payment-registration | Payment registration for fraud detect transaction. |
OpenapiClient::FraudDetectApi | score_only | POST /fraud/score-only | Score a transaction for fraud. |
OpenapiClient::InformationLookupApi | card_info_lookup | POST /card-information | Card information lookup. |
OpenapiClient::InformationLookupApi | lookup_account | POST /account-information | Account information lookup. |
OpenapiClient::OrderApi | order_inquiry | GET /orders/{order-id} | Retrieve the state of an order. |
OpenapiClient::OrderApi | submit_secondary_transaction_from_order | POST /orders/{order-id} | Perform return or postAuth secondary transactions. |
OpenapiClient::PaymentApi | finalize_secure_transaction | PATCH /payments/{transaction-id} | Update a 3DSecure or UnionPay payment and continue processing. |
OpenapiClient::PaymentApi | submit_primary_transaction | POST /payments | Generate a primary transaction. |
OpenapiClient::PaymentApi | submit_secondary_transaction | POST /payments/{transaction-id} | Perform a secondary transaction. |
OpenapiClient::PaymentApi | transaction_inquiry | GET /payments/{transaction-id} | Retrieve the state of a transaction. |
OpenapiClient::PaymentSchedulesApi | cancel_payment_schedule | DELETE /payment-schedules/{order-id} | Cancel a gateway payment schedule. |
OpenapiClient::PaymentSchedulesApi | create_payment_schedule | POST /payment-schedules | Create gateway payment schedule. |
OpenapiClient::PaymentSchedulesApi | inquiry_payment_schedule | GET /payment-schedules/{order-id} | View a gateway payment schedule. |
OpenapiClient::PaymentSchedulesApi | update_payment_schedule | PATCH /payment-schedules/{order-id} | Update a gateway payment schedule. |
OpenapiClient::PaymentTokenApi | create_payment_token | POST /payment-tokens | Create a payment token from a payment card. |
OpenapiClient::PaymentTokenApi | delete_payment_token | DELETE /payment-tokens/{token-id} | Delete a payment token. |
OpenapiClient::PaymentTokenApi | get_payment_token_details | GET /payment-tokens/{token-id} | Get payment card details associated with token. |
OpenapiClient::PaymentTokenApi | update_payment_token | PATCH /payment-tokens | Update one or more payment tokens. |
OpenapiClient::PaymentURLApi | create_payment_url | POST /payment-url | Create a payment URL. |
OpenapiClient::PaymentURLApi | delete_payment_url | DELETE /payment-url | Delete a payment URL. |
OpenapiClient::PaymentURLApi | payment_url_detail | GET /payment-url | Retrieve the state of payment URL. |
OpenapiClient::VerificationApi | verify_account | POST /account-verification | Verify a payment card or payment token. |
OpenapiClient::VerificationApi | verify_card | POST /card-verification | Verify a payment card. |
- OpenapiClient::ACSResponse
- OpenapiClient::AVSResponse
- OpenapiClient::AccessTokenRequest
- OpenapiClient::AccessTokenResponse
- OpenapiClient::AccountInfoLookupRequest
- OpenapiClient::AccountUpdaterResponse
- OpenapiClient::AccountVerificationRequest
- OpenapiClient::AchCreditTransaction
- OpenapiClient::AchPostAuthTransaction
- OpenapiClient::AchPostAuthTransactionAllOf
- OpenapiClient::AchPreAuthTransaction
- OpenapiClient::AchPreAuthTransactionAllOf
- OpenapiClient::AchRecurringType
- OpenapiClient::AchResponse
- OpenapiClient::AchReturnTransaction
- OpenapiClient::AchSaleTransaction
- OpenapiClient::AchVoidTransaction
- OpenapiClient::AdditionalAmountRate
- OpenapiClient::AdditionalDetails
- OpenapiClient::AdditionalTransactionDetails
- OpenapiClient::Address
- OpenapiClient::Airline
- OpenapiClient::AirlineAncillaryServiceCategory
- OpenapiClient::AirlineTravelRoute
- OpenapiClient::AliPay
- OpenapiClient::AliPayPaymentMethod
- OpenapiClient::AliPayPaymentMethodAllOf
- OpenapiClient::AliPaySaleTransaction
- OpenapiClient::AliPaySaleTransactionAllOf
- OpenapiClient::Amount
- OpenapiClient::AmountComponents
- OpenapiClient::AuthenticationRequest
- OpenapiClient::AuthenticationResult
- OpenapiClient::AuthenticationUpdateRequest
- OpenapiClient::Background
- OpenapiClient::BackgroundColor
- OpenapiClient::BancontactQR
- OpenapiClient::BasicResponse
- OpenapiClient::Billing
- OpenapiClient::BillingAddress
- OpenapiClient::BlockCard
- OpenapiClient::BlockDomain
- OpenapiClient::BlockIPAddress
- OpenapiClient::BlockName
- OpenapiClient::BlockedCardNumber
- OpenapiClient::BlockedItems
- OpenapiClient::Body
- OpenapiClient::Borders
- OpenapiClient::BrandingStyleConfigurationRequest
- OpenapiClient::BrandingStyleConfigurationResponse
- OpenapiClient::BrandingStyleConfigurationResult
- OpenapiClient::Button
- OpenapiClient::CarRental
- OpenapiClient::CarRentalExtraCharges
- OpenapiClient::Card
- OpenapiClient::CardFunction
- OpenapiClient::CardInfo
- OpenapiClient::CardInfoLookupRequest
- OpenapiClient::CardInfoLookupResponse
- OpenapiClient::CardVerificationRequest
- OpenapiClient::CardholderInfoResponse
- OpenapiClient::ChinaDomestic
- OpenapiClient::ChinaDomesticPaymentMethod
- OpenapiClient::ChinaDomesticPaymentMethodAllOf
- OpenapiClient::ChinaPnRSaleTransaction
- OpenapiClient::ChinaPnRSaleTransactionAllOf
- OpenapiClient::ClassicMode
- OpenapiClient::ClearingDetails
- OpenapiClient::ClearingElement
- OpenapiClient::ClientLocale
- OpenapiClient::ClientRegistration
- OpenapiClient::CombinedMode
- OpenapiClient::ConnectMode
- OpenapiClient::Contact
- OpenapiClient::Content
- OpenapiClient::CountryProfile
- OpenapiClient::CreatePaymentToken
- OpenapiClient::CurrencyConversion
- OpenapiClient::CurrencyConversionResponse
- OpenapiClient::Customer
- OpenapiClient::CustomerAddress
- OpenapiClient::DCCExchangeRateRequest
- OpenapiClient::DCCExchangeRateRequestAllOf
- OpenapiClient::Dcc
- OpenapiClient::DccAllOf
- OpenapiClient::DecryptedApplePay
- OpenapiClient::DecryptedApplePayWalletPaymentMethod
- OpenapiClient::DecryptedApplePayWalletPaymentMethodAllOf
- OpenapiClient::DecryptedGooglePay
- OpenapiClient::DecryptedGooglePayWalletPaymentMethod
- OpenapiClient::DecryptedGooglePayWalletPaymentMethodAllOf
- OpenapiClient::DecryptedSamsungPay
- OpenapiClient::DecryptedSamsungPayWalletPaymentMethod
- OpenapiClient::DecryptedSamsungPayWalletPaymentMethodAllOf
- OpenapiClient::DeleteBrandingStyleConfigurationResponse
- OpenapiClient::Device
- OpenapiClient::Disbursement
- OpenapiClient::DisbursementTransactionType
- OpenapiClient::Document
- OpenapiClient::DynamicPricing
- OpenapiClient::DynamicPricingAllOf
- OpenapiClient::DynamicPricingExchangeRateRequest
- OpenapiClient::DynamicPricingExchangeRateRequestAllOf
- OpenapiClient::EmailNotificationData
- OpenapiClient::EncryptedApplePay
- OpenapiClient::EncryptedApplePayHeader
- OpenapiClient::EncryptedApplePayWalletPaymentMethod
- OpenapiClient::EncryptedApplePayWalletPaymentMethodAllOf
- OpenapiClient::EncryptedGooglePay
- OpenapiClient::EncryptedGooglePayData
- OpenapiClient::EncryptedGooglePayWalletPaymentMethod
- OpenapiClient::EncryptedGooglePayWalletPaymentMethodAllOf
- OpenapiClient::EncryptedSamsungPay
- OpenapiClient::EncryptedSamsungPayWalletPaymentMethod
- OpenapiClient::EncryptedSamsungPayWalletPaymentMethodAllOf
- OpenapiClient::EndpointResponse
- OpenapiClient::Error
- OpenapiClient::ErrorDetails
- OpenapiClient::ErrorMessage
- OpenapiClient::ErrorResponse
- OpenapiClient::ExchangeRateDetails
- OpenapiClient::ExchangeRateRequest
- OpenapiClient::ExchangeRateResponse
- OpenapiClient::Expiration
- OpenapiClient::FontFace
- OpenapiClient::FontProperties
- OpenapiClient::FontWeight
- OpenapiClient::Footer
- OpenapiClient::FraudAddress
- OpenapiClient::FraudOrder
- OpenapiClient::FraudOrderItems
- OpenapiClient::FraudRegistration
- OpenapiClient::FraudRegistrationCard
- OpenapiClient::FraudRegistrationDevice
- OpenapiClient::FraudRegistrationDeviceItems
- OpenapiClient::FraudRegistrationError
- OpenapiClient::FraudRegistrationResponse
- OpenapiClient::FraudScore
- OpenapiClient::FraudSettings
- OpenapiClient::FraudSettingsResponse
- OpenapiClient::Frequency
- OpenapiClient::FundingTransactionType
- OpenapiClient::GenerateCertificateFromCsrResponse
- OpenapiClient::GenerateCertificateResponse
- OpenapiClient::Header
- OpenapiClient::Hover
- OpenapiClient::IdInfo
- OpenapiClient::IdealSetup
- OpenapiClient::IdealSetupResponse
- OpenapiClient::IndustrySpecificExtensions
- OpenapiClient::InitiateClearingResponse
- OpenapiClient::InitiateClearingResponseAllOf
- OpenapiClient::InstallmentOptions
- OpenapiClient::IssuerResponse
- OpenapiClient::Items
- OpenapiClient::Location
- OpenapiClient::LockoutTime
- OpenapiClient::Lodging
- OpenapiClient::LodgingExtraCharges
- OpenapiClient::Logo
- OpenapiClient::Loyalty
- OpenapiClient::MasterpassWalletPaymentMethod
- OpenapiClient::MasterpassWalletPaymentMethodAllOf
- OpenapiClient::MaximumPurchaseAmount
- OpenapiClient::Mcc6012
- OpenapiClient::Merchant
- OpenapiClient::Method
- OpenapiClient::Mobile
- OpenapiClient::MobileHeaderArea
- OpenapiClient::Order
- OpenapiClient::OrderErrorResponse
- OpenapiClient::OrderResponse
- OpenapiClient::PayPal
- OpenapiClient::PayPalPaymentMethod
- OpenapiClient::PayPalPaymentMethodAllOf
- OpenapiClient::Payment
- OpenapiClient::PaymentCard
- OpenapiClient::PaymentCardCreditTransaction
- OpenapiClient::PaymentCardDisbursementTransaction
- OpenapiClient::PaymentCardDisbursementTransactionAllOf
- OpenapiClient::PaymentCardForcedTicketTransaction
- OpenapiClient::PaymentCardForcedTicketTransactionAllOf
- OpenapiClient::PaymentCardInfoLookupRequest
- OpenapiClient::PaymentCardInfoLookupRequestAllOf
- OpenapiClient::PaymentCardPayerAuthTransaction
- OpenapiClient::PaymentCardPayerAuthTransactionAllOf
- OpenapiClient::PaymentCardPaymentMethod
- OpenapiClient::PaymentCardPaymentMethodAllOf
- OpenapiClient::PaymentCardPaymentTokenUpdateRequest
- OpenapiClient::PaymentCardPaymentTokenizationRequest
- OpenapiClient::PaymentCardPaymentTokenizationRequestAllOf
- OpenapiClient::PaymentCardPreAuthTransaction
- OpenapiClient::PaymentCardPreAuthTransactionAllOf
- OpenapiClient::PaymentCardSaleTransaction
- OpenapiClient::PaymentCardSaleTransactionAllOf
- OpenapiClient::PaymentCardVerificationRequest
- OpenapiClient::PaymentCardVerificationRequestAllOf
- OpenapiClient::PaymentDevice
- OpenapiClient::PaymentDeviceCreditTransaction
- OpenapiClient::PaymentDeviceCreditTransactionAllOf
- OpenapiClient::PaymentDeviceDisbursementTransaction
- OpenapiClient::PaymentDeviceDisbursementTransactionAllOf
- OpenapiClient::PaymentDevicePaymentMethod
- OpenapiClient::PaymentDevicePaymentMethodAllOf
- OpenapiClient::PaymentDevicePaymentTokenizationRequest
- OpenapiClient::PaymentDevicePaymentTokenizationRequestAllOf
- OpenapiClient::PaymentDevicePreAuthTransaction
- OpenapiClient::PaymentDevicePreAuthTransactionAllOf
- OpenapiClient::PaymentDeviceSaleTransaction
- OpenapiClient::PaymentDeviceSaleTransactionAllOf
- OpenapiClient::PaymentFacilitator
- OpenapiClient::PaymentMethodDetails
- OpenapiClient::PaymentMethodPaymentSchedulesRequest
- OpenapiClient::PaymentMethodPaymentSchedulesRequestAllOf
- OpenapiClient::PaymentMethodType
- OpenapiClient::PaymentRegistration
- OpenapiClient::PaymentSchedulesErrorResponse
- OpenapiClient::PaymentSchedulesRequest
- OpenapiClient::PaymentSchedulesResponse
- OpenapiClient::PaymentTokenCreditTransaction
- OpenapiClient::PaymentTokenCreditTransactionAllOf
- OpenapiClient::PaymentTokenDetails
- OpenapiClient::PaymentTokenDetailsAllOf
- OpenapiClient::PaymentTokenDisbursementTransaction
- OpenapiClient::PaymentTokenDisbursementTransactionAllOf
- OpenapiClient::PaymentTokenInfoLookupRequest
- OpenapiClient::PaymentTokenInfoLookupRequestAllOf
- OpenapiClient::PaymentTokenPaymentMethod
- OpenapiClient::PaymentTokenPaymentMethodAllOf
- OpenapiClient::PaymentTokenPreAuthTransaction
- OpenapiClient::PaymentTokenPreAuthTransactionAllOf
- OpenapiClient::PaymentTokenSaleTransaction
- OpenapiClient::PaymentTokenSaleTransactionAllOf
- OpenapiClient::PaymentTokenUpdateResponse
- OpenapiClient::PaymentTokenVerificationRequest
- OpenapiClient::PaymentTokenVerificationRequestAllOf
- OpenapiClient::PaymentTokenizationErrorResponse
- OpenapiClient::PaymentTokenizationRequest
- OpenapiClient::PaymentTokenizationResponse
- OpenapiClient::PaymentUrlDetail
- OpenapiClient::PaymentUrlDetailResponse
- OpenapiClient::PaymentUrlErrorResponse
- OpenapiClient::PaymentUrlRequest
- OpenapiClient::PaymentUrlResponse
- OpenapiClient::PaymentUrlStatus
- OpenapiClient::PaypalCreditTransaction
- OpenapiClient::PaypalCreditTransactionAllOf
- OpenapiClient::Phone
- OpenapiClient::PostAuthTransaction
- OpenapiClient::PostAuthTransactionAllOf
- OpenapiClient::Primary
- OpenapiClient::PrimaryTransaction
- OpenapiClient::ProcessorData
- OpenapiClient::Properties
- OpenapiClient::PurchaseCards
- OpenapiClient::PurchaseCardsLevel2
- OpenapiClient::PurchaseCardsLevel3
- OpenapiClient::PurchaseCardsLevel3LineItems
- OpenapiClient::Receipt
- OpenapiClient::ReceiptLine
- OpenapiClient::ReceiptRequestInfo
- OpenapiClient::ReceiverInfo
- OpenapiClient::RecurringPaymentDetails
- OpenapiClient::RecurringPaymentDetailsResponse
- OpenapiClient::ReferencedOrderPaymentSchedulesRequest
- OpenapiClient::ReferencedOrderPaymentSchedulesRequestAllOf
- OpenapiClient::ReferencedOrderPaymentTokenizationRequest
- OpenapiClient::ReferencedOrderPaymentTokenizationRequestAllOf
- OpenapiClient::RegistrationMethod
- OpenapiClient::RemoveFraudBlockedItemsResponse
- OpenapiClient::ResponseAmountComponents
- OpenapiClient::ResponseAmountComponentsAllOf
- OpenapiClient::ResponseType
- OpenapiClient::ReturnTransaction
- OpenapiClient::ReturnTransactionAllOf
- OpenapiClient::ScoreOnlyRequest
- OpenapiClient::ScoreOnlyResponse
- OpenapiClient::ScoreOnlyResponseFraudScore
- OpenapiClient::ScoreOnlyResponseFraudScoreExplanations
- OpenapiClient::SecondaryTransaction
- OpenapiClient::Secure3D10AuthenticationRequest
- OpenapiClient::Secure3D10AuthenticationRequestAllOf
- OpenapiClient::Secure3D10AuthenticationResult
- OpenapiClient::Secure3D10AuthenticationResultAllOf
- OpenapiClient::Secure3D10AuthenticationUpdateRequest
- OpenapiClient::Secure3D10AuthenticationUpdateRequestAllOf
- OpenapiClient::Secure3D21AuthenticationRequest
- OpenapiClient::Secure3D21AuthenticationRequestAllOf
- OpenapiClient::Secure3D21AuthenticationResult
- OpenapiClient::Secure3D21AuthenticationResultAllOf
- OpenapiClient::Secure3D21AuthenticationUpdateRequest
- OpenapiClient::Secure3D21AuthenticationUpdateRequestAllOf
- OpenapiClient::Secure3DAuthenticationRequest
- OpenapiClient::Secure3DAuthenticationRequestAllOf
- OpenapiClient::Secure3DAuthenticationResponse
- OpenapiClient::Secure3DAuthenticationResponseParams
- OpenapiClient::Secure3DAuthenticationResponseSecure3dMethod
- OpenapiClient::Secure3DAuthenticationResult
- OpenapiClient::Secure3DAuthenticationResultAllOf
- OpenapiClient::Secure3DAuthenticationUpdateRequest
- OpenapiClient::Secure3dResponse
- OpenapiClient::SenderInfo
- OpenapiClient::Sepa
- OpenapiClient::SepaMandate
- OpenapiClient::SepaPaymentMethod
- OpenapiClient::SepaPaymentMethodAllOf
- OpenapiClient::SepaSaleTransaction
- OpenapiClient::SepaSaleTransactionAllOf
- OpenapiClient::SharedSecretConfigurationRequest
- OpenapiClient::SharedSecretConfigurationResponse
- OpenapiClient::ShipToAddress
- OpenapiClient::Shipping
- OpenapiClient::SofortSetup
- OpenapiClient::SofortSetupResponse
- OpenapiClient::SoftDescriptor
- OpenapiClient::SplitShipment
- OpenapiClient::StoreBrandingStyleConfiguration
- OpenapiClient::StoreEmailSettings
- OpenapiClient::StoreEmailSettingsResult
- OpenapiClient::StoreFraudSettings
- OpenapiClient::StoreFraudSettingsResult
- OpenapiClient::StoreUrlConfiguration
- OpenapiClient::StoreUrlConfigurationRequest
- OpenapiClient::StoreUrlConfigurationResponse
- OpenapiClient::StoreUrlConfigurationResult
- OpenapiClient::StoredCredential
- OpenapiClient::SubMerchantData
- OpenapiClient::SubMerchantSplit
- OpenapiClient::TeleCheckAchPaymentMethod
- OpenapiClient::TeleCheckAchPaymentMethodAchBillTo
- OpenapiClient::TeleCheckCBPPaymentMethod
- OpenapiClient::TeleCheckICAPaymentMethod
- OpenapiClient::TeleCheckICAPaymentMethodAllOf
- OpenapiClient::Text
- OpenapiClient::Title
- OpenapiClient::TokenIdentifier
- OpenapiClient::TopBar
- OpenapiClient::TransactionErrorResponse
- OpenapiClient::TransactionOrigin
- OpenapiClient::TransactionResponse
- OpenapiClient::TransactionType
- OpenapiClient::UnionPayAuthenticationRequest
- OpenapiClient::UnionPayAuthenticationRequestAllOf
- OpenapiClient::UnionPayAuthenticationUpdateRequest
- OpenapiClient::UnionPayAuthenticationUpdateRequestAllOf
- OpenapiClient::UpdateEmailSettingsRequest
- OpenapiClient::UpdateEmailSettingsResponse
- OpenapiClient::UpdateFraudSettingsRequest
- OpenapiClient::UpdateFraudSettingsResponse
- OpenapiClient::UpdatePaymentToken
- OpenapiClient::UsePaymentToken
- OpenapiClient::Verification3ds
- OpenapiClient::VerificationAvs
- OpenapiClient::VerificationCvv
- OpenapiClient::VoidPreAuthTransactions
- OpenapiClient::VoidTransaction
- OpenapiClient::VoidTransactionAllOf
- OpenapiClient::WalletPaymentMethod
- OpenapiClient::WalletPreAuthTransaction
- OpenapiClient::WalletPreAuthTransactionAllOf
- OpenapiClient::WalletSaleTransaction
- OpenapiClient::WalletSaleTransactionAllOf
All endpoints do not require authorization.