Actions
4 years ago
Controllers
4 years ago
Migrations
4 years ago
Views
4 years ago
Webhooks
4 years ago
resources
4 years ago
PayPalStandard.php
3 years ago
PayPalStandard.php
258 lines
| 1 | <?php |
| 2 | |
| 3 | namespace Give\PaymentGateways\Gateways\PayPalStandard; |
| 4 | |
| 5 | use Give\Donations\Models\Donation; |
| 6 | use Give\Framework\Exceptions\Primitives\Exception; |
| 7 | use Give\Framework\Http\Response\Types\RedirectResponse; |
| 8 | use Give\Framework\PaymentGateways\Commands\RedirectOffsite; |
| 9 | use Give\Framework\PaymentGateways\PaymentGateway; |
| 10 | use Give\Helpers\Call; |
| 11 | use Give\PaymentGateways\Gateways\PayPalStandard\Actions\CreatePayPalStandardPaymentURL; |
| 12 | use Give\PaymentGateways\Gateways\PayPalStandard\Actions\GenerateDonationFailedPageUrl; |
| 13 | use Give\PaymentGateways\Gateways\PayPalStandard\Actions\GenerateDonationReceiptPageUrl; |
| 14 | use Give\PaymentGateways\Gateways\PayPalStandard\Controllers\PayPalStandardWebhook; |
| 15 | use Give\PaymentGateways\Gateways\PayPalStandard\Views\PayPalStandardBillingFields; |
| 16 | use Give_Payment; |
| 17 | |
| 18 | /** |
| 19 | * @since 2.19.0 |
| 20 | */ |
| 21 | class PayPalStandard extends PaymentGateway |
| 22 | { |
| 23 | public $routeMethods = [ |
| 24 | 'handleIpnNotification', |
| 25 | ]; |
| 26 | |
| 27 | public $secureRouteMethods = [ |
| 28 | 'handleSuccessPaymentReturn', |
| 29 | 'handleFailedPaymentReturn', |
| 30 | ]; |
| 31 | |
| 32 | /** |
| 33 | * @inheritDoc |
| 34 | */ |
| 35 | public function getLegacyFormFieldMarkup(int $formId, array $args): string |
| 36 | { |
| 37 | return Call::invoke(PayPalStandardBillingFields::class, $formId); |
| 38 | } |
| 39 | |
| 40 | /** |
| 41 | * @inheritDoc |
| 42 | */ |
| 43 | public static function id(): string |
| 44 | { |
| 45 | return 'paypal'; |
| 46 | } |
| 47 | |
| 48 | /** |
| 49 | * @inerhitDoc |
| 50 | */ |
| 51 | public function getId(): string |
| 52 | { |
| 53 | return self::id(); |
| 54 | } |
| 55 | |
| 56 | /** |
| 57 | * @inheritDoc |
| 58 | */ |
| 59 | public function getName(): string |
| 60 | { |
| 61 | return esc_html__('PayPal Standard', 'give'); |
| 62 | } |
| 63 | |
| 64 | /** |
| 65 | * @inheritDoc |
| 66 | */ |
| 67 | public function getPaymentMethodLabel(): string |
| 68 | { |
| 69 | return esc_html__('PayPal', 'give'); |
| 70 | } |
| 71 | |
| 72 | /** |
| 73 | * @inheritDoc |
| 74 | */ |
| 75 | public function createPayment(Donation $donation, $gatewayData = []): RedirectOffsite |
| 76 | { |
| 77 | return new RedirectOffsite( |
| 78 | Call::invoke( |
| 79 | CreatePayPalStandardPaymentURL::class, |
| 80 | $donation, |
| 81 | $this->generateSecureGatewayRouteUrl( |
| 82 | 'handleSuccessPaymentReturn', |
| 83 | $donation->id, |
| 84 | ['donation-id' => $donation->id] |
| 85 | ), |
| 86 | $this->generateSecureGatewayRouteUrl( |
| 87 | 'handleFailedPaymentReturn', |
| 88 | $donation->id, |
| 89 | ['donation-id' => $donation->id] |
| 90 | ), |
| 91 | $this->generateGatewayRouteUrl( |
| 92 | 'handleIpnNotification' |
| 93 | ) |
| 94 | ) |
| 95 | ); |
| 96 | } |
| 97 | |
| 98 | /** |
| 99 | * Handle payment redirect after successful payment on PayPal standard. |
| 100 | * |
| 101 | * @since 2.19.0 |
| 102 | * @since 2.19.4 Only pending PayPal Standard donation set to processing. |
| 103 | * @since 2.19.6 1. Do not set donation to "processing" |
| 104 | * 2. Add "payment-confirmation" param to receipt page url |
| 105 | * |
| 106 | * @param array $queryParams Query params in gateway route. { |
| 107 | * |
| 108 | * @type string "donation-id" Donation id. |
| 109 | * |
| 110 | * } |
| 111 | */ |
| 112 | protected function handleSuccessPaymentReturn(array $queryParams): RedirectResponse |
| 113 | { |
| 114 | $donationId = (int)$queryParams['donation-id']; |
| 115 | |
| 116 | return new RedirectResponse( |
| 117 | esc_url_raw( |
| 118 | add_query_arg( |
| 119 | ['payment-confirmation' => $this->getId()], |
| 120 | Call::invoke(GenerateDonationReceiptPageUrl::class, $donationId) |
| 121 | ) |
| 122 | ) |
| 123 | ); |
| 124 | } |
| 125 | |
| 126 | /** |
| 127 | * Handle payment redirect after failed payment on PayPal standard. |
| 128 | * |
| 129 | * @since 2.19.0 |
| 130 | * |
| 131 | * @param array $queryParams Query params in gateway route. { |
| 132 | * |
| 133 | * @type string "donation-id" Donation id. |
| 134 | * |
| 135 | * } |
| 136 | */ |
| 137 | protected function handleFailedPaymentReturn(array $queryParams): RedirectResponse |
| 138 | { |
| 139 | $donationId = (int)$queryParams['donation-id']; |
| 140 | $payment = new Give_Payment($donationId); |
| 141 | $payment->update_status('failed'); |
| 142 | |
| 143 | return new RedirectResponse(Call::invoke(GenerateDonationFailedPageUrl::class, $donationId)); |
| 144 | } |
| 145 | |
| 146 | /** |
| 147 | * Handle PayPal IPN notification. |
| 148 | * |
| 149 | * @since 2.19.0 |
| 150 | */ |
| 151 | public function handleIpnNotification() |
| 152 | { |
| 153 | give(PayPalStandardWebhook::class)->handle(); |
| 154 | } |
| 155 | |
| 156 | /** |
| 157 | * This function returns payment gateway settings. |
| 158 | * |
| 159 | * @since 2.19.0 |
| 160 | * |
| 161 | * @return array |
| 162 | */ |
| 163 | public function getOptions() |
| 164 | { |
| 165 | $setting = [ |
| 166 | // Section 2: PayPal Standard. |
| 167 | [ |
| 168 | 'type' => 'title', |
| 169 | 'id' => 'give_title_gateway_settings_2', |
| 170 | ], |
| 171 | [ |
| 172 | 'name' => esc_html__('PayPal Email', 'give'), |
| 173 | 'desc' => esc_html__( |
| 174 | 'Enter the email address associated with your PayPal account to connect with the gateway.', |
| 175 | 'give' |
| 176 | ), |
| 177 | 'id' => 'paypal_email', |
| 178 | 'type' => 'email', |
| 179 | ], |
| 180 | [ |
| 181 | 'name' => esc_html__('PayPal Page Style', 'give'), |
| 182 | 'desc' => esc_html__( |
| 183 | 'Enter the name of the PayPal page style to use, or leave blank to use the default.', |
| 184 | 'give' |
| 185 | ), |
| 186 | 'id' => 'paypal_page_style', |
| 187 | 'type' => 'text', |
| 188 | ], |
| 189 | [ |
| 190 | 'name' => esc_html__('PayPal Transaction Type', 'give'), |
| 191 | 'desc' => esc_html__( |
| 192 | 'Nonprofits must verify their status to withdraw donations they receive via PayPal. PayPal users that are not verified nonprofits must demonstrate how their donations will be used, once they raise more than $10,000. By default, GiveWP transactions are sent to PayPal as donations. You may change the transaction type using this option if you feel you may not meet PayPal\'s donation requirements.', |
| 193 | 'give' |
| 194 | ), |
| 195 | 'id' => 'paypal_button_type', |
| 196 | 'type' => 'radio_inline', |
| 197 | 'options' => [ |
| 198 | 'donation' => esc_html__('Donation', 'give'), |
| 199 | 'standard' => esc_html__('Standard Transaction', 'give'), |
| 200 | ], |
| 201 | 'default' => 'donation', |
| 202 | ], |
| 203 | [ |
| 204 | 'name' => esc_html__('Billing Details', 'give'), |
| 205 | 'desc' => esc_html__( |
| 206 | 'If enabled, required billing address fields are added to PayPal Standard forms. These fields are not required by PayPal to process the transaction, but you may have a need to collect the data. Billing address details are added to both the donation and donor record in GiveWP.', |
| 207 | 'give' |
| 208 | ), |
| 209 | 'id' => 'paypal_standard_billing_details', |
| 210 | 'type' => 'radio_inline', |
| 211 | 'default' => 'disabled', |
| 212 | 'options' => [ |
| 213 | 'enabled' => esc_html__('Enabled', 'give'), |
| 214 | 'disabled' => esc_html__('Disabled', 'give'), |
| 215 | ], |
| 216 | ], |
| 217 | [ |
| 218 | 'id' => 'paypal_invoice_prefix', |
| 219 | 'name' => esc_html__('Invoice ID Prefix', 'give'), |
| 220 | 'desc' => esc_html__( |
| 221 | 'Enter a prefix for your invoice numbers. If you use your PayPal account for multiple fundraising platforms or ecommerce stores, ensure this prefix is unique. PayPal will not allow orders or donations with the same invoice number.', |
| 222 | 'give' |
| 223 | ), |
| 224 | 'type' => 'text', |
| 225 | 'default' => 'GIVE-', |
| 226 | ], |
| 227 | [ |
| 228 | 'name' => esc_html__('PayPal Standard Gateway Settings Docs Link', 'give'), |
| 229 | 'id' => 'paypal_standard_gateway_settings_docs_link', |
| 230 | 'url' => esc_url('http://docs.givewp.com/settings-gateway-paypal-standard'), |
| 231 | 'title' => esc_html__('PayPal Standard Gateway Settings', 'give'), |
| 232 | 'type' => 'give_docs_link', |
| 233 | ], |
| 234 | [ |
| 235 | 'type' => 'sectionend', |
| 236 | 'id' => 'give_title_gateway_settings_2', |
| 237 | ], |
| 238 | ]; |
| 239 | |
| 240 | /** |
| 241 | * filter the settings. |
| 242 | * |
| 243 | * @since 2.9.6 |
| 244 | */ |
| 245 | return apply_filters('give_get_settings_paypal_standard', $setting); |
| 246 | } |
| 247 | |
| 248 | /** |
| 249 | * @since 2.20.0 |
| 250 | * @inerhitDoc |
| 251 | * @throws Exception |
| 252 | */ |
| 253 | public function refundDonation(Donation $donation) |
| 254 | { |
| 255 | throw new Exception('Method has not been implemented yet. Please use the legacy method in the meantime.'); |
| 256 | } |
| 257 | } |
| 258 |