POST
/
v1
/
payment
curl -X POST https://api-eu.sulpayments.ch/v1/payment \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "order": {
      "external_reference": "PAY-001",
      "payment_type": "credit_card",
      "value": 100.00,
      "description": "Subscription",
      "notification_url": "https://yourapp.com/webhooks/payment"
    },
    "customer": {
      "name": "Jane Doe",
      "email": "jane@example.com",
      "phone": "+5511999999999",
      "document": "12345678909"
    },
    "credit_card": {
      "card_number": "4111111111111111",
      "card_holder": "JANE DOE",
      "card_cvv": "123",
      "card_due_date": "12/2030",
      "card_brand": "visa"
    }
  }'

{
  "payment_id": "9f1a3b2c-...",
  "status": "waiting_payment"
}
The Payment service is the lower-level charge endpoint backing the Seller integration. Most integrators should use POST /v1/order instead.

​
Headers

​
Authorization
string
required
Bearer {token}

​
Body

​
order

​
order.external_reference
string
required
Your unique reference for this payment.
​
order.payment_type
string
required
Currently credit_card.
​
order.value
number
required
Positive amount.
​
order.description
string
required
​
order.notification_url
string
required
Valid HTTPS URL for status callbacks.
​
order.installments
integer

​
customer

​
customer.name
string
required
First and last name.
​
customer.email
string
required
​
customer.phone
string
required
​
customer.document
string
required
Valid CPF.

​
credit_card

​
credit_card.card_number
string
required
​
credit_card.card_holder
string
required
​
credit_card.card_cvv
string
required
​
credit_card.card_due_date
string
required
MM/YYYY
​
credit_card.card_brand
string
required
visa, master, amex, elo, aura, jcb, diners, discover, hipercard, hiper, sorocred

​
credit_card.authentication

3DS authentication payload (optional, used when the card was authenticated on the client).
​
credit_card.authentication.cavv
string
​
credit_card.authentication.xid
string
​
credit_card.authentication.eci
string
​
credit_card.authentication.version
string
​
credit_card.authentication.reference_id
string
​
credit_card.authentication.return_code
string
​
credit_card.authentication.return_message
string
​
credit_card.authentication.callback
string

​
address

​
address.street
string
​
address.number
string
​
address.neighborhood
string
​
address.complement
string
​
address.zip
string
​
address.city
string
​
address.state
string

​
risk

​
risk.ip
string
​
risk.browser
string
​
risk.full_name
string
​
risk.document
string
​
risk.verified_account
boolean
​
risk.fingerprint
string
​
risk.partner_name
string
​
risk.account_creation_date
string

​
Response

​
payment_id
string
UUID identifying the payment.
​
status
string
One of waiting_payment, paid, error, denied, compensated, refunded, refund_error, chargeback, chargeback_claimed.
curl -X POST https://api-eu.sulpayments.ch/v1/payment \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "order": {
      "external_reference": "PAY-001",
      "payment_type": "credit_card",
      "value": 100.00,
      "description": "Subscription",
      "notification_url": "https://yourapp.com/webhooks/payment"
    },
    "customer": {
      "name": "Jane Doe",
      "email": "jane@example.com",
      "phone": "+5511999999999",
      "document": "12345678909"
    },
    "credit_card": {
      "card_number": "4111111111111111",
      "card_holder": "JANE DOE",
      "card_cvv": "123",
      "card_due_date": "12/2030",
      "card_brand": "visa"
    }
  }'

{
  "payment_id": "9f1a3b2c-...",
  "status": "waiting_payment"
}