P2P fund transfer refers to the transfer of funds from a card to an account, followed by a transfer to another account with a different holder, within the SDWO. It is used, for example, to add balance to another person's digital wallet using a branded card (either credit or debit).
See below for an example of a P2P SDWO request:
Request
Environment | Method | Endpoint |
|---|---|---|
Sandbox | ||
Production | post |
{
"MerchantOrderId": "2012345678",
"Customer": {
"Name": "Aline de Souza",
"Identity": "12345678900",
"IdentityType": "CPF"
},
"Payment": {
"Type": "CreditCard",
"Amount": 15700,
"Installments": 1,
"SoftDescriptor": "CARTEIRA*NOMELOJA",
"CreditCard": {
"CardNumber": "4532110000001234",
"Holder": "Aline de Souza",
"Brand": "Visa",
"SecurityCode": "333",
"ExpirationDate": "12/2035"
},
"Wallet": {
"PlatformOperator": "ABC",
"ReceiverData": {
"Name": "Alan de Souza",
"Identity": "11122233344",
"CompanyName": "NOME RAZAO SOCIAL"
},
"AdditionalData": {
"Mcc": "6054",
"CashIn": true
}
}
}
}Header parameters
| Parameter | Description | Type | Size | Required |
|---|---|---|---|---|
Content-Type | Media type accepted by the resource. | String | 40 | Yes |
MerchantId | Store identifier at Cielo. | String | 36 | Yes |
MerchantKey | Public key for dual authentication at Cielo. | String | 40 | Yes |
RequestId | Request identifier, used when the store uses different servers for each GET/POST/PUT. | String | 36 | No |
Body parameters
Check the standard credit or debit card request to verify other optional fields. The table below presents the exclusive parameters for P2P SDWO transactions.
Parameter | Description | Type | Size | Required? |
|---|---|---|---|---|
| Order identification. Can be used to cancel or query the transaction in the future. | string | 50 | Yes |
| Buyer's name. | string | 255 | Yes |
| Buyer's CPF or CNPJ number. | text | 14 | Yes, if the holder is a legal entity (CNPJ). |
| Type of buyer's identification document (CPF/CNPJ). | text | 255 | Yes, if the holder is a legal entity (CNPJ). |
| Type of payment method. Default value: CreditCard. | string | Yes | |
| Order amount (sent in cents). | integer | 15 | Yes |
| Number of installments. For installment transactions, the number of installments will always be greater than 1. | integer | 2 | Yes |
| Text that will be printed on the cardholder's bank statement. Special characters are not allowed. Must be filled in the format WalletName*merchantname. | text | 13 | Yes |
| Buyer's card number. | string | 19 | Yes |
| Buyer's name printed on the card. Special characters or accents are not accepted. | string | 25 | Yes |
| Card brand. Possible values: Visa / Master / Amex / Elo / Aura / JCB / Diners / Discover. | string | 10 | Yes |
| Security code printed on the back of the card. | string | 4 | Yes |
| Expiration date printed on the card. Example: MM/YYYY. | string | 7 | Yes |
| Acronym of the wallet registered at Cielo as a digital wallet (check your acronym with your account manager). | string (text) | 3 | Yes |
| Name of the receiving customer or establishment. | text | 70 | Yes |
| CPF or CNPJ number of the receiver. | text | 14 | Yes |
| Corporate name of the receiving establishment. | text | 40 | Yes, if the receiving customer is a legal entity (CNPJ). |
| Digital wallet MCC for P2P fund transfer transactions, according to the card brand. See the MCC Table for SDWO Fund Transfer Arrangement. | string (numeric) | 4 | Yes |
| Send as true. | boolean | Yes |