Payment Method Distribution

In addition to built-in gateway integration, Spreedly supports the ability to distribute vaulted credit card data to non-gateway third parties, referred to as “receivers”. Distribution differs from third-party vaulting in that the recipient of the card data is not a known and supported gateway; it can be another third party with whom you do business.

How distribution works

Payment method distribution (PMD) allows you to transact against another service’s API while still controlling your customer’s card data by vaulting with Spreedly.

Consider a travel service that books accomodations on behalf of its users. The travel service would be able to store its customers’ card data in Spreedly up front and use that data to purchase airline and hotel reservations on behalf of its customers later. The service would ask its customers to enter their credit card information only once but would be able to use that information at any later time to make purchases at multiple independent services (e.g., airlines and hotels).

Spreedly’s payment method distribution enables businesses to transact with multiple endpoints on behalf of their customers via a single integration.

Single vs. batch distribution

Payment method distribution (PMD) can operate in two modes: single card PMD or batch export PMD. If you’re working with an external HTTPS API endpoint that accepts a single card per call, then use single card PMD. If you’re working with an SFTP endpoint that accepts a file containing multiple cards, then use batch export PMD.

In both modes, the basic workflow remains the same: you specify a template that tells Spreedly how to format the request and which card(s) to deliver, and Spreedly executes the call on your behalf. Spreedly provides an open repository of code templates for simplifying implementation of new receivers. The single card and batch export PMD modes operate very similarly; one small difference between the two is that batch export operates asynchronously, making it a bit more complex.

The following guides explain how to provision a receiver and how to distribute payment methods for the two PMD modes:

Supporting your receiver

You can begin developing and testing your PMD workflow using a test receiver. However, before you can distribute real payment method data, your receiver must be confirmed and implemented by Spreedly. Please email the following information to Spreedly to get your receiver in the approval queue:

  • the receiver name and/or company name,
  • a link to their public site, and
  • the production URL you will be invoking with Spreedly payment data. Note that the production URL must utilize SSL.

While the endpoint must utilize SSL, Spreedly does not require the SSL certificate to set up and allow the domain, which ensures that you are not affected when the receiver updates their certificates. If there will be a domain change, please contact Spreedly Support and let us know in advance.

Alternatively, if you have an existing relationship or contact at the receiver company, you can send them to Becoming a Receiver so that they can work with Spreedly directly.

We ask that you allow several weeks for Spreedly to approve and configure a receiver for production use. During this time, you can begin testing against a test receiver, which simulates the delivery of test payment methods to a user-specified endpoint URL. We will return the parsed and formatted request in the delivery response, with sensitive data scrubbed, but we will not deliver the request to a third-party endpoint. The test receiver allows you to validate the deliver API request while ensuring the request is properly formatted using our provided receiver variables and functions.

Once you’ve set up your receiver, you can see which requests are powered by Spreedly by looking for the X-Transaction-Powered-By: Spreedly header. Filtering requests to ones with this header can be helpful for debugging and for tracking Spreedly-originating transactions.

List of supported receivers

We currently support the following receiver types and their associated URLs:

