PayPal Commerce Platform gateway guide

curl https://core.spreedly.com/v1/gateways.xml \
-u 'C7cRfNJGODKh4Iu5Ox3PToKjniY:4UIuWybmdythfNGPqAqyQnYha6s451ri0fYAo4p3drZUi7q2Jf4b7HKg8etDtoKJ' \
-H 'Content-Type: application/xml' \
-d '<gateway>
  <gateway_type>paypal_commerce_platform</gateway_type>
  <login>client id</login>
  <password>secret</password>
</gateway>'

<gateway>
  <token>YovvB1bIN56lvJedMbTBiqGg4CG</token>
  <gateway_type>paypal_commerce_platform</gateway_type>
  <name>PayPal Commerce Platform</name>
  <description nil="true"/>
  <merchant_profile_key nil="true"/>
  <sub_merchant_key nil="true"/>
  <login>client id</login>
  <characteristics>
    <supports_purchase type="boolean">true</supports_purchase>
    <supports_authorize type="boolean">true</supports_authorize>
    <supports_capture type="boolean">true</supports_capture>
    <supports_credit type="boolean">true</supports_credit>
    <supports_general_credit type="boolean">true</supports_general_credit>
    <supports_void type="boolean">true</supports_void>
    <supports_adjust type="boolean">false</supports_adjust>
    <supports_verify type="boolean">false</supports_verify>
    <supports_reference_purchase type="boolean">false</supports_reference_purchase>
    <supports_purchase_via_preauthorization type="boolean">true</supports_purchase_via_preauthorization>
    <supports_offsite_purchase type="boolean">true</supports_offsite_purchase>
    <supports_offsite_authorize type="boolean">true</supports_offsite_authorize>    
    <supports_offsite_synchronous_authorize type="boolean">false</supports_offsite_synchronous_authorize>
    <supports_3dsecure_purchase type="boolean">false</supports_3dsecure_purchase>
    <supports_3dsecure_authorize type="boolean">false</supports_3dsecure_authorize>
    <supports_3dsecure_2_mpi_purchase type="boolean">false</supports_3dsecure_2_mpi_purchase>
    <supports_3dsecure_2_mpi_authorize type="boolean">false</supports_3dsecure_2_mpi_authorize>
    <supports_store type="boolean">false</supports_store>
    <supports_remove type="boolean">false</supports_remove>
    <supports_fraud_review type="boolean">false</supports_fraud_review>
    <supports_network_tokenization type="boolean">false</supports_network_tokenization>
    <supports_populate_mit_fields type="boolean">false</supports_populate_mit_fields>
    <supports_inquire_by_order_id type="boolean">false</supports_inquire_by_order_id>
    <supports_transaction_retry type="boolean">false</supports_transaction_retry>
    <supports_stored_stored_credentials type="boolean">false</supports_stored_stored_credentials>
    <supports_reference_authorization type="boolean">true</supports_reference_authorization>
    <supports_stored_credentials type="boolean">true</supports_stored_credentials>
  </characteristics>
  <credentials>
    <credential>
      <name>login</name>
      <value>client id</value>
    </credential>
  </credentials>
  <gateway_settings>
  </gateway_settings>
  <gateway_specific_fields>
    <gateway_specific_field>notify_url</gateway_specific_field>
    <gateway_specific_field>recurring</gateway_specific_field>
    <gateway_specific_field>paypal_request_id</gateway_specific_field>
    <gateway_specific_field>soft_descriptor</gateway_specific_field>
    <gateway_specific_field>invoice_id</gateway_specific_field>
    <gateway_specific_field>custom_id</gateway_specific_field>
    <gateway_specific_field>shipping_method</gateway_specific_field>
    <gateway_specific_field>payment_group_id</gateway_specific_field>
    <gateway_specific_field>insurance</gateway_specific_field>
    <gateway_specific_field>tax_total</gateway_specific_field>
    <gateway_specific_field>handling</gateway_specific_field>
    <gateway_specific_field>shipping_discount</gateway_specific_field>
    <gateway_specific_field>discount</gateway_specific_field>
    <gateway_specific_field>item_total</gateway_specific_field>
    <gateway_specific_field>shipping</gateway_specific_field>
    <gateway_specific_field>landing_page</gateway_specific_field>
    <gateway_specific_field>payee_preferred</gateway_specific_field>
    <gateway_specific_field>user_action</gateway_specific_field>
    <gateway_specific_field>brand_name</gateway_specific_field>
    <gateway_specific_field>shipping_preference</gateway_specific_field>
    <gateway_specific_field>items</gateway_specific_field>
    <gateway_specific_field>payer</gateway_specific_field>
    <gateway_specific_field>application_context</gateway_specific_field>
    <gateway_specific_field>purchase_units</gateway_specific_field>
    <gateway_specific_field>order_only</gateway_specific_field>
    <gateway_specific_field>payee</gateway_specific_field>
    <gateway_specific_field>uuid</gateway_specific_field>
    <gateway_specific_field>recipient_type</gateway_specific_field>
    <gateway_specific_field>recipient_wallet</gateway_specific_field>
    <gateway_specific_field>reference_id</gateway_specific_field>
    <gateway_specific_field>email_subject</gateway_specific_field>
    <gateway_specific_field>email_message</gateway_specific_field>
  </gateway_specific_fields>
  <payment_methods>
    <payment_method>credit_card</payment_method>
    <payment_method>paypal</payment_method>
  </payment_methods>
  <state>retained</state>
  <redacted type="boolean">false</redacted>
  <sandbox type="boolean">false</sandbox>
  <mode>default</mode>
  <created_at type="dateTime">2022-12-04T00:20:28Z</created_at>
  <updated_at type="dateTime">2022-12-04T00:20:28Z</updated_at>
