Send Money to Phone or Account Number

DOCS

Last updated: Sept 23rd, 7:41pm

You can send money to a phone number or, if you have obtained the user account number through another integration, to an account number, as follows:

Send money to phone number

Send money to account number

Mobile payments are supported in the AU, BR, CA, ES, FR, GB, IT, MX, MY, SG, and US regions.

Send money to phone number

After you create a PayPal app to get an access token and evaluate funding options, you can send money to a phone number:


1.	Required	List funding options for phone number.
2.	Required	Create and execute payment to phone number.

List funding options for phone number

To send money to a mobile phone, set the payee type to PHONE when you generate the list of funding options. You must specify the mobile phone number in E.164 format.

This sample request sets the payee type to PHONE:

1curl -v POST https://api-m.sandbox.paypal.com/v2/payments/personal-payments/evaluate-funding-options \
2  -H "Content-Type: application/json" \
3  -H "Authorization: Bearer <Access-Token>" \
4  -d '{
5  "amount": {
6    "currency": "USD",
7    "value": "5"
8  },
9  "fee": {
10    "payer": "PAYER"
11  },
12  "payee": {
13    "id": "+14088363374",
14    "type": "PHONE"
15  },
16  "payment_type": "PERSONAL"
17}'

Create and execute payment to phone number

To create the payment to a phone number, you pass one of the funding option IDs from the list of funding options for a phone number.

This request passes payment details and a funding option ID to create and execute a payment to a phone:

1curl -v POST https://api-m.sandbox.paypal.com/v2/payments/personal-payments \
2  -H "Content-Type: application/json" \
3  -H "Authorization: Bearer <Access-Token>" \
4  -d '{
5  "funding_option_id": "R5hTlsACO7EuP1TbngsRhBUGQElnh5sg0FpoUssk5QMqAPLl2gRLPw6EUjd8XGAytOBBvW",
6  "note_to_payee": "You have got money!"
7}'

If the transaction succeeds, PayPal notifies the payee by email or, for mobile transactions, by text message.

Send money to account number

If you have obtained the account number of a user through another integration, you can send money to an account number.

After you create a PayPal app to get an access token and evaluate funding options, you can send money to an account number:


1.	Required	List funding options for account number.
2.	Required	Create and execute payment to account number.

List funding options for account number

To send money to an account number, set the payee type to ACCOUNT_NUMBER when you generate the list of funding options.

This sample request sets the payee type to ACCOUNT_NUMBER:

1curl -v POST https://api-m.sandbox.paypal.com/v2/payments/personal-payments/evaluate-funding-options \
2  -H "Content-Type: application/json" \
3  -H "Authorization: Bearer <Access-Token>" \
4  -d '{
5  "amount": {
6    "value": "5",
7    "currency": "USD"
8  },
9  "payee": {
10    "id": "AGQWYMXN68LV2",
11    "type": "ACCOUNT_NUMBER"
12  },
13  "fee": {
14    "payer": "PAYER"
15  },
16  "payment_type": "PERSONAL"
17}'

Create and execute payment to account number

To create and execute a payment to an account number, use one of the funding option IDs from the list of funding options for account number.

This request passes payment details and a funding option ID to create and execute a payment to an account number:

1curl -v POST https://api-m.sandbox.paypal.com/v2/payments/personal-payments/payments \
2  -H "Content-Type: application/json" \
3  -H "Authorization: Bearer <Access-Token>" \
4  -d '{
5  "funding_option_id": "R5hTlsACO7EuP1TbngsRhBUGQElnh5sg0FpoUssk5QMqAPLl2gRLPw6EUjd8XGAytOBBvW",
6  "note_to_payee": "You have got money!"
7}'