Company Receiver Type and Hostnames
A1 Payments a1_payments
Ace Rent a Car ace_rent_a_car
Adquira adquira
Adyen MarketPay adyen_marketpay
Adyen adyen,,,
Airtime Rewards airtime
Alliance Reservations Network alliance_reservations_network
Allianz Global Assistance allianz_global_assistance,
American Express american_express,,,,
s authorize_net,,
AXS axs
Bankwest bankwest
Base Commerce base_commerce
BBC Shop bbc_shop
BestBus bestbus
Bexs bexs,
Bink bink
Blackbaud blackbaud
Blacklane blacklane
Blue Ribbon Bags blue_ribbon_bags
Bluesnap bluesnap bookingcom
Braintree Payments braintree,,,
Budco Financial budco_financial,,
Bypass Mobile bypass_mobile
Bytemark bytemark,
CarTrawler car_trawler,
Carbon carbon,
CardConnect CardSecure cardconnect_cardsecure
Cardstream cardstream
Cashbackpoint cashbackpoint
CASHNet cashnet
CDS Global cds_global
CECABank ceca_bank,
Chain Commerce chain_commerce checkout_dot_com,,
Cielo cielo,,,
Cliq cliq
Clover clover,,
Clover Tokenization clover_tokenization,
Coalesce Services coalesce_services
Cosmic Cart cosmic_cart
CreditGuard creditguard,
Credomatic credomatic
Credorax credorax,
CrowdTorch crowd_torch
Cybersource Decision Manager cybersource_decision_manager,
CyberSource cybersource
Dalenys dalenys,,,
Mastercard Payment Gateway Services data_cash
Demandware demandware
DHISCO dhisco
Diane Von Furstenberg dvf
Expedia Affiliate Network ean,,
ecommpay ecommpay
Economy Rent a Car economy_rent_a_car
eGlobalfares eglobalfares
8D eight_d,,,,,,,
emerchantpay emerchantpay
ePay epay
Electronic Payment Exchange epx
Eventbrite eventbrite
Expedia expedia
FanXchange fan_xchange,,
Farelogix farelogix,
Fidel fidel
Finix Payments finix_payments,,
First Data India Pvt Ltd. first_data_india,
First Pay first_pay
FreedomPay freedom_pay,
Global Technology Partners global_technology_partners
Golf18Network golf18_network
GolfNow golf_now
Green Dot green_dot,,,,,
Heidelpay heidelpay
Hertz hertz,,
Hotel Planner hotel_planner
iFly Res (IBS) iflyres,
Ingenico ingenico,
IXOPAY ixopay
JEM Marketing jem_marketing
JustRide justride,
JustShareIt justshareit
Kount kount ,
Lincoln Center lincoln_center,
Luminate Online luminate_online,
Lyft Bikes lyft_bikes
Mastercard mastercard_services,
Moonpay moonpay,
First Data muxi_gateway_test_firstdata,
Navitaire navitaire
Network for Good network_for_good
NLS Payments nls_payments
NP Auto np_auto
NÜ Car Rentals nu_car_rentals
Nuvei nuvei,
Office Depot office_depot
Olo olo,
Omnivore omnivore
1-800-Flowers one800_flowers
ONPEX onpex
Open Hotel open_hotel
Ordway Labs ordway_labs
Pace Payment Systems pace_payment_systems
PagoPlux pago_plux,,
PayFabric pay_fabric
Paycorp paycorp
Payflow payflow,
Paymark Click paymark_click
PayPal paypal
Payreto payreto,
Payvision payvision
PayWire paywire,
PBSC pbsc,,,,,,,,,,,,,,
PCI Booking pci_booking
plugnpay plug_n_pay
Poynt poynt,
Priceline priceline,
PrimeSport prime_sport
Prisma prisma,,
PromisePay promisepay
Qualpay, Inc qualpay
Ravelin ravelin
RedCoach red_coach
RedShield red_shield, rentalcars,
Reward reward,
Routes Car Rental routes_car_rental
Sabre sabre,,,,,,
SafeCharge safe_charge,
SIX Payment Services saferpay,
Sage Pay sage_pay
SecurionPay securion_pay
SendWyre send_wyre,
Shopify shopify
Shoppable shoppable,
SiteMinder site_minder,
Sixt sixt
SpeedPay speedpay
Spreedly spreedly sprinterbus_net
Stone stone,
Storebox storebox
Stripe stripe
SynXis synxis
SysPay syspay
Target target
Transcor Data Services tds_tickets
Telecharge telecharge,,,,
Tempus Technologies tempus
Tessitura tessitura_ramp
3C Payment Web2Pay three_c_web2pay,, ticket_network
Ticketmaster ticketmaster,
Toast toast,,
TokenEx tokenex
TransferWise transferwise
Travelfusion travel_fusion
Travelport travelport,
Travolutionary travolutionary
Truevo truevo
Trust Payments trust_payments,
TSD tsd
Two Tap two_tap
USAePay usaepay,
RentPayment vacation_rent_payment,
Vervotech vervotech,
Viator viator
Virtual Card Services virtual_card_services
Visa visa,,
Viva Air viva_air,
Walpay walpay
Wantickets wantickets
Webinc webinc
Windsurfer CRS windsurfer_crs,,
Wirecard Brasil wirecard_brasil
Wirecard wirecard
Worldline worldline,
Worldpay worldpay,,
Worldpay RiskGuardian worldpay_riskguardian,,,
YapStone yapstone