</gateway>

{
    "transaction": {
        "amount": "10000",
        "currency_code": "USD",
        "payment_method_token": "WhsZJQF38pRlQ0ipiEtpMp8MKN7",
        "redirect_url": "https://redirect.example.com/",
        "callback_url": "https://callback.example.com/",
        "gateway_specific_fields": {
            "paypal_commerce_platform": {
                 "purchase_units": {
                        "soft_descriptor": "Soft Descriptor",
                        "breakdown": {
                            "item_total":9000,
                            "tax_total": 1000
                        },
                        "items": [
                            {
                                "name": "Widget",
                                "tax": 1000,
                                "value": 9000
                            }
                        ]
                    }
            }
        }
    }
}

{
    "transaction": {
        "amount": "10000",
        "currency_code": "USD",
        "payment_method_token": "WhsZJQF38pRlQ0ipiEtpMp8MKN7",
        "redirect_url": "https://redirect.example.com/",
        "callback_url": "https://callback.example.com/",
        "gateway_specific_fields": {
            "paypal_commerce_platform": {
                "airline_data": [
                  {
                    "flight_leg_details": [
                      {
                          "arrival_airport": "LAX",
                          "carrier_code": "AI",
                          "departure_airport": "SEA",
                          "departure_date": "2020-02-15",
                          "departure_time": "12:23",
                          "fare_basis_code": "SPRSVR",
                          "flight_code": "A37",
                          "flight_number": "123",
                          "service_class": "A",
                          "stopover_code": "X"
                      },
                      {
                          "arrival_airport": "SFO",
                          "carrier_code": "AI",
                          "departure_airport": "LAX",
                          "departure_date": "2020-02-15",
                          "departure_time": "14:23",
                          "fare_basis_code": "SPRSVR",
                          "flight_code": "AAA",
                          "flight_number": "321",
                          "service_class": "B",
                          "stopover_code": "X"
                      }
                    ],
                    "passenger": {
                        "country_code": "US",
                        "date_of_birth": "1990-02-15",
                        "full_name": "john john"
                    },
                    "ticket": {
                        "number": "045-21351455613",
                        "issue_date": "2020-01-14",
                        "issuing_carrier_code": "AI",
                        "travel_agency_name": "World Tours",
                        "travel_agency_code": "01"
                    }
                  }
                ]
            }
        }
    }
}

curl https://core.spreedly.com/v1/gateways/LlkjmEk0xNkcWrNixXa1fvNoTP4/authorize.xml \
  -u 'C7cRfNJGODKh4Iu5Ox3PToKjniY:4UIuWybmdythfNGPqAqyQnYha6s451ri0fYAo4p3drZUi7q2Jf4b7HKg8etDtoKJ' \
  -H 'Content-Type: application/xml' \
  -d '<transaction>
        <payment_method_token>56wyNnSmuA6CWYP7w0MiYCVIbW6</payment_method_token>
        <amount>100</amount>
        <currency_code>USD</currency_code>
        <gateway_specific_fields>
          <paypal_commerce_platform>
            <notify_url></notify_url>
            <recurring></recurring>
            <paypal_request_id></paypal_request_id>
            <final_capture></final_capture>
            <purchase_units>
              <soft_descriptor></soft_descriptor>
              <invoice_id></invoice_id>
              <custom_id></custom_id>
              <shipping_method></shipping_method>
              <payment_group_id></payment_group_id>
              <breakdown>
                <insurance></insurance>
                <tax_total></tax_total>
                <handling></handling>
                <shipping_discount></shipping_discount>
                <discount></discount>
                <shipping></shipping>
                <item_total></item_total>
              </breakdown>
              <items>
                <name></name>
                <sku></sku>
                <category></category>
                <quantity></quantity>
                <tax></tax>
                <value></value>
              </items>
            </purchase_units>
            <airline_data>
              <flight_leg_details>
                <arrival_airport></arrival_airport>
                <carrier_code></carrier_code>
                <departure_airport></departure_airport>
                <departure_date></departure_date>
                <departure_time></departure_time>
                <fare_basis_code></fare_basis_code>
                <flight_code></flight_code>
                <flight_number></flight_number>
                <service_class></service_class>
                <stopover_code></stopover_code>
              </flight_leg_details>
              <passenger>
                <country_code></country_code>
                <date_of_birth></date_of_birth>
                <full_name></full_name>
              </passenger>
              <ticket>
                <number></number>
                <issue_date></issue_date>
                <issuing_carrier_code></issuing_carrier_code>
                <travel_agency_name></travel_agency_name>
                <travel_agency_code></travel_agency_code>
              </ticket>
            </airline_data>
            <payer></payer>
            <application_context>
              <landing_page></landing_page>
              <user_action></user_action>
              <brand_name></brand_name>
              <shipping_preference></shipping_preference>
              <payee_preferred></payee_preferred>
            </application_context>
            <payee>
              <merchant_id></merchant_id>
              <email></email>
            </payee>
            <uuid></uuid>
            <recipient_type></recipient_type>
            <recipient_wallet></recipient_wallet>
            <reference_id></reference_id>
            <email_subject></email_subject>
            <email_message></email_message>
          </paypal_commerce_platform>
        </gateway_specific_fields>
      </transaction>'

<transaction>
  <on_test_gateway type="boolean">true</on_test_gateway>
  <created_at type="dateTime">2023-10-16T21:41:50Z</created_at>
  <updated_at type="dateTime">2023-10-16T21:41:50Z</updated_at>
  <succeeded type="boolean">true</succeeded>
  <state>succeeded</state>
  <token>OhK9Z46X8ffS0b3NGiCVMUv2FG2</token>
  <transaction_type>Authorization</transaction_type>
  <order_id nil="true"/>
  <ip nil="true"/>
  <description nil="true"/>
  <email nil="true"/>
  <merchant_name_descriptor nil="true"/>
  <merchant_location_descriptor nil="true"/>
  <merchant_profile_key nil="true"/>
  <gateway_specific_fields>
    <paypal_commerce_platform>
      <notify_url nil="true"/>
      <recurring nil="true"/>
      <paypal_request_id nil="true"/>
      <final_capture nil="true"/>
      <purchase_units>
        <soft_descriptor nil="true"/>
        <invoice_id nil="true"/>
        <custom_id nil="true"/>
        <shipping_method nil="true"/>
        <payment_group_id nil="true"/>
        <breakdown>
          <insurance nil="true"/>
          <tax_total nil="true"/>
          <handling nil="true"/>
          <shipping_discount nil="true"/>
          <discount nil="true"/>
          <shipping nil="true"/>
          <item_total nil="true"/>
        </breakdown>
        <items>
          <name nil="true"/>
          <sku nil="true"/>
          <category nil="true"/>
          <quantity nil="true"/>
          <tax nil="true"/>
          <value nil="true"/>
        </items>
      </purchase_units>
      <airline_data>
        <flight_leg_details>
          <arrival_airport nil="true"/>
          <carrier_code nil="true"/>
          <departure_airport nil="true"/>
          <departure_date nil="true"/>
          <departure_time nil="true"/>
          <fare_basis_code nil="true"/>
          <flight_code nil="true"/>
          <flight_number nil="true"/>
          <service_class nil="true"/>
          <stopover_code nil="true"/>
        </flight_leg_details>
        <passenger>
          <country_code nil="true"/>
          <date_of_birth nil="true"/>
          <full_name nil="true"/>
        </passenger>
        <ticket>
          <number nil="true"/>
          <issue_date nil="true"/>
          <issuing_carrier_code nil="true"/>
          <travel_agency_name nil="true"/>
          <travel_agency_code nil="true"/>
        </ticket>
      </airline_data>
      <payer nil="true"/>
      <application_context>
        <landing_page nil="true"/>
        <user_action nil="true"/>
        <brand_name nil="true"/>
        <shipping_preference nil="true"/>
        <payee_preferred nil="true"/>
      </application_context>
      <payee>
        <merchant_id nil="true"/>
        <email nil="true"/>
      </payee>
      <uuid nil="true"/>
      <recipient_type nil="true"/>
      <recipient_wallet nil="true"/>
      <reference_id nil="true"/>
      <email_subject nil="true"/>
      <email_message nil="true"/>
    </paypal_commerce_platform>
  </gateway_specific_fields>
  <gateway_specific_response_fields>
  </gateway_specific_response_fields>
  <gateway_transaction_id>46</gateway_transaction_id>
  <sub_merchant_key nil="true"/>
  <gateway_latency_ms type="integer">1</gateway_latency_ms>
  <warning nil="true"/>
  <application_id nil="true"/>
  <amount type="integer">100</amount>
  <local_amount nil="true"/>
  <currency_code>USD</currency_code>
  <retain_on_success type="boolean">false</retain_on_success>
  <payment_method_added type="boolean">false</payment_method_added>
  <smart_routed type="boolean">false</smart_routed>
  <stored_credential_initiator nil="true"/>
  <stored_credential_reason_type nil="true"/>
  <stored_credential_alternate_gateway nil="true"/>
  <populate_mit_fields type="boolean">false</populate_mit_fields>
  <message key="messages.transaction_succeeded">Succeeded!</message>
  <gateway_token>T11bJAANtTWnxl36GYjKWvbNK0g</gateway_token>
  <gateway_type>test</gateway_type>
  <shipping_address>
    <name>Newfirst Newlast</name>
    <address1 nil="true"/>
    <address2 nil="true"/>
    <city nil="true"/>
    <state nil="true"/>
    <zip nil="true"/>
    <country nil="true"/>
    <phone_number nil="true"/>
  </shipping_address>
  <response>
    <success type="boolean">true</success>
    <message>Successful authorize</message>
    <avs_code nil="true"/>
    <avs_message nil="true"/>
    <cvv_code nil="true"/>
    <cvv_message nil="true"/>
    <pending type="boolean">false</pending>
    <result_unknown type="boolean">false</result_unknown>
    <error_code nil="true"/>
    <error_detail nil="true"/>
    <cancelled type="boolean">false</cancelled>
    <fraud_review nil="true"/>
    <created_at type="dateTime">2023-10-16T21:41:50Z</created_at>
    <updated_at type="dateTime">2023-10-16T21:41:50Z</updated_at>
  </response>
  <api_urls>
  </api_urls>
  <payment_method>
    <token>1rpKvP8zOUhj4Y9EDrIoIYQzzD5</token>
    <created_at type="dateTime">2017-06-26T17:04:38Z</created_at>
    <updated_at type="dateTime">2023-10-05T22:14:11Z</updated_at>
    <email>[email protected]</email>
    <data>
      <my_payment_method_identifier>448</my_payment_method_identifier>
      <extra_stuff>
        <some_other_things>Can be anything really</some_other_things>
      </extra_stuff>
    </data>
    <storage_state>retained</storage_state>
    <test type="boolean">true</test>
    <metadata>
      <key>string value</key>
    </metadata>
    <callback_url nil="true"/>
    <last_four_digits>1111</last_four_digits>
    <first_six_digits>411111</first_six_digits>
    <card_type>visa</card_type>
    <first_name>Newfirst</first_name>
    <last_name>Newlast</last_name>
    <month type="integer">3</month>
    <year type="integer">2032</year>
    <address1 nil="true"/>
    <address2 nil="true"/>
    <city nil="true"/>
    <state nil="true"/>
    <zip nil="true"/>
    <country nil="true"/>
    <phone_number nil="true"/>
    <company nil="true"/>
    <full_name>Newfirst Newlast</full_name>
    <eligible_for_card_updater type="boolean">true</eligible_for_card_updater>
    <shipping_address1 nil="true"/>
    <shipping_address2 nil="true"/>
    <shipping_city nil="true"/>
    <shipping_state nil="true"/>
    <shipping_zip nil="true"/>
    <shipping_country nil="true"/>
    <shipping_phone_number nil="true"/>
    <issuer_identification_number nil="true"/>
    <click_to_pay type="boolean">false</click_to_pay>
    <managed nil="true"/>
    <payment_method_type>credit_card</payment_method_type>
    <stored_credential_usage>
      <test>
        <original_network_transaction_id>37be5367d6dbe4a88c9d</original_network_transaction_id>
        <network_transaction_id>37be5367d6dbe4a88c9d</network_transaction_id>
      </test>
    </stored_credential_usage>
    <errors>
    </errors>
    <verification_value></verification_value>
    <number>XXXX-XXXX-XXXX-1111</number>
    <fingerprint>e3cef43464fc832f6e04f187df25af497994</fingerprint>
  </payment_method>
  <attempt_3dsecure type="boolean">false</attempt_3dsecure>
</transaction>

<transaction>
  <token>XspZooGud4SNm5Id9iwHHpWReIs</token>
  <transaction_type>OffsiteAuthorization</transaction_type>
  <gateway_specific_response_fields>
    <paypal_commerce_platform>
      <payer>[email protected]</payer>
      <first_name>Waxillium</first_name>
      <last_name>Ladrian</last_name>
      <billing_street1>3911 Main Street</billing_street1>
      <billing_city>Wanaque</billing_city>
      <billing_state_or_province>NJ</billing_state_or_province>
      <billing_zip>28592-8851</billing_zip>
      <billing_country>US</billing_country>
      <shipping_name>Waxillium</shipping_name>
      <shipping_address>
        <address_line_1>3911 Main Street</address_line_1>
        <admin_area_2>Wanaque</admin_area_2>
        <admin_area_1>NJ</admin_area_1>
        <postal_code>28592-8851</postal_code>
        <country_code>US</country_code>
      </shipping_address>
      <email>[email protected]</email>
      <merchant_id>MI12ABC890XYZ</merchant_id>
      <issue>TAX_MISMATCH</issue>
      <national_number>0011234567890</national_number>
    </paypal_commerce_platform>
  </gateway_specific_response_fields>
</transaction>